> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mosaic.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List Agents

> List all agents available to the API key organization.

Returns all agents scoped to your API key's organization.

## Request

```bash theme={null}
curl -X GET "https://api.mosaic.so/agents?limit=25" \
  -H "Authorization: Bearer mk_your_api_key"
```

## Query Parameters

| Field    | Type   | Required | Description                           |
| -------- | ------ | -------- | ------------------------------------- |
| `limit`  | number | No       | Page size (`1-100`, default `25`).    |
| `cursor` | string | No       | Pagination cursor from `next_cursor`. |

## Response

```json theme={null}
{
  "agents": [
    {
      "id": "123e4567-e89b-12d3-a456-789012345678",
      "name": "My Agent",
      "description": "Weekly YouTube clip automation",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-02T08:00:00Z"
    }
  ],
  "next_cursor": null
}
```