LIliveavatar
Voice Agents

List Voice Agents

Changed on

List voice agents.

scope selects which agents are returned:

  • private (default) — only the agents your space owns.
  • public — preset agents owned by no space. Read-only: they cannot be updated or deleted (PATCH/DELETE return 404).

Items omit agent_configuration — retrieve a single agent to see its full configuration.

get/v1/voice_agents

Request

  • Base URL
    https://api.liveavatar.com
  • URL
    https://api.liveavatar.com/v1/voice_agents
  • Auth
    API key in header X-API-KEY

Query parameters

scope'private' | 'public'

Which agents GET /v1/voice_agents returns.

A distinct dimension from agent_type (how the conversation runs): scope is about ownership. private is the default so existing callers keep seeing exactly the set they own today.

Named scope rather than voice_agent_type (voices' voice_type precedent) because agent_type is already taken on this resource.

  • private — only the caller's space owns.
  • public — presets owned by no space (space_id IS NULL); read-only to everyone.

Response

Successful Response

codeinteger
messagestring

Changes