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

POST/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

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 }'

const res = await fetch("https://www.getrevox.com/api/call/8d2f6b1a-4c9e-4f37-b215-6a0e9c3d7f12/live-link", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    expires_in_seconds: 98,
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.post(
    "https://www.getrevox.com/api/call/8d2f6b1a-4c9e-4f37-b215-6a0e9c3d7f12/live-link",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    json={
        "expires_in_seconds": 98,
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

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

{ "error": "Not found" }

{ "error": "Conflicts with the resource's current state" }

Path parameters

idstringrequired
The ID of the call. It must be live: ringing or on the line.

Request body

application/json

expires_in_secondsinteger
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.
30 to 3600

Response

200

urlstring (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_atstring (date-time)
When the link stops opening (ISO 8601, UTC). Request a new link for the call after that.

Errors

404Not found in your organization{ "message"?: string, "error"?: string, "bodyErrors"?: {…} }
409Conflicts with the resource's current state{ "message"?: string, "error"?: string, "bodyErrors"?: {…} }

Error bodies carry an error (or message) string; a 400 adds bodyErrors.issues. See Errors.