List agents
Lists agents visible to the caller. private agents are visible only to
their creator/service principal; unlisted agents are omitted (fetch by
ID instead); public agents are listed tenant-wide.
The visibility, lifecycle, label, and q filter parameters are accepted but not yet honored by the server; the response is unfiltered.
Authorizations
OAuth 2.0 / OIDC bearer token.
The tenant the request operates within.
Query Parameters
Maximum number of items per page.
1 <= x <= 200Opaque cursor from a prior response's nextPageToken. Omit on the first request.
Filter by one or more visibility levels.
private— creator / service principal only.unlisted— usable by ID, hidden from list results.public— listed tenant-wide.
private, unlisted, public Filter by lifecycle.
ephemeral— short-lived; expired automatically.persistent— retained until explicitly deleted.
ephemeral, persistent Filter by label equality, repeated key=value pairs (AND-combined).
^[^=]+=[^=]*$Free-text search over name and description.
256"coder"
Response
A page of agents.
A page of agents.