MOmodjo
Agents

List agents

Changed on

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

get/agents

Request

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

Query parameters

pageinteger

Page number (1-based)

Example:1
sizeinteger

Number of items per page

Example:25
searchstring

Filter agents whose name contains this text (case-insensitive)

Example:discovery
creator_origin'modjo' | 'user'

Filter by origin: modjo for agents provided by Modjo, user for agents created in your workspace

Example:user

Response

Paginated list of agents

Example response

{
  "data": [
    {
      "uuid": "3f2b8c1e-7d4a-4e5b-9c6f-1a2b3c4d5e6f",
      "name": "Discovery coach",
      "emoji": "🧭",
      "description": "Reviews discovery calls against the MEDDIC framework.",
      "instructions": "For each call, list the MEDDIC criteria that were covered and the ones that are still missing.",
      "creatorOrigin": "user",
      "enabledTools": [
        "websearch"
      ],
      "createdById": 42,
      "createdOn": "2024-06-15T14:30:00.000Z",
      "modifiedOn": "2024-06-15T15:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 25,
    "total": 100
  }
}

Changes