Skip to main content
GET
List Builds

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

limit
integer

Maximum number of builds to return.

offset
string

Only return builds created before this timestamp. Use the createdAt of the last build in the previous page to paginate.

Response

A page of builds for the app.

items
array

Builds ordered by creation time. Each item includes id, modelId, projectId, name, status, type, createdAt, updatedAt, buildTimeMs, initTimeMs, cliVersion, cerebriumVersion, cpu (number), memory (number), gpuCount (integer), hardware, region, dockerBaseImageUrl, pythonVersion, revisionName, runtimeVersion, imageSizeBytes (integer), and zipSizeBytes (integer) fields.

nextToken
string

Timestamp to pass as offset to retrieve the next page. Empty when there are no more results.