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

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_sizeinteger

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

folder_idstring nullable

Filter by folder ID

include_root_onlyboolean

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.

Response

Successful Response

Example response

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

Changes

Changed in 7 of the 165 revisions of this API.57

Sep 3, 2026c82c9e00155e1See the full diff
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
Aug 17, 202660277099c3041See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Jul 23, 2026195ddd3884ff2See the full diff
- ○
  added the new enum value lastRunAt to the query request parameter sort_by
  request-parameter-enum-value-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
May 9, 2026f3fe325e083c2See the full diff
- ○
  added the new optional query request parameter is_hidden
  new-optional-request-parameter
- ○
  added the optional property // to the response with the status
  response-optional-property-added
May 9, 2026e90a755fa9e12See the full diff
- ●
  deleted the query request parameter is_hidden
  request-parameter-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 7, 2026937cd0cdc5792See the full diff
- ○
  added the new optional query request parameter is_hidden
  new-optional-request-parameter
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Apr 30, 20268c84efcb3afb2See the full diff
- ●
  deleted the query request parameter is_hidden
  request-parameter-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
This revision also has 96 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history