Voice

Create a voice agent or twin

Create a new voice agent or twin bound to the caller's org.

Org is pinned server-side from the API key. The agent's creator is set server-side too, never from the request body: an agent is credited to the person who created the API key. A twin, or an agent created with a key that records no creator, is credited to the key itself.

post/voice/agents

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/agents
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

agent_idstring nullable

Agent UUID. Auto-generated if omitted.

agent_status'active' | 'inactive' | 'archived'

Initial status.

rolestring required

Agent role (e.g. "SDR", "AE", "Receptionist", "CSM").

entity_type'agent' | 'twin'

"agent" or "twin".

use_company_knowledgeboolean

Also draw on the org-wide knowledge base.

is_templateboolean

Save this as a reusable template rather than a live agent.

template_idstring nullable

Template this agent was cloned from, if any.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.