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

# List all Agents

`GET /v1/agents/list-agents`

List all agents the authenticated user has access to, including personal agents, agents shared via teams, and agents created by the user. Supports pagination via offset and limit query parameters.

## Query parameters

- `offset` integer — Number of items to skip.
- `limit` integer — Maximum number of items to return.

## Response `200`

Successful Response

- AgentListResponse
  - `request_metadata` ResponseMeta
    - `request_id` string, nullable — Unique request identifier for tracing and support.
  - `agents` AgentDetailResponse[] — List of agents the user has access to.
    - `agent_id` string, required — Unique identifier of the agent.
    - `name` string, required — Name of the agent.
    - `description` string, required — Description of the agent.
    - `is_creator` boolean, required — Whether the requesting user is the creator of this agent.
    - `hosted_to` string, required — Deployment target: 'AgentStore' or 'Organization'.
    - `uploaded_by` UploadedByInfo, required — Information about the user who uploaded / created the agent.
      - `user_id` string, nullable — ID of the user who created the agent.
      - `user_email` string, nullable — Email of the user who created the agent.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/svahnar/apis/svahnar-apis.md) · [All operations](https://skmtc.net/svahnar/apis/svahnar-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/svahnar/svahnar-apis/revisions/02cca47c900a/schema)