Set caller blocking
Block or unblock one caller by phone number. A blocked number's inbound calls are refused at ingress: silently declined before the call is answered, or answered with a short spoken line then hung up, the agent's call-handling setting blockedCallerAction (set_call_handling) picks which, defaulting to the silent decline. Creates the caller's profile if none exists yet, and works with caller memory off. Pass scope 'workspace' to block the number for every agent in the workspace rather than just this one. Blocking wins over priority routing on the same profile. Inbound only, outbound campaigns keep their own do-not-call list. Use when the operator says things like 'block this number', 'stop +61400000000 calling us', or 'unblock Jordan'.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
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.
1 <= length <= 255Request 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_caller_blocking" \ -H "Content-Type: application/json" \ -d '{ "caller_number": "string", "blocked": true, "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
}Update call handling POST
Configure call handling, the call-lifecycle detection + limit knobs, on agents.settings.callHandling. All fields optional; send only what changes (each is deep-merged over the stored block). Detection: voicemailDetectionEnabled + voicemailAction ('hang_up' | 'leave_message') + voicemailMessage (spoken on 'leave_message'); callScreenEnabled + callScreenMessage (iOS/Android call screening); ivrHangupEnabled (hang up on an IVR, parked for outbound). Keypad/DTMF: keypadInputEnabled + keypadTimeoutSecs (1-30) + keypadTerminationKey (0-9/#/*) + keypadDigitLimit (1-32). Limits: endOnSilenceEnabled + maxSilenceSecs (10-600, a HARD hangup, distinct from the 'are you still there?' check-in); maxCallDurationSecs (60-14400, null = the 15-minute fleet default; a real inbound call is never uncapped); maxDurationCloseLine (the line spoken when the call hits maxCallDurationSecs; null = the runtime default line); ringTimeoutSecs (5-120, null = default; the outbound/warm-transfer dial ring). Caller access: passphraseGateEnabled (answer in silence until the caller says the passphrase, then greet; the phrase lives in the SECRET variable `access_passphrase`, set it with set_secret_variable, and a caller who never says it is hung up on after 60 seconds; voice only; outbound calls skip it). passphraseGateRelaxed opts this agent into repeated-letter spelling variants, one letter of transcription error on phrases of at least six normalized characters, and joining up to three final transcripts within five seconds; off by default. Difficult callers: hangupOnAbuse (default on, hang up on a persistently abusive/hostile caller after a spoken warning; a frustrated caller is never cut off; turn off for sensitive lines like super, health, government, crisis). Use for 'hang up on voicemail', 'leave a voicemail message', 'answer call screening', 'listen for keypad input', 'end the call after N seconds of silence', 'cap calls at an hour', 'ring for 20 seconds', 'stay silent until I say the passphrase', or 'hang up on abusive callers' / 'stop hanging up on abusive callers'.
Update caller memory POST
Configure caller memory, remembering a caller by phone number across calls and personalising the next one. Off by default. Fields (all optional, send only what changes): mode ('off' | 'on'); greeting ('use_in_conversation' = use the name naturally mid-call | 'greet_in_opener' = personalise the first line); identity ('confirm' = soft-confirm 'Am I speaking with Sam?' | 'trust' = greet by name outright | 'silent' = use quietly); conflict ('confirm' | 'latest' | 'append', what to do when this call's details differ from what's stored); recentStore (1-20, default 5, how many past calls to remember per caller); recentInject (1-6, default 2, how many remembered calls to bring into a call). Use when the user says 'remember callers', 'greet repeat callers by name', 'don't ask returning callers who they are', or 'remember more/fewer of their past calls'. To let a pre-call lookup that finds the caller by phone number count for low-risk details such as booking times, set phoneMatchLowRisk with update_agent_settings.