Operations
Operations

Update public share limits

Configure the limits on the public share surface (/a/<slug>) - the caps behind the Share tab's 'Limits on the public surface' panel. Fields (all optional, send only what changes): maxCallSeconds (0-3600, default 180 = 3 min; 0 or null = no cap - longest a public VOICE call runs; text ignores it); maxTurns (0-500, default 30; 0 or null = no cap - for voice the pipeline turn cap, for text the number of user messages allowed in one shared chat); rateLimitStarts (1-1000, default 10 - public starts one IP may make per window); rateLimitWindowSeconds (60-86400, default 600 = 10 min - the rate-limit window). Bot detection (a challenge the share page passes before a call starts) is not configurable. Use when the operator says 'let the public demo run longer', 'cap the shared call at N minutes', 'no time limit on the share link', 'allow more turns', or 'tighten the rate limit on the share link'.

POST
/operations/set_public_share_limits

Authorization

bearerAuth
AuthorizationBearer <token>

A personal access token from Settings > API tokens.

In: header

Header Parameters

Idempotency-Key?string

A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.

Length1 <= length <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/operations/set_public_share_limits" \  -H "Content-Type: application/json" \  -d '{    "agent": "string"  }'
{}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}

Set pronunciations POST

Replace the agent's custom pronunciations. Each entry teaches the voice (text-to-speech) to SAY a word a specific way ('Joondalup' → 'Joondahlup', 'Matte' → 'Mahtay'), the SPEAK side. Distinct from set_keyterms, which boosts speech-to-text recognition, the HEAR side; use set_pronunciations when the agent mispronounces a term, set_keyterms when it mishears one. The voice reads case from capitalisation, so write each word as it should appear. Pass the FULL list; the existing entries are replaced.

Update realtime mode POST

Configure realtime mode: running calls speech to speech on a provider's realtime API instead of the cascaded speech recognition, AI model and voice stack. provider picks one of three: the default, a second realtime provider, and openai_live, a full-duplex live model. Send only what changes. Each provider reads its own fields: model, voice, webSearch, xSearch with xSearchAllowedHandles, and fileSearchVectorStoreIds belong to the default provider; openaiModel and openaiVoice to the second; liveModel, liveVoice and liveBackendModel to openai_live. customVoiceId overrides voice on the default provider and liveVoice on openai_live. turnMode picks who decides that the caller has finished: server_vad (the provider, on silence), semantic_vad (the model judges from the words; second provider only) or local_vad (our own tuning); it does not apply on openai_live, where the model owns every turn boundary. speakGreetingFirst opens the call with the agent's greeting. All three providers process calls outside Australia, and a dropped provider connection ends the call. The input schema lists every accepted value. Use this for 'enable realtime mode' (enabled true), 'switch the realtime provider' (provider), 'use the cedar voice' (openaiVoice), 'use the ripple voice' (liveVoice), 'use a different backend model for the live provider' (liveBackendModel), 'switch the realtime voice' (voice, or customVoiceId for a cloned voice), 'use our designed voice' (customVoiceId), 'let the model judge when the caller is done' (turnMode semantic_vad), 'let the agent search the web' (webSearch true), 'let it search X / Twitter' (xSearch true, optionally with allowed handles), 'use our turn detection instead of the provider's' (turnMode local_vad). While realtime is enabled the cascade-only Voice, Hearing and Model settings do not apply to calls; use this op's fields instead of set_voice / set_model for a realtime agent.