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

# List agents

`GET /agents`

## Request

- Base URL: `https://api.modjo.ai/v2`
- URL: `https://api.modjo.ai/v2/agents`
- Auth: HTTP bearer

Returns a paginated list of agents, ordered by name. Includes the agents provided by Modjo and the ones created in your workspace.

## Query parameters

- `page` integer: Page number (1-based)
- `size` integer: Number of items per page
- `search` string: Filter agents whose name contains this text (case-insensitive)
- `creator_origin` 'modjo' | 'user': Filter by origin: `modjo` for agents provided by Modjo, `user` for agents created in your workspace

## Response `200`

Paginated list of agents

- AgentListResponse
  - `data` Agent[], required
    - `uuid` string, uuid, required: Agent UUID
    - `name` string, required: Agent name
    - `emoji` string, required: Agent emoji
    - `description` string, required: Short description of what the agent does
    - `instructions` string, required: Instructions the AI follows when the agent is used
    - `creatorOrigin` 'modjo' | 'user', required: Origin of the agent: `modjo` for agents provided by Modjo, which are read-only, `user` for agents created in your workspace
    - `enabledTools` string[], required: Tools the agent can use
    - `createdById` number, nullable, required: ID of the user who created the agent
    - `createdOn` string, nullable, required: Creation timestamp in ISO 8601 format
    - `modifiedOn` string, nullable, required: Last modification timestamp in ISO 8601 format
  - `pagination` object, required
    - `page` number, required: Current page number
    - `size` number, required: Items per page
    - `total` number, required: Total number of items

## Other responses

- `401`: Authentication failed. The API key is missing or invalid.
- `429`: Rate limit exceeded. Retry after the X-RateLimit-Reset interval.

## Changes

- **2026-10-14** `5aa3b3f47a13`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/modjo/apis/modjo-public-api/changes/agents/get.md)

---

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