Create a new agent

curl -X POST https://api.ortavox.ai/v1/agents \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "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"
  }
}'

{
  "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

errorany

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error