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

# List Agents

> List agents in your workspace with their review and compliance status.

Returns agents in your workspace, most recently created first, with cursor pagination. Each agent includes its review status and compliance rule results. Archived agents and agent templates are not included. Agents hidden by **Hide private resources in Governance** are not included.

## Base URL

```
https://api.langdock.com/governance/v1/agents
```

> [!WARNING]
>
> **Dedicated deployments**
>
> Replace `api.langdock.com` with `<your-deployment-url>/api/public` in all requests.

## Prerequisites

* **API key** with the `GOVERNANCE_API` scope
* **Enable Governance** is on

See the [Governance API Overview](https://docs.langdock.com/en/developer/governance-api/governance-overview.md) for the agent fields, polling, and errors.

## Parameters

| Parameter | Type | Description |
| - | - | - |
| `limit` | integer | Agents per page. Minimum 1, maximum 100, default 50 |
| `cursor` | UUID | `nextCursor` from the previous page |
| `updatedSince` | datetime | Only agents whose `updatedAt` is at or after this time. Use an ISO 8601 timestamp with a timezone offset, such as `2026-10-01T00:00:00Z` |
| `complianceStatus` | string | Comma-separated `not_checked`, `not_high_risk`, `potentially`, or `high_risk`. Repeated query parameters work too. Omit it to return every status |

`updatedSince` follows the agent's `updatedAt`, not the time a compliance rule finished. For how to poll flagged agents, see [Polling](https://docs.langdock.com/en/developer/governance-api/governance-overview.md#polling).

```bash theme={null}
curl "https://api.langdock.com/governance/v1/agents?complianceStatus=high_risk,potentially&updatedSince=2026-10-01T00:00:00Z&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

The response has `agents` and `nextCursor`. The compliance status filter runs before paging, so `nextCursor` continues through that filtered list. Pass `nextCursor` as `cursor` and keep the same filters. When `nextCursor` is null, that was the last page.

```bash theme={null}
curl "https://api.langdock.com/governance/v1/agents?complianceStatus=high_risk,potentially&limit=50&cursor=2f1c7b9e-5d7a-4f2a-9d2e-5b2c0e8f1a3b" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Rate Limits

This endpoint allows **500 requests per minute** for each workspace and API key. No token limit applies. Above that limit you get `429 Too Many Requests`.

> [!NOTE]
>
> Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](https://docs.langdock.com/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.