v1

latestOpenAPI 3.0.02026-07-26492143.5 KB

Agents

List agents

List agents the caller has access to. Filter by team, search by name, or narrow to agents that use a specific tool or trigger.

get/agents

Query parameters

team_idstring

Scope the listing to a single team. When omitted, returns agents owned by the authenticated user.

searchstring

Case-insensitive substring match against the agent name.

creatorstring

Filter to agents created by this user ID.

has_triggersboolean

When true, only returns agents that have at least one active trigger configured.

toolstring

Filter to agents that use the specified MCP server as a tool.

flowstring

Filter to agents that use the specified saved flow as a tool.

Response

Agents matching the provided filters.

next_cursorstring

Reserved for future cursor-based pagination. Currently always null.

Example response

{
  "agents": [
    {
      "id": "abc123DEFghiJKL",
      "name": "Sales research agent",
      "description": "Researches accounts and drafts outreach",
      "team_id": "team_4f8c92ab",
      "is_active": true,
      "model_name": "anthropic/claude-sonnet-4",
      "system_prompt": "You are a B2B sales research assistant.",
      "folder_id": "folder_91ab",
      "created_at": "2026-05-15T14:32:00Z",
      "active_trigger_count": 2
    }
  ]
}