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.
Query parameters
1-based page number.
Maximum number of agents to return in the current page.
Case-insensitive search across agent name, description, and tags. Leading/trailing whitespace is trimmed; blank-after-trim values are rejected.
Backend sort field. Leading/trailing whitespace is trimmed. Common value is updatedAtTimestamp.
Sort direction.
Response
Paginated list of accessible agents.
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
}
}