Skip to main content
List agents visible to the caller. Admins see every agent; other principals see only rows scoped to their principal_id.

Endpoint

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <key>. Optional if AGENT_CLOUD_API_KEY is unset.

Query parameters

integer
Max agents to return (default 20, clamped to 1–100).

Response

string
Always list.
array
Array of agent objects (same shape as Get Agent).
boolean
Currently always false.