List agents
GET
https://server.heyrik.com/api/v1/agentsHeaders
AuthorizationstringRequiredUse Bearer $HEYRIK_API_KEY with an account-scoped API key. Keep the key on your server.
GET/agents
curl https://server.heyrik.com/api/v1/agents \
-H "Authorization: Bearer $HEYRIK_API_KEY"Response example
{
"data": [
{
"id": "agc_9f2a1c30",
"name": "Support Agent",
"language": "en-IN",
"greeting": "Hi, thanks for calling Acme — how can I help?",
"system_prompt": "You are a friendly support agent…",
"voice_settings": { "voice_id": "vx_9f2a1c30", "speed": 1.0 },
"config": { "mode": "prompt", "languages": ["en-IN", "hi-IN"] },
"owner_id": "usr_2c30d0ac",
"created_at": "2026-07-20T09:14:02.881Z"
}
]
}Illustrative examples · No live request is sent