Skip to main content
POST
/
api
/
agents
Create Agent
curl --request POST \
  --url https://api.example.com/api/agents

​
Request

curl -X POST https://app.orova.ai/api/agents \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent",
    "llm_provider": "openai",
    "llm_model": "gpt-4o-mini",
    "tts_provider": "elevenlabs",
    "tts_voice_id": "VOICE_ID",
    "stt_provider": "deepgram",
    "system_prompt": "You are a helpful support agent...",
    "first_message": "Hi! How can I help you today?",
    "recording_enabled": true,
    "workspaceId": "WORKSPACE_ID"
  }'

​
Parameters

FieldTypeRequiredDescription
namestringYesAgent display name
llm_providerstringYesopenai, claude, azure
llm_modelstringYesModel name
tts_providerstringYeselevenlabs, cartesia, azure
tts_voice_idstringNoVoice ID from TTS provider
stt_providerstringYesdeepgram, azure, elevenlabs, openai
system_promptstringNoAgent instructions
first_messagestringNoGreeting message
recording_enabledbooleanNoEnable call recording
ambience_enabledbooleanNoEnable background ambience
workspaceIdstringYesWorkspace ID

​
Response

{
  "_id": "agent_id",
  "name": "Support Agent",
  "llm_provider": "openai",
  "llm_model": "gpt-4o-mini",
  "tts_provider": "elevenlabs",
  "stt_provider": "deepgram",
  "system_prompt": "You are a helpful support agent...",
  "first_message": "Hi! How can I help you today?",
  "recording_enabled": true,
  "workspaceId": "WORKSPACE_ID",
  "createdAt": "2025-01-01T00:00:00.000Z"
}