AgentsDeployments

Get Deployment

Get a deployment by its ID.

Path parameters

deployment_idstringRequired
The ID of the deployment.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Cartesia-Version"2025-04-16"Required

Response

This endpoint returns an object.
idstring
The unique identifier for the deployment.
agent_idstring
The ID of the agent associated with this deployment.
statusstring

The current status of the deployment. It can be queued, inactive, deploy_error, skipped, build_error, building, or deployed.

is_pinnedboolean

Marks that this deployment is the active deployment for its associated agent_id. Only one deployment per agent can be pinned at a time. Deployments can be pinned even if they are not live or failed.

is_liveboolean

True if this deployment is the live production deployment for its associated agent_id. Only one deployment per agent can be live at a time.

env_var_collection_idstring
The ID of the environment variable collection associated with this deployment.
source_code_file_idstring
The ID of the source code file associated with this deployment.
git_commit_hashstring
The commit hash of the Git repository for this deployment.
created_atdatetime
The UTC timestamp when the deployment was created.
updated_atdatetime
The UTC timestamp when the deployment was last updated.
build_completed_atdatetime
The UTC timestamp when the build was completed.
build_logsstring
Logs generated during the build process of the deployment.
build_started_atdatetime
The UTC timestamp when the build process started.
deployment_started_atdatetime
The UTC timestamp when the deployment process started.
deployment_completed_atdatetime
The UTC timestamp when the deployment process was completed.
build_errorstring or null
Any error that occurred during the build process.
deployment_errorstring or null
Any error that occurred during the deployment process.