---
title: "List all agents"
method: GET
path: "/agents"
---

# List all agents

`GET /agents`

## Query parameters

- `includeActiveDeployment` boolean
- `region` string

## Response `200`

List of agents retrieved successfully

- object
  - `services` ServiceListItem[]
    - `id` string — Unique identifier for the agent
    - `name` string — Name of the agent
    - `region` string — The region where the agent is deployed
    - `desiredDeploymentId` string — ID of the deployment that was requested. Use this to track which deployment should be running.
    - `activeDeploymentId` string — **Deprecated**: Use `desiredDeploymentId` instead. ID of the requested deployment.
    - `reconciledDeploymentId` string — ID of the deployment that the operator has actually reconciled. Compare with `desiredDeploymentId` to determine if a deployment update has been processed.
    - `organizationId` string — Organization ID this agent belongs to
    - `createdAt` string, date-time — Creation timestamp of the agent
    - `updatedAt` string, date-time — Last update timestamp
    - `deletedAt` string, date-time, nullable — Deletion timestamp, if the agent has been deleted
    - `deployment` object — Details of the active deployment (only included when includeActiveDeployment=true)
      - `id` string — Deployment ID
      - `serviceId` string — Service ID
      - `manifest` object — Kubernetes manifest for the deployment
      - `createdAt` string, date-time — Creation timestamp of the deployment
      - `updatedAt` string, date-time — Last update timestamp of the deployment

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/pipecat/apis/pipecat-cloud.md) · [All operations](https://skmtc.dev/pipecat/apis/pipecat-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipecat/pipecat-cloud/revisions/acd0f7dfe734/schema)