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

# List agents

`GET /v1/agents`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/agents`
- Auth: HTTP bearer

Returns all agents owned by this workspace, newest first. Use `limit` and `offset` for pagination. With an ephemeral end-user token (agents:read scope), returns trimmed public cards only (agent_id, name, language, voice_id, public_metadata) — hidden agents excluded, ordered by public_metadata.order.

## Query parameters

- `limit` integer: Page size.
- `offset` integer: Pagination offset.

## Response `200`

Agents in this workspace, newest first (trimmed public cards for ephemeral tokens).

- unknown

## Other responses

- `422`: Validation Error

---

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