---
title: "List Agent Configurations"
method: GET
path: "/v1/agents/list"
tags: ["Agents", "Agent Management", "Agent Configuration"]
---

# List Agent Configurations

`GET /v1/agents/list`

## Request

- Base URL: `https://api.swarms.world`
- URL: `https://api.swarms.world/v1/agents/list`
- Auth: none declared. Required headers: `x-api-key`

Retrieve all unique agent configurations that the user has created or used, without task-specific details. Enables reuse of agent configurations across different tasks.

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- AgentsListOutput
  - `success` boolean: Indicates whether the agent list was retrieved successfully.
  - `count` integer, required: Total number of unique agent configurations.
  - `agents` unknown[], required: List of agent configuration objects.
    - unknown
  - `timestamp` string, required: ISO timestamp when the list was generated.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `500c79520e41`: 6 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
  - added the optional property `success` to the response with the `200` status
  - added the required property `agents` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/changes/v1/agents/list/get.md)

---

[API](https://skmtc.dev/the-swarm-corporation/apis/swarms-api.md) - [All operations](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-swarm-corporation/apis/swarms-api/revisions/fca99f497199?raw)