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

# Takeover

> TAKE the device: pause the agent so a human can drive (200).



## OpenAPI

````yaml /schemas/operator.json post /v1/sessions/{id}/takeover
openapi: 3.1.0
info:
  title: Omegas Operator API
  version: 0.1.0
  description: >-
    The public /v1 machine surface: cloud browser devices, tasks, live-view
    sessions, escalations, usage, webhook endpoints, and the audit trail.
    Generated from the same OpenAPI document the Rust API is checked against.
servers:
  - url: https://api.omegas.dev
    description: Production
security: []
paths:
  /v1/sessions/{id}/takeover:
    post:
      tags:
        - Endpoints
      summary: Takeover
      description: 'TAKE the device: pause the agent so a human can drive (200).'
      operationId: takeover
      parameters:
        - name: id
          in: path
          description: Session id (`ses_<uuid>`)
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TakeoverBody'
        required: true
      responses:
        '200':
          description: Control taken
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TakeoverResponse'
        '401':
          description: invalid_api_key
        '403':
          description: insufficient_scope or product_not_entitled
        '404':
          description: session_not_found
        '409':
          description: takeover_conflict
        '410':
          description: session_expired or device_terminated
        '429':
          description: rate_limited
      security:
        - bearer_operator: []
components:
  schemas:
    TakeoverBody:
      type: object
      properties:
        reason:
          type:
            - string
            - 'null'
          description: >-
            Free-text note recorded on the audit event ("clearing a captcha", a
            ticket id, …).
    TakeoverResponse:
      type: object
      required:
        - session_id
        - paused
        - hold_expires_at
      properties:
        hold_expires_at:
          type: string
          description: When the hold lapses unless released or renewed.
        paused:
          type: boolean
          description: '`true` when a live agent task was actually interrupted.'
        session_id:
          type: string
        task_id:
          type:
            - string
            - 'null'
          description: The task the takeover acted on (`task_<uuid>`), when there was one.
  securitySchemes:
    bearer_operator:
      type: http
      scheme: bearer
      bearerFormat: Opaque

````