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

# List agents

> Retrieve all agents for your tenant

Returns a paginated list of the agents belonging to your tenant.

### Query parameters

<ParamField query="page" type="integer" default="1">
  1-based page number
</ParamField>

<ParamField query="pageSize" type="integer" default="20">
  Items per page, maximum 100
</ParamField>

<ParamField query="search" type="string">
  Case-insensitive match on agent name or description
</ParamField>

<ParamField query="persona" type="string">
  Filter by persona ID
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.agentic-os.com/api/v1/agents \
    -H "Authorization: Bearer $AGENTIC_OS_API_KEY"
  ```

  ```python Python theme={null}
  requests.get(
      "https://api.agentic-os.com/api/v1/agents",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "agents": [
    { "id": "550e8400-...", "name": "Support Agent" }
  ]
}
```