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, voice, and tools 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_….

Headers

authorization
string | null
X-Vocily-Workspace
string | null
X-Vocily-Org
string | null

Query Parameters

skip
integer
default:0
Required range: x >= 0
limit
integer
default:20
Required range: 1 <= x <= 100

Response

The workspace's agents (minimal shape).

id
string
name
string