Skip to main content
POST
/
api
/
optimus
/
meeting-link
Generate Meeting Link
curl --request POST \
  --url https://api.example.com/api/optimus/meeting-link

​
Request

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

​
Parameters

FieldTypeRequiredDescription
assistantIdstringYesAgent to use for the video call
contactNamestringNoContact name (injected as variable)
phoneNumberstringNoContact phone number (for lookup)
workspaceIdstringNoWorkspace ID

​
Response

{
  "call_id": "call_abc123",
  "room_url": "https://app.orova.ai/meeting/call_abc123?token=..."
}

​
Notes

  • The room_url is a single-use link. After the contact opens it, the token is consumed.
  • The contact opens the link in their browser — no login or app required.
  • Contact data is automatically injected as variables into the agent’s system prompt.
  • A credit check is performed before generating the link. Returns 402 if insufficient credits.