The agents the caller could start a session with now
Every agent POST /v1/sessions would accept a start on for this caller at this request, oldest first, at most 200: the agent is active with an active_release_id, the caller may use it (open to the workspace; or a private agent whose teams the caller is in, or that the caller administers or manages, or a workspace owner or admin), the release's runtime profile is still in the catalog and unchanged, and every credential the release names is bound. Where the workspace limits agents to those inside them (axis A is not use), only agents the caller is inside are listed. A key bound to an agent lists that agent alone when it could start there, and a service key bound to none lists the agents open to the workspace. A private agent the caller may not use is not in the list, and nothing in the answer tells that it exists. An agent whose active release needs a credential that the caller's caller limits (GET /v1/agents/{id}/caller-limits: the workspace's rule, or that of a team the caller is in) deny in credentials_deny is not listed either, since every start would be refused; a limit on repositories never removes an agent, for a session without a repository still starts. Needs sessions:write. active_release_id is what to send as agent_release_id.
Scope: sessions:write (API key or cookie session).
AuthorizationBearer <token>For servers and scripts: an API key sent as an HTTP bearer token, Bearer <key>. It holds exactly the scopes it was issued with; a key issued before scopes existed holds none. It never needs the CSRF header, and it cannot manage agents, members, teams or API keys. Issue one in the web console under Settings → API keys; each operation names the scope it needs.
Scope: sessions:write
The agents a start would accept, oldest first.
application/json- response
items*array<>items <= 200curl -X GET 'https://example.com/v1/usable-agents'{ "items": [ { "id": "8d2c4f1a-6b3e-4a9d-b7c5-2e1f0a9b8c7d", "slug": "finance", "name": "Finance analyst", "description": "Reads the quarterly reports and flags outliers.", "managing_team_name": "Finance", "active_release_id": "rel_example" } ]}