> Revox API docs for developers and AI agents. Index: https://www.getrevox.com/docs/api/llms.txt · Everything in one file: https://www.getrevox.com/docs/api/llms-full.txt · OpenAPI 3.1: https://www.getrevox.com/openapi.json · MCP server: https://www.getrevox.com/api/mcp-servers/generic/mcp
> Base URL https://www.getrevox.com/api · Auth: `Authorization: Bearer $REVOX_API_KEY`

# Get a link to listen to a live call and jump in

`POST https://www.getrevox.com/api/call/{id}/live-link`

Returns a short-lived web page URL for one call that is ringing or on the line. Whoever opens it hears the call live, follows the transcript, and can take over from the AI with one click to talk to the person on the line, or hang up. No Revox account is needed: the URL is the credential, scoped to this call only.

Typical use: a "Listen" button on a CRM record calls this endpoint when clicked, then opens the returned `url` in a new tab. Request a fresh link on every click rather than storing one. Send `{}` as the body for the default lifetime.

Returns 409 when the call is not live (still queued, between attempts, or ended) and 404 when the call does not exist in your organization.

## Request

```bash
curl -X POST "https://www.getrevox.com/api/call/8d2f6b1a-4c9e-4f37-b215-6a0e9c3d7f12/live-link" \
  -H "Authorization: Bearer $REVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "expires_in_seconds": 98 }'
```

## Path parameters

- `id` (string, required): The ID of the call. It must be live: ringing or on the line.

## Body

JSON.

- `expires_in_seconds` (integer, optional): How long the link can be opened, in seconds, from 30 to 3600. Default 300 (5 minutes). Keep it short: anyone holding the link can listen to the call and talk to the person on the line. Expiry only stops new openings: a page already connected to the call stays connected until the call ends.

## Response 200

```json
{
  "url": "https://example.com",
  "expires_at": "2026-11-05T09:00:00Z"
}
```

- `url` (string (uri)): Web page to open in a browser to listen to the live call and, with one click, take over from the AI and talk to the person on the line (microphone required). No Revox account needed: the URL is the credential, so open it directly and do not store or forward it.
- `expires_at` (string (date-time)): When the link stops opening (ISO 8601, UTC). Request a new link for the call after that.

## Errors

- `404` Not found in your organization: `{"error":"Not found"}`
- `409` Conflicts with the resource's current state: `{"error":"Conflicts with the resource's current state"}`
- Every status is explained under Errors in https://www.getrevox.com/docs/api.md#errors.