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

# List Agent Configurations

`GET /v1/agents/list`

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

---

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