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

# Submit new input variables

> Sends corrected input variables to a session waiting for new data. When a workflow encounters an error with the `input_required` error action configured, execution pauses and an `execution.input_required` webhook is sent. Use this endpoint to respond with corrected values so the workflow can resume from the node that uses the corrected variable.

Only keys that already exist in the workflow's input variables are accepted. You only need to include the variables that changed, not all of them.

If no response is received within the configured timeout, the session fails as normal. The timeout is configured per workspace (`input_required_timeout_seconds`) and defaults to 15 seconds (minimum 5, maximum 300).



## OpenAPI

````yaml run-api/run-api.yaml post /run/{session_id}/new_input_variables
openapi: 3.1.0
info:
  title: CloudCruise Run API
  version: 0.1.0
  description: >-
    Endpoints for managing workflow executions, user interactions, and
    retrieving execution results.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /run/{session_id}/new_input_variables:
    post:
      summary: Submit new input variables
      description: >-
        Sends corrected input variables to a session waiting for new data. When
        a workflow encounters an error with the `input_required` error action
        configured, execution pauses and an `execution.input_required` webhook
        is sent. Use this endpoint to respond with corrected values so the
        workflow can resume from the node that uses the corrected variable.


        Only keys that already exist in the workflow's input variables are
        accepted. You only need to include the variables that changed, not all
        of them.


        If no response is received within the configured timeout, the session
        fails as normal. The timeout is configured per workspace
        (`input_required_timeout_seconds`) and defaults to 15 seconds (minimum
        5, maximum 300).
      operationId: submit_new_input_variables
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            description: The unique identifier for the workflow execution session
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input_variables
              properties:
                input_variables:
                  type: object
                  additionalProperties: true
                  description: >-
                    Key-value pairs of corrected input variables. Only include
                    the variables that need to be updated.
                  example:
                    patient_id: CORRECTED-789
      responses:
        '200':
          description: Input variables accepted
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: The session ID that received the new input
                  success:
                    type: boolean
                    description: Whether the input was accepted
        '400':
          description: >-
            input_variables is empty, session is not waiting for input, unknown
            variable name, or session context not found
        '401':
          description: Missing or invalid authentication token
        '404':
          description: Session not found (including workspace mismatch)
components:
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````