Update caller memory
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.
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_memory" \ -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 caller blocking POST
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'.
Set caller routing POST
Mark one caller (by phone number) for priority routing: an inbound call from them is bridged straight to a human, skipping the agent. Creates the caller's profile if none exists yet. Pass destination to route them somewhere other than the agent's own transfer number; omit it to use the agent's transfer_to_human destination at call time. Refused if auto_transfer is true and neither this caller's destination nor the agent's own transfer_to_human is set: call add_builtin_tool with transfer_to_human (or set_builtin_config) first, or pass a destination here. Use when the operator says things like 'always put Jordan straight through to a person' or 'route calls from +61400000000 to reception'.