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

# List Agents

`GET /api/v1/agents`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/agents`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

Returns Agents visible to the caller. Each item is the same Agent shape as GET /api/v1/agents/{agent_id}, including the environments the caller may read. The list never embeds runtime bindings. An unknown query parameter, including limit, returns 400; use page_size to set the page size.

## Query parameters

- `page_size` integer
- `cursor` string
- `sort_by` 'last_run_start_time' | 'name' | 'created_at'
- `sort_order` 'asc' | 'desc'
- `id` string[]
- `name` string
- `source_type` 'LSD' | 'MDA' | 'EXTERNAL' | 'FLEET'

## Response `200`

OK

- AgentplatformAgentListResponse
  - `items` AgentplatformAgent[], required
    - `agent_type` 'CUSTOM' | 'CODING', required
    - `avatar_url` string, nullable: AvatarURL is a short-lived URL for the agent avatar, when present.
    - `created_at` string, date-time, required
    - `environments` AgentplatformAgentEnvironment[], required
      - `agent_id` string, required
      - `environment` 'LOCAL' | 'DEVELOPMENT' | 'STAGING' | 'PRODUCTION', required
      - `id` string, uuid, required
      - `runtime_bindings` AgentplatformAgentRuntimeBinding[]
        - `agent_environment_id` string, uuid, required
        - `id` string, uuid, required
        - `source_id` string, required
      - `tracer_session_id` string, uuid, required
      - `tracer_session_name` string, required
    - `id` string, required
    - `name` string, required
    - `owner` string: Owner is the owner's full name, falling back to email when available.
    - `owner_id` string, uuid, nullable
    - `source_type` 'LSD' | 'MDA' | 'EXTERNAL' | 'FLEET', required
    - `tag_key_id` string, uuid, nullable
    - `tag_value_id` string, uuid, nullable
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Bad Request

## Changes

- **2026-10-27** `d1aa6d438ff0`: 1 info
  - added the optional property `items/items/avatar_url` to the response with the `200` status
- **2026-10-22** `e45f16e950dc`: 2 info
  - added the optional property `items/items/owner` to the response with the `200` status
  - added the optional property `items/items/owner_id` to the response with the `200` status
- **2026-10-21** `016683c2a6e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/agents/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)