Turn the public demo page on or off

POST/assistants/{id}/demo-page

The demo page lets anyone with its link call the assistant and see the calls it placed, with their transcripts and recordings. Off by default. enabled: true turns it on with a new link; calling it again regenerates the link and the previous one stops working at once. enabled: false turns it off.

Request

curl -X POST "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/demo-page" \
  -H "Authorization: Bearer $REVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true }'

const res = await fetch("https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/demo-page", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    enabled: true,
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.post(
    "https://www.getrevox.com/api/assistants/3f6c2a1e-8b4d-4c7a-9e2f-5d1b7a9c0e34/demo-page",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    json={
        "enabled": True,
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{ "demo_page_url": "https://example.com" }

{ "error": "Not found" }

Path parameters

idstringrequired
ID of the assistant, as returned by GET /assistants.

Request body

application/json

enabledbooleanrequired
true: turn the page on with a new link (regenerates it if already on). false: turn it off.

Response

200

demo_page_urlstringnullable
The page's link, or null when it is off.

Errors

404Not found in your organization{ "error": string }

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