Voice Agents

Create Agent From Prompt

Create Agent From Prompt

Requires the OWNER or ADMIN role. Prompt-first creation: creates a new agent server-side with placeholder config, then runs the same generation flow as Generate Agent Config against it. Response always includes the new agentId, plus either an agent key (generation succeeded) or needsFollowUp: true (prompt needs more detail) -- see Generate Agent Config for both shapes.

post/voice/agents/generation

Request

  • Base URL: https://api.speakai.co/v1
  • URL: https://api.speakai.co/v1/voice/agents/generation
  • Auth: API key in header x-speakai-key and API key in header x-access-token

Request body

promptstring required

Required. Describe the agent you want in a sentence or two.

namestring
manualInstructionsstring

Skips the thin-prompt follow-up question and generates immediately, folding this in as additional context.

Response

Created

status'success'

Changes

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