Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "access_level": "WRITE",
      "backend": {
        "sandbox_config": {
          "delete_after_stop_seconds": 1200,
          "idle_ttl_seconds": 600,
          "policy_ids": [
            "<string>"
          ],
          "sandbox_id": "<string>",
          "scope": "thread",
          "snapshot_id": "550e8400-e29b-41d4-a716-446655440000"
        },
        "type": "sandbox"
      },
      "created_at": "2026-01-15T09:30:00Z",
      "description": "Researches topics and drafts summaries.",
      "display": {
        "icon": "Rocket02",
        "icon_color": "blue"
      },
      "extras": {},
      "id": "11111111-1111-1111-1111-111111111111",
      "is_owner": true,
      "model": {
        "id": "anthropic:claude-sonnet-4-6"
      },
      "name": "Research Assistant",
      "options": {
        "skip_memory_write_protection": true,
        "slack_oauth_provider_id": "<string>",
        "tools_url": "<string>",
        "trace_inputs_outputs": true,
        "triggers_paused": true,
        "user_timezone": "America/New_York"
      },
      "owner": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Ada Lovelace"
      },
      "owner_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
      "permissions": {
        "shared_users": {
          "read": [
            "<string>"
          ],
          "run": [
            "<string>"
          ],
          "update": [
            "<string>"
          ]
        }
      },
      "updated_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

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

fleet

agents

Error

A valid request URL is required to generate request examples

{
  "items": [
    {
      "access_level": "WRITE",
      "backend": {
        "sandbox_config": {
          "delete_after_stop_seconds": 1200,
          "idle_ttl_seconds": 600,
          "policy_ids": [
            "<string>"
          ],
          "sandbox_id": "<string>",
          "scope": "thread",
          "snapshot_id": "550e8400-e29b-41d4-a716-446655440000"
        },
        "type": "sandbox"
      },
      "created_at": "2026-01-15T09:30:00Z",
      "description": "Researches topics and drafts summaries.",
      "display": {
        "icon": "Rocket02",
        "icon_color": "blue"
      },
      "extras": {},
      "id": "11111111-1111-1111-1111-111111111111",
      "is_owner": true,
      "model": {
        "id": "anthropic:claude-sonnet-4-6"
      },
      "name": "Research Assistant",
      "options": {
        "skip_memory_write_protection": true,
        "slack_oauth_provider_id": "<string>",
        "tools_url": "<string>",
        "trace_inputs_outputs": true,
        "triggers_paused": true,
        "user_timezone": "America/New_York"
      },
      "owner": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "Ada Lovelace"
      },
      "owner_id": "7f8e9d0c-1b2a-3948-5766-8594a3b2c1d0",
      "permissions": {
        "shared_users": {
          "read": [
            "<string>"
          ],
          "run": [
            "<string>"
          ],
          "update": [
            "<string>"
          ]
        }
      },
      "updated_at": "2026-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "status": 123,
  "type": "<string>"
}

Authorizations

X-Api-Key

string

header

required

LangSmith API key (lsv2_...).

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

include

enum<string>

Comma-separated relations to hydrate. owner resolves each item's owner_id into an owner object. Omitted by default to avoid overfetching. files is not available on the list endpoint.

Available options:

owner

Response

items

object[]

Show child attributes

next_cursor

string

Headless Fleet API reference

Create an agent