Update conversation context

Injects data into an in-progress conversation’s context. This is useful for passing external signals (e.g. “user just verified their identity”) mid-conversation.

POST /conversations/{conversation_id}/context

Update conversation context

cURL

curl --request POST \
  --url https://api.operator.xyz/conversations/{conversation_id}/context \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Operator-Version: <operator-version>' \
  --data '{
  "data": {}
}'

400

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Operator-Version · enum<string> · required

The API version to use.

Available options: 2025-06-19

Path Parameters

conversation_id · string · required

Unique identifier for the conversation, e.g. conv_8qm9JBCiTe7.

Body

application/json

data · object · required

Key-value pairs to merge into the conversation's context.

Show child attributes

trigger_response · boolean · default: false

Whether the context update should trigger a response.

Response

200

Successful response.