> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Deployments"
description: "List and inspect deployments, and read their logs, workers, components, and runs."
last_verified: 2026-07-27
---


**Endpoints**: `GET /api/v1/deployments`, `GET /api/v1/deployments/:id`, `GET /api/v1/deployments/:id/logs`, `GET /api/v1/deployments/:id/workers`, `GET /api/v1/deployments/:id/components`, `GET /api/v1/deployments/:id/runs`
**Auth**: `X-API-KEY` or `Authorization: Bearer <token>` (required)
**Error envelope**: 4xx/5xx return `{"error": string, "message": string, "code": int, "hint"?: string}`


A **deployment** is a workflow running in the AGNT5 cloud — one version of a project's code, running in one [environment](/docs/api-reference/environments.md). Deploying from the CLI or Studio creates a new deployment; this page covers reading deployment state.

## Next steps

* [Workers](/docs/api-reference/workers.md): inspect a worker's health and capacity directly
* [Runs & Traces](/docs/api-reference/runs-and-traces.md): drill into a single run's steps and timing
* [CLI deploy](/cli/deploy.md): create a new deployment with **`agnt5 deploy`**