> ## Documentation Index
> Fetch the complete documentation index at: https://operator.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml api-reference/openapi3.json post /conversations/{conversation_id}/context
openapi: 3.0.0
info:
  title: Operator API
  version: '2025-06-19'
  description: API for Operator
servers:
  - url: https://api.operator.xyz
security: []
paths:
  /conversations/{conversation_id}/context:
    post:
      tags:
        - Conversations
      summary: Update conversation context
      description: >-
        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.
      parameters:
        - name: Operator-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-06-19'
          description: The API version to use.
          example: '2025-06-19'
        - name: conversation_id
          in: path
          required: true
          schema:
            description: Unique identifier for the conversation, e.g. `conv_8qm9JBCiTe7`.
            type: string
          description: Unique identifier for the conversation, e.g. `conv_8qm9JBCiTe7`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                data:
                  additionalProperties:
                    type: string
                  description: Key-value pairs to merge into the conversation's context.
                  type: object
                trigger_response:
                  default: false
                  description: Whether the context update should trigger a response.
                  type: boolean
              required:
                - data
              type: object
      responses:
        '200':
          description: Successful response.
        '400':
          description: Conversation is not in progress.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  data: {}
        '404':
          description: The requested resource was not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  message:
                    type: string
                  data: {}
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key

````