List agents

Return Managed Deep Agents owned by the authenticated user. System-created default agents are excluded.

GET /agents

List agents

cURL

curl --request GET \
  --url https://api.smith.langchain.com/v1/deepagents/agents \
  --header 'X-Api-Key: <api-key>'

200

Example

{ "items": [ { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "name": "<string>", "description": "<string>", "owner_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "created_at": "2023-11-07T05:31:56Z", "updated_at": "2023-11-07T05:31:56Z", "permissions": { "identity": "personal", "visibility": "tenant", "tenant_access_level": "read", "shared_users": { "read": [ "<string>" ], "run": [ "<string>" ], "update": [ "<string>" ] } }, "runtime": { "model": { "model_id": "anthropic:claude-sonnet-4-6" } }, "extras": {} } ], "next_cursor": "<string>" }

Authorizations

X-Api-Key · string · header · default: LANGSMITH_API_KEY · required

Query Parameters

page_size · integer · default: 20

Items per page. Defaults to 20. Maximum is 100.

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from a previous response.

name · string

Substring filter on agent name.

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 order.

Available options: asc, desc

Response

200

application/json

Agents returned.

items · object[]

Show child attributes

next_cursor · string | null

Cursor for the next page, or null when there are no more pages.