Get raw logs for a run

GET /runs/{run_id}/logs

Logs are stored at SAMPLE_REPOSITORY/LogFiles/{id}.txt and served via GCS signed URL. Returns 404 — not a broken download link — when the file is absent from both local and GCS storage. Uses cursor-based pagination; do not mix cursor and offset.

Path parameters

run_id integer Required

Numeric run ID

Minimum value is 1.

Query parameters

limit integer

Maximum number of results to return (1–100)

Minimum value is 1, maximum value is 100. Default value is 50.
cursor string

Opaque cursor token for cursor-based pagination. Do not mix with offset. Obtain next_cursor from the previous response's pagination object.

Maximum length is 255.
level string

Values are debug, info, warning, error, or critical.
source string

Values are orchestrator, worker, build, test_runner, or web.
contains string

Maximum length is 100.

Responses

200 application/json

Cursor-paginated run log lines
Hide response attributes Show response attributes object
- data array Required
- pagination object Required
  
  Hide pagination attributes Show pagination attributes object
  
  limit integer Required
  
  Minimum value is 1.
  
  next_cursor string | null Required
  
  Opaque cursor for the next page. Null when there are no more results.
  
  Maximum length is 255.
401 application/json

Missing, expired, or invalid bearer token
Hide response attributes Show response attributes object
- code string Required
  
  Machine-readable error code (snake_case)
  
  Maximum length is 100.
- message string Required
  
  Human-readable error summary
  
  Maximum length is 500.
- details object Required
  
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.
  
  Additional properties are allowed.
403 application/json

Token is valid but lacks the required scope or role
Hide response attributes Show response attributes object
- code string Required
  
  Machine-readable error code (snake_case)
  
  Maximum length is 100.
- message string Required
  
  Human-readable error summary
  
  Maximum length is 500.
- details object Required
  
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.
  
  Additional properties are allowed.
404 application/json

Log file not found in local or GCS storage
Hide response attributes Show response attributes object
- code string Required
  
  Machine-readable error code (snake_case)
  
  Maximum length is 100.
- message string Required
  
  Human-readable error summary
  
  Maximum length is 500.
- details object Required
  
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.
  
  Additional properties are allowed.
429 application/json

Too many requests. Retry after the indicated number of seconds.
Hide headers attributes Show headers attributes
- Retry-After integer
  
  Seconds to wait before retrying
- X-RateLimit-Limit
  
  Maximum requests allowed in the current window
- X-RateLimit-Remaining
  
  Requests remaining in the current window
- X-RateLimit-Reset
  
  Unix timestamp when the rate limit window resets
Hide response attributes Show response attributes object
- code string Required
  
  Machine-readable error code (snake_case)
  
  Maximum length is 100.
- message string Required
  
  Human-readable error summary
  
  Maximum length is 500.
- details object Required
  
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.
  
  Additional properties are allowed.
default application/json

Unexpected server error
Hide response attributes Show response attributes object
- code string Required
  
  Machine-readable error code (snake_case)
  
  Maximum length is 100.
- message string Required
  
  Human-readable error summary
  
  Maximum length is 500.
- details object Required
  
  Structured context for the error. Always an object, never null. Empty object {} when no additional detail is available.
  
  Additional properties are allowed.

GET /runs/{run_id}/logs

curl \
 --request GET 'https://sampleplatform.ccextractor.org/api/v1/runs/{run_id}/logs' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [],
  "pagination": {
    "limit": 42,
    "next_cursor": "string"
  }
}

Response examples (401)

{
  "code": "unauthorized",
  "message": "Bearer token is missing, expired, or invalid.",
  "details": {}
}

Response examples (403)

{
  "code": "forbidden",
  "message": "Token does not have the required scope for this operation.",
  "details": {
    "required_scope": "runs:write",
    "token_scopes": [
      "runs:read",
      "results:read"
    ]
  }
}

Response examples (404)

{
  "code": "log_not_found",
  "message": "Log file for run 9309 does not exist in any storage backend.",
  "details": {
    "run_id": 9309,
    "checked": [
      "local",
      "gcs"
    ]
  }
}

Response examples (429)

{
  "code": "rate_limited",
  "message": "Rate limit exceeded. Retry after 30 seconds.",
  "details": {
    "retry_after": 30,
    "limit": 120,
    "window": "60s"
  }
}

Response examples (default)

{
  "code": "not_found",
  "message": "Run 9317 not found.",
  "details": {}
}