---
title: "List Deployments"
method: GET
path: "/agents/{agent_id}/deployments"
tags: ["Agents"]
---

# List Deployments

`GET /agents/{agent_id}/deployments`

List of all deployments associated with an agent.

## Path parameters

- `agent_id` string, required

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- Deployment[]
  - `id` string, required — The unique identifier for the deployment.
  - `agent_id` string, required — The ID of the agent associated with this deployment.
  - `version_id` string, required — The ID of the agent version associated with this deployment.
  - `status` string, required — The current status of the deployment. It can be `queued`, `inactive`, `deploy_error`, `skipped`, `build_error`, `building`, `built`, `deploying`, or `deployed`.
  - `is_pinned` boolean, required — 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_live` boolean, required — 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_id` string, nullable — The ID of the environment variable collection associated with this deployment.
  - `source_code_file_id` string, nullable — The ID of the source code file associated with this deployment.
  - `git_commit_hash` string, nullable — The commit hash of the Git repository for this deployment.
  - `created_at` string, date-time, required — The UTC timestamp when the deployment was created.
  - `updated_at` string, date-time, required — The UTC timestamp when the deployment was last updated.
  - `build_completed_at` string, date-time, nullable — The UTC timestamp when the build was completed.
  - `build_error` string, nullable — Any error that occurred during the build process.
  - `build_logs` string, nullable — Logs generated during the build process of the deployment.
  - `build_started_at` string, date-time, nullable — The UTC timestamp when the build process started.
  - `deployment_started_at` string, date-time, nullable — The UTC timestamp when the deployment process started.
  - `deployment_completed_at` string, date-time, nullable — The UTC timestamp when the deployment process was completed.
  - `deployment_error` string, nullable — Any error that occurred during the deployment process.
  - `region` string — The region where the deployment is running.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/versions/8910812440d3/schema)