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

# Update an active Voice call

> Pushes new context onto one of your tenant’s active Voice calls, addressed by its Reach call ID. Accepted fields become available to the agent on its next natural response. Fields that are not configured for the tenant, or whose values fail their configured type, are reported back as filtered without echoing the submitted values. Calls that have ended return a conflict. Updates are rate limited per partner and per call, and a 503 means the request can be retried as-is.



## OpenAPI

````yaml PATCH /partner/voice/active-calls/{callId}
openapi: 3.0.0
info:
  title: Reach API
  version: 1.0.0
  description: API documentation for Reach platform
servers:
  - url: https://api.embedreach.com
    description: Production server
security: []
paths:
  /partner/voice/active-calls/{callId}:
    patch:
      tags:
        - Partner Voice
      summary: Update an active Voice call
      description: >-
        Pushes new context onto one of your tenant’s active Voice calls,
        addressed by its Reach call ID. Accepted fields become available to the
        agent on its next natural response. Fields that are not configured for
        the tenant, or whose values fail their configured type, are reported
        back as filtered without echoing the submitted values. Calls that have
        ended return a conflict. Updates are rate limited per partner and per
        call, and a 503 means the request can be retried as-is.
      parameters:
        - name: reach-tenant-id
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            description: Reach tenant UUID or your own external tenant ID.
        - schema:
            type: string
            format: uuid
          required: true
          name: callId
          in: path
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                context:
                  type: object
                  additionalProperties:
                    type: string
                    maxLength: 500
                  description: >-
                    Field names and string values to make available to the agent
                    on its next natural response. Requires at least one field
                    and at most 20, with field names up to 100 characters,
                    values up to 500 characters, and 8192 bytes across the whole
                    object.
              required:
                - context
      responses:
        '200':
          description: Status 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      callId:
                        type: string
                        format: uuid
                        description: Reach-owned Voice call ID
                      status:
                        type: string
                        enum:
                          - active
                      appliedContextKeys:
                        type: array
                        items:
                          type: string
                        description: Field names applied to the call
                      filteredContextKeys:
                        type: array
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: Submitted field name that was not applied
                            reason:
                              type: string
                              enum:
                                - not_configured
                                - invalid_value
                          required:
                            - key
                            - reason
                    required:
                      - callId
                      - status
                      - appliedContextKeys
                      - filteredContextKeys
                required:
                  - success
        '400':
          description: Bad Request - Validation or request error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    default: false
                  message:
                    type: string
                    description: Error message describing what went wrong
                  errors:
                    type: array
                    items:
                      type: string
                    description: Optional array of specific validation errors
                required:
                  - message
        '404':
          description: Status 404 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    nullable: true
                required:
                  - success
        '409':
          description: Status 409 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    nullable: true
                required:
                  - success
        '424':
          description: Status 424 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    nullable: true
                required:
                  - success
        '429':
          description: Status 429 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    nullable: true
                required:
                  - success
        '503':
          description: Status 503 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    nullable: true
                required:
                  - success

````