Voice

Generate a call script for one contact

SPENDS CREDITS. A persona-driven script, retrieving from the agent's knowledge and its memory of the contact. Nothing is called or sent.

post/voice/call-scripts/generate

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/call-scripts/generate
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

agent_idstring required

The agent whose persona and knowledge shape the script.

contact_idstring required

The contact the call is for; drives memory retrieval.

contextstring required

What the call is about.

prospect_infostring nullable

What you know about the prospect.

company_contextstring nullable

What you know about the prospect's company.

call_objectivestring nullable

What the call should achieve.

call_typestring

professional, casual, cold_call, follow_up, demo or closing.

previous_interactionsstring nullable

Summary of earlier conversations.

provider'openai' | 'anthropic' | 'openrouter'

LLM provider.

modelstring

openai: gpt-4o or gpt-4o-mini. anthropic: claude-sonnet-4-6, claude-haiku-4-5-20251001 or claude-opus-4-6. Voice rejects any other pairing with a 422.

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

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