Skip to main content
POST
/
api
/
optimus
/
phone-call
Make Phone Call
curl --request POST \
  --url https://api.example.com/api/optimus/phone-call

​
Request

curl -X POST https://app.orova.ai/api/optimus/call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assistantId": "AGENT_ID",
    "phoneNumber": "+1234567890",
    "phoneNumberId": "PHONE_NUMBER_ID",
    "contactName": "John Doe",
    "workspaceId": "WORKSPACE_ID"
  }'

​
Parameters

FieldTypeRequiredDescription
assistantIdstringYesAgent to use for the call
phoneNumberstringYesDestination phone number (E.164)
phoneNumberIdstringYesOrova phone number to call from
contactNamestringNoContact name for history and variable injection
workspaceIdstringYesWorkspace ID

​
Response

{
  "call_id": "call_abc123",
  "status": "initiated"
}

​
Notes

  • A credit check is performed before the call. Returns 402 if insufficient credits.
  • If contactName is provided, Orova looks up the contact and injects their data as variables.
  • The call is initiated via Twilio. The agent speaks the first message when the recipient answers.