List Apps
Retrieve a list of apps for a specific project.
Authorizations
Service Account Token authentication. To authenticate API requests:
-
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
-
Use the Token: Include the service account token in the Authorization header of API requests:
Authorization: Bearer <your-service-account-token> -
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
Query Parameters
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 and usage metrics for the current month, including CPU, GPU, and memory cost and usage figures.
Timestamp when the app was created.
Whether the app is an ephemeral app created by a one-off run. Omitted when false.
Compute type the app runs on.
Cloud provider the app is deployed on.
Unique identifier of the app.
Name of the app.
ID of the project the app belongs to.
Region the app is deployed in.
Request counts for the current month, including successful, errored, and total requests.
Current status of the app.
Timestamp when the app was last updated.