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

# Actualizar una sesión

> Este endpoint permite actualizar las claves de sesión de un usuario específico y continuar la conversación iniciada previamente. El webhook desencadenado por la primera respuesta del usuario proporcionará el session_external_id necesario para esta solicitud.



## OpenAPI

````yaml open-api-files/treble-api-es.json POST /session/{session_external_id}/update
openapi: 3.0.1
info:
  title: API de Treble Poll
  description: Documentación para el endpoint de despliegue de polls en Treble
  version: 1.0.0
servers:
  - url: https://main.treble.ai
    description: Servidor principal de Treble
  - url: https://tudominio.com
    description: >-
      Servidor de ejemplo para implementar los webhooks. Esto representa TU
      servidor donde debes implementar los endpoints que Treble llamará.
security: []
tags:
  - name: Webhooks
    description: >-
      Endpoints que Treble llamará en tu servidor. Estos no son endpoints reales
      que puedas llamar, sino una representación de los webhooks que Treble
      invocará en tu sistema.
paths:
  /session/{session_external_id}/update:
    post:
      summary: Actualizar sesión de usuario y continuar conversación
      description: >-
        Este endpoint permite actualizar las claves de sesión de un usuario
        específico y continuar la conversación iniciada previamente. El webhook
        desencadenado por la primera respuesta del usuario proporcionará el
        session_external_id necesario para esta solicitud.
      parameters:
        - name: session_external_id
          in: path
          required: true
          description: >-
            ID externo de la sesión del usuario. Se obtiene del campo
            'session_external_id' en la respuesta del webhook desencadenado por
            la primera interacción del usuario.
          schema:
            type: string
          example: f33b4734a2e5db671b59877ed3f662ec1f6332a0418c25de4868e35a
        - name: content-type
          in: header
          required: true
          schema:
            type: string
            enum:
              - application/json
      requestBody:
        description: Información de las claves de sesión que se actualizarán
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - user_session_keys
              properties:
                user_session_keys:
                  type: array
                  description: Lista de claves de sesión de usuario que se actualizarán
                  items:
                    $ref: '#/components/schemas/UserSessionKey'
            example:
              user_session_keys:
                - key: order
                  value: 1 Hamburguesa con queso, 2 Vasos de gaseosa
      responses:
        '200':
          description: Sesión actualizada correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Mensaje de confirmación
                  session_id:
                    type: string
                    description: ID de la sesión actualizada
              example:
                message: Sesión actualizada correctamente
                session_id: f33b4734a2e5db671b59877ed3f662ec1f6332a0418c25de4868e35a
        '400':
          description: Error en la solicitud
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de error
                  message:
                    type: string
                    description: Descripción del error
        '404':
          description: Sesión no encontrada
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Código de error
                  message:
                    type: string
                    description: Descripción del error
components:
  schemas:
    UserSessionKey:
      type: object
      required:
        - key
        - value
      properties:
        key:
          type: string
          description: >-
            Nombre de la variable. Valores especiales incluyen
            'deployment_squad' para seleccionar qué número de teléfono realizará
            el despliegue en empresas multicanal.
        value:
          type: string
          description: >-
            Valor de la variable. Para 'deployment_squad', el valor debe ser
            'DS_[CELLPHONE]'.

````