Skip to main content
List agents
Returns a minimal shape - just id and name, enough to find the agent_id you pass to Place a call. An agent’s prompt and voice are managed in the dashboard and aren’t part of the API contract.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Query Parameters

cursor
string | null

Opaque cursor from a previous response's next_cursor; omit for the first page

limit
integer
default:20

Maximum records to return in one page.

Required range: 1 <= x <= 100

Response

The workspace's agents. A summary — configuration lives behind get-by-id, so listing stays cheap.

data
PublicAgentSummary · object[]
required

The rows on this page.

has_more
boolean
required

Whether another page exists. false on the last.

next_cursor
string | null

Pass back as ?cursor= for the next page; null on the last one. Opaque — do not parse or construct one. A cursor from a differently sorted list is refused with invalid_cursor rather than silently returning page 1.