Skip to main content
GET
List Apps

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

includeEphemeral
boolean

Include ephemeral apps created by one-off runs. Set to true to include them.

Response

A list of apps in the project with current-month usage metrics.

cost_metrics
object

Cost and usage metrics for the current month, including CPU, GPU, and memory cost and usage figures.

createdAt
string

Timestamp when the app was created.

ephemeral
boolean

Whether the app is an ephemeral app created by a one-off run. Omitted when false.

hardware
string

Compute type the app runs on.

hardwareProvider
string

Cloud provider the app is deployed on.

id
string

Unique identifier of the app.

name
string

Name of the app.

projectId
string

ID of the project the app belongs to.

region
string

Region the app is deployed in.

request_metrics
object

Request counts for the current month, including successful, errored, and total requests.

status
string

Current status of the app.

updatedAt
string

Timestamp when the app was last updated.