---
title: "List Agents"
method: GET
path: "/agents"
tags: ["/agents"]
---

# List Agents

`GET /agents`

Retrieve a list of all `Agents`.

## Query parameters

- `limit` integer — Maximum number of agents to return
- `cursor` string — Cursor from the previous call to list agents, used to retrieve the next set of results

## Response `200`

Successful Response

- ListAgentsResponse
  - `total_count` integer, required — Total number of available agents
  - `next_cursor` string — Next cursor to continue pagination. Omitted if there are no more agents to retrieve.
  - `agents` AgentEntry[] — List of active agents
    - `id` string, uuid, required — ID of the agent
    - `name` string, required — Name of the agent
    - `description` string, required — Description of the agent

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/contextualai/apis/endpoints.md) · [All operations](https://skmtc.net/contextualai/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/contextualai/endpoints/versions/ca7f807eec8b/schema)