---
title: "List agents"
method: GET
path: "/governance/v1/agents"
tags: ["Governance"]
---

# List agents

`GET /governance/v1/agents`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/governance/v1/agents`
- Auth: HTTP bearer

Returns agents in the workspace, most recently created first, with cursor pagination.
Each agent includes review status and compliance rule results.
Archived agents, agent templates, and agents hidden by Hide private resources in Governance are omitted.
Requires a workspace API key with the `GOVERNANCE_API` scope and Governance turned on.
Does not return instructions, conversations, documents, or action results.

## Query parameters

- `limit` integer
- `cursor` string, uuid
- `updatedSince` string, date-time
- `complianceStatus` string

## Response `200`

A page of agents

- GovernanceAgentListResponse (unresolved $ref)

## Other responses

- `400`: Invalid query parameters
- `401`: Missing or invalid API key
- `403`: Key lacks GOVERNANCE_API, or Governance is not enabled
- `429`: Rate limit exceeded (500 requests per minute per workspace and API key)
- `500`: Internal server error

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/governance/v1/agents/get.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)