Skip to main content
GET
List Recent Containers

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

Response

Containers active in the project within the last 30 minutes.

appId
string

ID of the app the container belongs to.

buildId
string

ID of the build the container was created from.

containerId
string

Unique identifier of the container.

containerIp
string

IP address of the container.

containerRunningTimeMs
integer

Total running time of the container in milliseconds.

containerStartTimestamp
string

Timestamp when the container started.

containerState
string

Current state of the container.

containerTerminationTimestamp
string

Timestamp when the container terminated, if it has.

hardwareProvider
string

Cloud provider the container is running on.

hostIp
string

IP address of the host running the container.

podCreationTimestamp
string

Timestamp when the pod was created.

podName
string

Name of the pod running the container.

projectId
string

ID of the project the container belongs to.

region
string

Region the container is running in.

timestamp
string

Timestamp of the most recent status report for the container.