---
title: "Lists agents shared with this API key"
method: GET
path: "/agent/v1/list"
tags: ["Agent Build"]
---

# Lists agents shared with this API key

`GET /agent/v1/list`

## Request

- Base URL: `https://api.langdock.com`
- URL: `https://api.langdock.com/agent/v1/list`
- Auth: HTTP bearer

Returns only agents shared with this API key for invocation in the same workspace. Does not return every agent in the workspace. Deleted and archived agents are omitted. Projects are not included. Disabled agents are included with disabled set to true, but chat completions reject them with 403 ASSISTANT_DISABLED until they are re-enabled. A well-formed cursor that matches no agent returns an empty agents array.

## Query parameters

- `limit` integer
- `cursor` string, uuid

## Response `200`

Agents shared with this API key

- object
  - `agents` object[], required
    - `id` string, uuid, required
    - `name` string, nullable
    - `description` string, nullable
    - `emojiIcon` string, nullable
    - `model` string, nullable: Deployment name, or auto when the agent uses Auto mode.
    - `inputType` 'PROMPT' | 'STRUCTURED' | 'INTEGRATION' | 'SCHEDULED' | 'WEBHOOK', required
    - `owner` object, nullable
      - `id` string, uuid, required
      - `name` string, nullable
      - `email` string, required
    - `disabled` boolean, required
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `nextCursor` string, uuid: Present only when another page exists.

## Other responses

- `400`: limit is outside 1 to 250 or not an integer, or cursor is not a UUID
- `401`: Missing or invalid API key
- `403`: API key lacks the Read Agents scope or the legacy Agent API (full access) scope

## Changes

- **2026-11-03** `c62bf90b4013`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langdock/apis/langdock-api/changes/agent/v1/list/get.md)

---

[API](https://skmtc.dev/langdock/apis/langdock-api.md) - [All operations](https://skmtc.dev/langdock/apis/langdock-api/llms.txt) - [OpenAPI document](https://skmtc.dev/langdock/apis/langdock-api/revisions/c62bf90b4013?raw)