Skip to main content
GET
List Audit 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

Query Parameters

from
string

Start of the window, RFC3339. Clamped to the plan's retention window.

to
string

End of the window, RFC3339. Defaults to now.

action
string

Return only this action, e.g. secrets.read.

actor
string

Return only actions taken by this actor id.

outcome
string

Return only success or failure.

limit
integer

Page size, 1-200. Defaults to 50.

nextToken
string

Page token from a previous response.

Response

A page of the project's audit log.

hasMore
boolean

Whether more rows remain.

logs
array

The audited actions, newest first.

nextPageToken
string

Token for the next page, absent at the end of the timeline.

retentionDays
integer

How far back the project's plan allows reading.