---
title: "List agents"
method: GET
path: "/v1/fleet/agents"
tags: ["agents"]
---

# List agents

`GET /v1/fleet/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.

## Query parameters

- `page_size` integer
- `cursor` string
- `name` string
- `audience` 'user' | 'tenant'
- `sort_by` 'created_at' | 'updated_at' | 'name'
- `sort_order` 'asc' | 'desc'

## Response `200`

OK

- AgentsListAgentsResponse
  - `items` AgentsAgentSummary[]
    - `access_level` 'READ' | 'RUN' | 'WRITE'
    - `backend` AgentsAgentBackend
      - `sandbox` AgentsSandboxConfig
        - `delete_after_stop_seconds` integer — Time after a sandbox is stopped before it is deleted, in seconds.
        - `idle_ttl_seconds` integer — Idle timeout after which an unused sandbox is paused, in seconds.
        - `policy_ids` string[] — Sandbox policies governing tool execution.
        - `snapshot_id` string — Snapshot used when creating new sandbox-backed computers.
      - `type` 'default' | 'thread_scoped_sandbox' | 'agent_scoped_sandbox' — Execution backend type. Use a scoped sandbox backend for sandbox-backed agents.
    - `created_at` string, date-time
    - `description` string
    - `extras` object
    - `id` string, uuid
    - `is_owner` boolean
    - `name` string
    - `owner_id` string, uuid
    - `permissions` AgentsAgentPermissions
      - `identity` 'personal' | 'shared'
      - `shared_users` AgentsSharedUsers
        - `read` string[] — User IDs allowed to read the agent.
        - `run` string[] — User IDs allowed to run the agent.
        - `update` string[] — User IDs allowed to update the agent.
      - `tenant_access_level` 'read' | 'run' | 'write'
      - `visibility` 'tenant' | 'user'
    - `runtime` AgentsAgentRuntime
      - `model` AgentsAgentModelConfig
        - `model_id` string — Model ID used to run the agent.
    - `updated_at` string, date-time
  - `next_cursor` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `502` — Bad Gateway
- `503` — Service Unavailable

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)