Create a new agent

import requests
url = "https://api.ortavox.ai/v1/agents"
payload = {
    "name": "Support Agent",
    "transcriber": {
        "provider": "deepgram",
        "model": "nova-3",
        "language": "en"
    },
    "model": {
        "provider": "openai",
        "model": "gpt-4o-mini",
        "system_prompt": "You are a helpful AI assistant",
        "temperature": 0.8,
        "max_tokens": 3500
    },
    "voice": {
        "provider": "elevenlabs",
        "voice_id": "dqzVFKHwZvR9YMQoFM67",
        "model": "eleven_turbo_v2_5"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "id": "string",
    "name": "string",
    "organizationId": "string",
    "configuration": {
      "model": {},
      "voice": {},
      "transcriber": {},
      "start_message": "string",
      "start_message_mode": "string",
      "max_call_duration": 1.1
    },
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z"
  },
  "meta": {
    "timestamp": "string"
  }
}

Create a new AI agent with specified configuration. Requires authentication via Clerk JWT or API key.

Authentication

AuthorizationBearer

Clerk JWT token or OrtaVox API key (sk_live_… or pk_live_…)

x-api-keystring

OrtaVox API key (alternative to Bearer token)

Request

This endpoint expects an object.

namestringRequired

Agent name

transcriberobjectRequired

modelobjectRequired

voiceobjectRequired

max_call_durationdoubleOptionalDefaults to 600

Response

Agent created successfully

dataobject or null

errorany or null

metaobject or null

Authentication

Request

Response

Errors