> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orova.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Meeting Link

> Generate a one-time video meeting link for a contact

## Request

```bash theme={null}
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

| Field         | Type   | Required | Description                         |
| ------------- | ------ | -------- | ----------------------------------- |
| `assistantId` | string | Yes      | Agent to use for the video call     |
| `contactName` | string | No       | Contact name (injected as variable) |
| `phoneNumber` | string | No       | Contact phone number (for lookup)   |
| `workspaceId` | string | No       | Workspace ID                        |

## Response

```json theme={null}
{
  "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.