v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01302395850.8 KB
v2
library
private

List Library Agents

Get all agents in the user's library (both created and saved).

get/api/library/agents

Query parameters

search_termstring nullable

Search term to filter agents

Search term to filter agents

sort_by'createdAt' | 'updatedAt' | 'lastRunAt'

Possible sort options for sorting library agents.

Criteria to sort results by

pageinteger

Page number to retrieve (must be >= 1)

Page number to retrieve (must be >= 1)

page_sizeinteger

Number of agents per page (must be >= 1)

Number of agents per page (must be >= 1)

folder_idstring nullable

Filter by folder ID

Filter by folder ID

include_root_onlyboolean

Only return agents without a folder (root-level agents)

Only return agents without a folder (root-level agents)

is_hiddenboolean nullable

Filter by hidden status. True = only hidden, False = only non-hidden, omit = all agents.

Filter by hidden status. True = only hidden, False = only non-hidden, omit = all agents.

Response

Successful Response

Example response

{
  "pagination": {
    "total_items": 42,
    "total_pages": 2,
    "current_page": 1,
    "page_size": 25
  }
}