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

# List agents

`GET /agents`

## Request

- Base URL: `https://api.mosaic.so`
- URL: `https://api.mosaic.so/agents`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List agents in the API key's organization with optional workspace and case-insensitive name filtering.

## Query parameters

- `limit` integer
- `cursor` string, date-time
- `workspace_id` string, uuid
- `name` string

## Response `200`

Agents retrieved successfully

- AgentListResponse
  - `agents` AgentSummary[], required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, date-time, nullable, required: Pagination cursor for the next page, or null after the final page.

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Access denied

---

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