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

> ## Agent Instructions
> Anchor Browser is cloud browser infrastructure for AI agents and automation: browser sessions you control over CDP or REST, natural-language web tasks, versioned automation tasks, managed authentication into third-party web apps (identities with MFA), persistent volumes and profiles, recordings, live view, batch sessions, webhooks, and network options including residential proxies, extra stealth, and captcha solving for sites that block standard browsers. AI agents should start at https://docs.anchorbrowser.io/for-agents, then create an API key at https://app.anchorbrowser.io/api-keys. Read the for-agents page before authentication or API calls.

# List Pending Human Interventions

> Returns all pending human-in-the-loop (HITL) requests across the team's active
browser sessions. Each item includes the intervention request plus the session
ID and tags for routing responses.




## OpenAPI

````yaml /openapi.yaml get /v1/sessions/pending-interventions
openapi: 3.1.0
info:
  title: AnchorBrowser API
  version: 1.0.0
  description: >
    Anchor Browser ([anchorbrowser.io](https://anchorbrowser.io)) provides cloud
    browsers built

    for AI agents and automation. Use this API to launch and control browser
    sessions, run

    natural-language web tasks, authenticate into third-party web apps with
    managed identities,

    and capture recordings — reliably and at scale, without operating browser
    infrastructure

    yourself.


    ## Core resources

    - **Sessions** (`/v1/sessions`): launch configurable cloud browsers —
    residential proxies,
      stealth browsing, captcha solving, profiles, extensions, recording — and connect over CDP
      with Playwright, Puppeteer, or any CDP client.
    - **AI tools** (`/v1/tools/perform-web-task`): state a goal in natural
    language and the
      built-in agent completes it inside the browser. Related tools fetch webpages, take
      screenshots, render PDFs, and execute code in a session.
    - **Tasks** (`/v1/task`): create, version, deploy, and monitor repeatable
    browser
      automations built to run reliably in production.
    - **Applications and identities** (`/v1/applications`, `/v1/identities`):
    managed
      authentication into third-party web apps — including multi-step logins and TOTP-based
      2FA — so agents can act on behalf of users.
    - **Profiles** (`/v1/profiles`): persist cookies and login state across
    sessions.

    - **OS-level control** (`/v1/sessions/{sessionId}/mouse`, `/keyboard`,
    `/clipboard`):
      raw input for flows that resist DOM automation.
    - Plus batch sessions for running browser fleets in parallel, session
    recordings, webhooks,
      events, extensions, client certificates, and billing usage.

    ## Authentication

    Pass an API key in the `anchor-api-key` header on every request. Create keys
    at

    [app.anchorbrowser.io](https://app.anchorbrowser.io) under API Access.


    ## For AI agents and LLMs

    - Docs: [docs.anchorbrowser.io](https://docs.anchorbrowser.io), with a
    machine-readable
      index at [/llms.txt](https://docs.anchorbrowser.io/llms.txt) and the full corpus at
      [/llms-full.txt](https://docs.anchorbrowser.io/llms-full.txt).
    - MCP server for hosted browser control: `https://api.anchorbrowser.io/mcp`.

    - Official SDKs: `anchorbrowser` on
    [npm](https://www.npmjs.com/package/anchorbrowser) and
      [PyPI](https://pypi.org/project/anchorbrowser/).

    `DELETE` operations terminate sessions or permanently remove resources
    (profiles,

    identities, extensions); `GET` operations are safe and read-only.
servers:
  - url: https://api.anchorbrowser.io
    description: API server
security: []
paths:
  /v1/sessions/pending-interventions:
    get:
      tags:
        - Agentic capabilities
      summary: List Pending Human Interventions
      description: >
        Returns all pending human-in-the-loop (HITL) requests across the team's
        active

        browser sessions. Each item includes the intervention request plus the
        session

        ID and tags for routing responses.
      responses:
        '200':
          description: Pending interventions retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PendingInterventionsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Failed to get pending interventions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - api_key_header: []
components:
  schemas:
    PendingInterventionsResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            count:
              type: integer
              description: >-
                Total number of pending intervention requests across active
                sessions.
            items:
              type: array
              items:
                $ref: '#/components/schemas/PendingInterventionItem'
          required:
            - count
            - items
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
    PendingInterventionItem:
      allOf:
        - $ref: '#/components/schemas/HumanInterventionRequest'
        - type: object
          properties:
            sessionId:
              type: string
              description: The browser session that raised the intervention request.
            tags:
              type: array
              items:
                type: string
              description: Tags associated with the session.
          required:
            - sessionId
            - tags
    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 for your Anchor Browser account, sent as the `anchor-api-key`
        header on every

        request. Create one at
        [app.anchorbrowser.io](https://app.anchorbrowser.io) (API Access).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.