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

# Get Requested Human Interventions

> Retrieves pending human-in-the-loop (HITL) requests for a specific active browser
session. Requires `human_intervention: true` on the task that is running in the
session. The agent pauses until a response is submitted via
`POST /v1/sessions/{session_id}/agent/respond-to-human-intervention`.




## OpenAPI

````yaml /openapi.yaml get /v1/sessions/{session_id}/agent/requested-human-intervention
openapi: 3.1.0
info:
  title: AnchorBrowser API
  version: 1.0.0
  description: APIs to manage all browser-related actions and configuration.
servers:
  - url: https://api.anchorbrowser.io
    description: API server
security: []
paths:
  /v1/sessions/{session_id}/agent/requested-human-intervention:
    get:
      tags:
        - Agentic capabilities
      summary: Get Requested Human Interventions
      description: >
        Retrieves pending human-in-the-loop (HITL) requests for a specific
        active browser

        session. Requires `human_intervention: true` on the task that is running
        in the

        session. The agent pauses until a response is submitted via

        `POST /v1/sessions/{session_id}/agent/respond-to-human-intervention`.
      parameters:
        - name: session_id
          in: path
          required: true
          description: The ID of the browser session
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Pending intervention requests retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HumanInterventionRequestsResponse'
        '400':
          description: Session is not running
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to get agent requested human intervention
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - api_key_header: []
components:
  schemas:
    HumanInterventionRequestsResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            status:
              type: string
              description: Operation status (e.g. `success`).
            message:
              type: string
              description: Human-readable status message from the browser agent.
            requests:
              type: array
              description: Pending intervention requests for this session.
              items:
                $ref: '#/components/schemas/HumanInterventionRequest'
          required:
            - status
            - requests
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
    HumanInterventionRequest:
      type: object
      description: A pending human-in-the-loop request from the agent.
      properties:
        requestId:
          type: string
          description: >-
            Unique identifier for the intervention request. Use this when
            responding.
        message:
          type: string
          description: The agent's prompt or question for the human operator.
        inputType:
          type: string
          enum:
            - text
            - confirm
            - fields
          description: Expected response format (camelCase alias).
        fields:
          type: array
          nullable: true
          description: Form fields to collect when `inputType` is `fields`.
          items:
            $ref: '#/components/schemas/HumanInterventionField'
      required:
        - requestId
        - message
    HumanInterventionField:
      type: object
      properties:
        name:
          type: string
          description: Field identifier used in the response payload.
        label:
          type: string
          description: Human-readable label displayed in the UI.
        description:
          type: string
          nullable: true
          description: Optional helper text for the field.
        required:
          type: boolean
          nullable: true
          description: Whether the field must be filled before submitting a response.
        type:
          type: string
          nullable: true
          enum:
            - text
            - number
            - url
            - email
            - password
          description: Input type for the field.
        placeholder:
          type: string
          nullable: true
          description: Placeholder text shown in the input.
        defaultValue:
          type: string
          nullable: true
          description: Default value for the field (camelCase alias).
      required:
        - name
        - label
  securitySchemes:
    api_key_header:
      type: apiKey
      in: header
      name: anchor-api-key
      description: API key passed in the header

````