Skip to content
TriedDocs
Calls

Leave call

Stop listening to a live call and free your viewer slot.

POSThttps://api.tried.com.au/v2/calls/{call_id}/leave

Releases the Listen slot you took with Listen to call, so another person can listen. Leave the LiveKit room on your side as well. Beyond Retell

Request#

Path parameters#

Parameter Type Required Description
call_id string Yes The call.

Example request#

curl -X POST "https://api.tried.com.au/v2/calls/call_8d1e0f2a3b4c5d6e7f8a9b0c/leave" \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch("https://api.tried.com.au/v2/calls/call_8d1e0f2a3b4c5d6e7f8a9b0c/leave", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const data = await res.json();
import os, requests

res = requests.post(
    "https://api.tried.com.au/v2/calls/call_8d1e0f2a3b4c5d6e7f8a9b0c/leave",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
data = res.json()

Response#

200 OK with the remaining viewers, in the same shape as List call viewers without max_viewers.

{ "call_id": "call_8d1e0f2a3b4c5d6e7f8a9b0c", "viewers": [] }

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the calls scope.
404 No call with this ID in the workspace.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.