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

# List agents

> List all agents accessible to the current API key

Returns every agent the current Developer API key can access.

<ResponseField name="data" type="Agent[]" required>
  Page of agents.
</ResponseField>

<ResponseField name="data[].id" type="integer" required>
  Agent ID.
</ResponseField>

<ResponseField name="data[].name" type="string" required>
  Display name.
</ResponseField>

<ResponseField name="data[].description" type="string">
  Short description.
</ResponseField>

<ResponseField name="data[].status" type="string">
  `active` or `inactive`.
</ResponseField>

<ResponseField name="data[].avatar_url" type="string">
  Avatar image URL.
</ResponseField>

<ResponseField name="data[].capabilities" type="object">
  Feature flags for the agent.
</ResponseField>

<ResponseField name="data[].capabilities.persistent_conversations" type="boolean">
  Supports persistent conversations.
</ResponseField>

<ResponseField name="data[].capabilities.streaming" type="boolean">
  Supports streaming responses.
</ResponseField>

<ResponseField name="data[].capabilities.tool_activity" type="boolean">
  Can execute tools.
</ResponseField>

<ResponseField name="data[].created_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="data[].updated_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://chatatp-agent-builder-backend.onrender.com/v1/agents/ \
    -H "Authorization: Bearer $CHATATP_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": 7,
        "name": "Support Agent",
        "description": "Answers support questions",
        "status": "active",
        "avatar_url": "https://cdn.example.com/agent.png",
        "capabilities": {
          "persistent_conversations": true,
          "streaming": true,
          "tool_activity": true
        },
        "created_at": "2026-01-12T10:00:00Z",
        "updated_at": "2026-06-01T14:22:00Z"
      }
    ]
  }
  ```
</ResponseExample>

## SDK

<CodeGroup>
  ```typescript TypeScript theme={null}
  const page = await client.agents.list();
  for await (const agent of page) {
    console.log(agent.id, agent.name);
  }
  ```

  ```python Python theme={null}
  page = await client.agents.list()
  for agent in page:
      print(agent.id, agent.name)
  ```
</CodeGroup>