Skip to navigation
AgentsManagement

Agents · List the workspace’s agents

View as Markdown

Lists agents this workspace owns. Start here — it is the only operation that yields the IDs and slugs every other agent operation needs.

Simplified-maintained agents (Riley and friends) are excluded by default; pass origin explicitly to see them. Sub-agents are always excluded.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional

1-based page number.

page_sizeintegerOptional
Results per page. Defaults to 30.
searchstringOptional
Substring match over title, slug and description.
statusenumOptional
Allowed values:
modelstringOptional
originenumOptional

Passing this at all opts out of the default "workspace's own" filter, so origin=simplified reveals Simplified-maintained agents.

Allowed values:

Response

Paginated results of agents.

Errors

401
Unauthorized Error