List Runs
Retrieve a list of runs for a specific app.
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.
Query Parameters
Filter runs by status.
Retrieve a specific run by its ID.
Filter runs by the container that executed them.
Set to true to only return asynchronous runs.
Set to true to only return websocket runs.
Only return runs queued for at least this many milliseconds.
Only return runs queued for at most this many milliseconds.
Only return runs that waited at least this many milliseconds for a container.
Only return runs with a response time of at least this many milliseconds.
Only return runs with a response time of at most this many milliseconds.
Only return runs created after this timestamp, in RFC3339 format.
Only return runs created before this timestamp, in RFC3339 format.
Filter runs by region.
Pagination token from a previous response.
Include runs from ephemeral apps. Set to true to include them.
Response
A page of runs matching the filters.
Whether the query stopped early before scanning all matching runs.
Runs ordered by creation time. Each item includes id, modelId, projectId, status, statusCode (integer), async (boolean), websocket (boolean), createdAt, updatedAt, completedAt, containerId, containerStartedAt, functionName, method, region, timing fields in milliseconds (queueTimeMs, runtimeMs, responseTimeMs, activatorQueueTimeMs, containerQueueTimeMs, totalQueueTimeMs, executionTimeMs, totalResponseTimeMs), and for ephemeral runs the run configuration (ephemeral, command, hardware, cpu, memory, gpuCount, createdByUserId).
Pagination token to pass as nextToken to retrieve the next page. Empty when there are no more results.