Sign in
agents

List Agents

List the agents the organization may run, or the full catalog.

The single authoritative source of agent availability for clients (extension, Console, integrations). By default the returned list already reflects every per-org gate — labs access, style-agent mode, per-agent on/off, and the no-LLM flag — so clients must not re-derive availability; the no_llm flag is returned alongside so they can render the Style-Agent-only state directly. Pass include_unavailable=true for the full catalog (per-org gates skipped), e.g. an internal tool resolving an agent id regardless of org config.

get/agents

Query parameters

pageinteger

Page number (1-based)

page_sizeinteger

Items per page (max 100)

categorystring nullable

Filter agents by category name (case-insensitive substring match)

include_unavailableboolean

Return the full agent catalog instead of only the agents this organization may run. When false (default) the list is filtered by labs access, style-agent mode, per-agent on/off, and the no-LLM flag; when true those per-org gates are skipped.

Headers

Authorizationstring required

Bearer authentication

Response

Successful Response

totalinteger required

Total number of agents matching filters

pageinteger required

Current page number (1-based)

page_sizeinteger required

Number of items per page

total_pagesinteger required

Total number of pages

no_llmboolean required

When true, the organization has disabled all LLM-powered agents; only the deterministic Style Agent is available and, unless include_unavailable is set, agents contains it alone (Style-Agent-only).

Changes