v1

latestOpenAPI 3.1.02026-07-17104173304.0 KB
public

Get Agents Paginated

Paginated endpoint for listing agents available to the user.

Returns items for the requested page plus total count. Personas are ordered by display_priority (ASC, nulls last) then by ID (ASC).

NOTE: persona_ids filter is not supported with pagination. Use the non-paginated endpoint if filtering by specific IDs is needed.

get/agents

Query parameters

page_numinteger

Page number (0-indexed).

Page number (0-indexed).

page_sizeinteger

Items per page.

Items per page.

include_deletedboolean

If true, includes deleted personas.

If true, includes deleted personas.

get_editableboolean

If true, only returns editable personas.

If true, only returns editable personas.

include_defaultboolean

If true, includes builtin/default personas.

If true, includes builtin/default personas.

Response

Successful Response

total_itemsinteger required