Agents

List agents

Retrieve a paginated list of agents available to the authenticated user.

Overview

Returns agents accessible through direct, team, or org-level permissions. Search is performed across agent name, description, and tags. Sorting and pagination are applied by the AI backend and the resulting envelope is forwarded unchanged by the Node gateway.

Gateway contract

The Node route supports only these query params: page, limit, search, sort_by, and sort_order.

The Python backend also understands isDeleted, but this gateway route does not forward it, so it is not part of the public API contract here.

get/agents

Query parameters

pageinteger

1-based page number.

limitinteger

Maximum number of agents to return in the current page.

searchstring

Case-insensitive search across agent name, description, and tags. Leading/trailing whitespace is trimmed; blank-after-trim values are rejected.

sort_bystring

Backend sort field. Leading/trailing whitespace is trimmed. Common value is updatedAtTimestamp.

sort_order'asc' | 'desc'

Sort direction.

Response

Paginated list of accessible agents.

successboolean required

Example response

{
  "success": true,
  "agents": [
    {
      "_id": "agentInstances/e6f848ca-e2ab-4594-9925-e1136629f474",
      "_key": "e6f848ca-e2ab-4594-9925-e1136629f474",
      "_rev": "_lkNlcOm---",
      "user_role": "OWNER",
      "access_type": "INDIVIDUAL"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "limit": 20,
    "totalItems": 2,
    "totalPages": 1
  }
}

Changes

Changed in 4 of the 15 revisions of this API.25

Aug 13, 202657e2b0860dd41See the full diff
- ○
  added the optional property agents/items/usesOrgDefault to the response with the 200 status
  response-optional-property-added
Aug 12, 202611f5086fcbb81See the full diff
- ○
  added the required property agents/items/mcpServers to the response with the 200 status
  response-required-property-added
Aug 12, 20265798f431973a21See the full diff
- ●
  added the new confluencedatacenter enum value to the agents/items/toolsets/items/name/allOf[AgentCreateToolsetName]/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new jiradatacenter enum value to the agents/items/toolsets/items/name/allOf[AgentCreateToolsetName]/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the optional property agents/items/defaultReasoningEffort to the response with the 200 status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 29, 2026911a57b55d182See the full diff
- ○
  added the required property agents/items/knowledge to the response with the 200 status
  response-required-property-added
- ○
  added the required property agents/items/toolsets to the response with the 200 status
  response-required-property-added

Full history