Skip to main content
PUT
Set caller context
Sets what your agent knows about one caller on one of your numbers. Creates the record if it does not exist. See Caller context for how the agent uses these details on a call.

Request

URL-encode the + if your HTTP client does not do it automatically: %2B447450307843.

Body parameters

Send at least one field. A field you leave out keeps its current value; send null to remove it. last_call and open_item are written by the engine after each call and cannot be set here - sending them returns engine_only_field. An unrecognised field name is rejected rather than ignored, so a typo never disappears silently.

Response

200 OK
context is the whole record - your fields together with anything the engine has learned.

Behaviour

  • Last write wins per field. If the caller confirms a different email on a call, the engine stores the new one and the next call uses it. Send the field again to set it back.
  • An empty value never erases. Only an explicit null removes a field.
  • One record per number, per caller. The same person on another of your numbers is a separate record - import them to each number you want them recognised on.
  • Takes effect on the caller’s next call or text. Calls already in progress are unaffected.

Errors