Skip to main content
GET
Get App Logs

Authorizations

Authorization
string
header
required

Service Account Token authentication. To authenticate API requests:

  1. Create a Service Account Token:

    • Go to the Cerebrium Dashboard and open the API Keys page
    • Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
    • Copy the token generated for the desired service account
  2. Use the Token: Include the service account token in the Authorization header of API requests: Authorization: Bearer <your-service-account-token>

  3. Best Practices:

    • Create separate service accounts for different environments (dev, staging, prod)
    • Store tokens securely as secrets in consuming applications or workflows
    • Set appropriate expiry dates and rotate tokens regularly
    • Never commit tokens to source control

For CI/CD integration examples, see the CI/CD documentation.

Path Parameters

project_id
string
required
app_id
string
required

Query Parameters

beforeDate
string

Retrieve logs before a specific date, in RFC3339 format.

afterDate
string

Retrieve logs after a specific date, in RFC3339 format.

container
string

Retrieve logs for a specific container.

runId
string

Retrieve logs for a specific run.

Only return log lines containing this search term.

stream
string

Filter by output stream. Valid values: stdout, stderr.

direction
string

Set to forward to page forward in time. Defaults to backward.

nextToken
string

Pagination token from a previous response.

pageSize
integer

Number of log lines to return per page. Maximum: 1000. Default: 200.

Response

A page of log lines for the app.

hasMore
boolean

Whether more log lines are available.

logs
array

Log entries. Each item has appId, containerId, containerName, lineNumber (integer), logLine, logId, projectId, stream, timestamp, and runId fields.

nextPageToken
string

Token to pass as nextToken to retrieve the next page. Omitted when there are no more results.