Skip to main content
GET
Get Active Revision

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

Response

Details of the app's currently active revision. An empty object is returned when the app has no active deployment.

latestCreatedRevisionName
string

Name of the most recently created revision.

latestReadyRevisionName
string

Name of the most recent revision that is ready to serve traffic.

maxReplicaCount
string

Maximum number of replicas, as a string value.

minReplicaCount
string

Minimum number of replicas, as a string value.

replicaConcurrency
string

Maximum concurrent requests per replica, as a string value.

scaleBuffer
string

Number of extra replicas kept available beyond current demand, as a string value.

scalingMetric
string

Metric used for autoscaling.

scalingTarget
string

Target value for the scaling metric, as a string value.

scalingTargetUtilization
string

Target utilization percentage for scaling, as a string value.

traffic
array

Traffic split across revisions. Each item includes the revision name and the percentage of traffic it receives.