Get Build
Retrieve details for a specific build.
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.
Response
Full configuration and status details of the requested build.
Time taken to build, in milliseconds, as a string value.
Version of the client used at deployment time.
Whether checkpointing is enabled for the build.
Version of the client that created the build.
Compute tier of the build, interruptible or protected. Omitted when not set.
Container runtime version. Omitted when not set.
Cooldown period in seconds before an idle replica scales down.
Number of CPU cores allocated.
Timestamp when the build was created.
Email address of the user who created the build.
IP address the build was created from.
Maximum run duration in seconds, if set.
Maximum time in seconds to wait for the deployment to initialize.
Whether authentication is disabled on the app endpoint.
Base Docker image used for the build.
Path to the Dockerfile used, if any.
Command used to start a custom runtime app, as a list of strings.
Interval in seconds between autoscaling evaluations.
Configuration after the update, for update builds. Omitted when not set.
Number of GPUs allocated.
Compute type the build targets.
Fallback compute types, in priority order. Omitted when not set.
Cloud provider the build targets.
Whether private registry credentials were provided.
HTTP endpoint used to check that the app is healthy.
Unique identifier of the build.
Size of the built image in bytes.
Error message from deployment initialization, if any. Omitted when not set.
Time taken to initialize the deployment, in milliseconds, as a string value.
Load balancing algorithm used by the app.
Maximum number of replicas.
Memory allocation in GB.
Minimum number of replicas.
ID of the app the build belongs to.
Name of the app.
Configuration before the update, for update builds. Omitted when not set.
Port the app listens on.
ID of the project the build belongs to.
Python version used for the build.
HTTP endpoint used to check that the app is ready to receive traffic.
Region the build targets.
Maximum concurrent requests per replica.
Grace period in seconds for in-flight requests when a replica stops.
Name of the revision created by this build.
Duration in seconds over which the new version is rolled out.
App runtime, cortex or custom.
Version of the app runtime.
Number of extra replicas kept available beyond current demand.
Metric used for autoscaling.
Target value for the scaling metric.
Current status of the build.
Type of the build.
Configuration changes requested, for update builds. Omitted when not set.
Timestamp when the build was last updated.
Whether uv is used for Python package installation. Omitted when not set.
Size of the uploaded source archive in bytes.