List agents

Returns the agents the authenticated user has access to. The default audience=user view returns the agents the caller owns plus any agents that have been directly shared with the caller via permissions.shared_users. The alternate audience=tenant view returns only the workspace-shared agents (those whose permissions.visibility is tenant). System-created defaults are always excluded.

Each item carries two caller-relative fields that describe the authenticated user’s relationship to that agent:

• is_owner — true if the caller is the agent’s owner.
• access_level — one of READ, RUN, or WRITE. Owners get WRITE. Direct shares get the level matching the shared_users list they appear in. Tenant-shared rows get the agent’s tenant_access_level. The maximum applicable level always wins.

Results are cursor-paginated. Pass the cursor value from the previous response to fetch the next page; next_cursor is omitted when no further pages exist.

GET /v1/fleet/agents

Error

A valid request URL is required to generate request examples

200

{
  "items": [
    {
      "backend": {
        "sandbox": {
          "delete_after_stop_seconds": 1200,
          "idle_ttl_seconds": 600,
          "policy_ids": [
            "<string>"
          ]
        },
        "type": "sandbox"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "extras": {},
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "is_owner": true,
      "name": "<string>",
      "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "permissions": {
        "shared_users": {
          "read": [
            "<string>"
          ],
          "run": [
            "<string>"
          ],
          "update": [
            "<string>"
          ]
        }
      },
      "runtime": {
        "model": {
          "model_id": "claude-sonnet-4-6"
        }
      },
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Query Parameters

page_size · integer

Items per page (1-100). Default 20.

cursor · string

Opaque pagination cursor returned by the previous list call.

name · string

Case-insensitive substring filter on the agent name.

audience · enum<string> · default: user

Scope of agents to return. user (default) returns owned + directly-shared. tenant returns workspace-shared only.

Available options: user, tenant

sort_by · enum<string> · default: updated_at

Field to sort by.

Available options: created_at, updated_at, name

sort_order · enum<string> · default: desc

Sort direction.

Available options: asc, desc

Response

200

application/json

OK

items · object[]

Show child attributes

next_cursor · string