Skip to main content
POST
Create voice agent
The Update Voice Agent API uses the same request/response shape as Create Voice Agent, but you must include agent_id to identify which agent to update. Only agent_id is required — include any other fields you want to change.

API Endpoint

POST /api/v1/global/create-agent Content-Type: application/json Authentication: Required (Token header: token)

Request Body

Required Fields

Optional Fields

All other fields follow the same definitions as the Create Voice Agent API — include only the fields you want to update.

Response

Success Response

Status Code: 200 OK

Error Responses

400 Bad Request

401 Unauthorized

404 Not Found

422 Unprocessable Entity

Example Requests

Notes

  • Only include fields you want to update; omitted fields will remain unchanged.
  • The agent must exist and belong to your workspace.
  • For available options for voice.provider, speech_to_text.provider, speech_to_text.language, llm models, and tts_model, refer to the Create Voice Agent API documentation.
  • The agent_id can be provided either in the request body or as a query parameter.

Headers

token
string
required

API token for authentication

Body

application/json
agent_id
integer
agent_name
string
description
string
prompt
string
timezone
string
greeting
string
session_data_webhook
string
voice
object
speech_to_text
object
llm
object
configurations
object

Response

201

Created