---
title: "List agents in the API key workspace"
method: GET
path: "/agents"
tags: ["Agents"]
---

# List agents in the API key workspace

`GET /agents`

## Request

- Base URL: `https://app.communicate.so/api/v1`
- URL: `https://app.communicate.so/api/v1/agents`
- Auth: one of:
  - OAuth 2 (client credentials, token URL `https://app.communicate.so/api/v1/oauth/token`, scopes: `agents:read`)
  - HTTP bearer

Returns the agents visible to the authenticated workspace API key. This route is non-streaming and shares the public API group rate limit of 600 requests per minute per key.

## Response `200`

Workspace agents

- AgentSummary[]
  - `id` string, required
  - `name` string, required
  - `status` 'active' | 'inactive' | 'draft', required

## Other responses

- `401`: Missing or invalid API key
- `403`: Credential does not grant `agents:read`
- `429`: API key rate limit exceeded
- `500`: Unexpected server failure

---

[API](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2.md) · [All operations](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/communicate/apis/communicate-public-rest-api-2/revisions/db6be3d36733?raw)