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

# Get session

> Read one session's state. Carries no token — a lost `session_token` cannot be recovered here.



## OpenAPI

````yaml /schemas/operator.json get /v1/sessions/{id}
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}:
    get:
      tags:
        - Endpoints
      summary: Get session
      description: >-
        Read one session's state. Carries no token — a lost `session_token`
        cannot be recovered here.
      operationId: get_session
      parameters:
        - name: id
          in: path
          description: Session id (`ses_<uuid>`)
          required: true
          schema:
            type: string
      responses:
        '200':
          description: The session
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '401':
          description: invalid_api_key
        '403':
          description: insufficient_scope or product_not_entitled
        '404':
          description: session_not_found
        '429':
          description: rate_limited
      security:
        - bearer_operator: []
components:
  schemas:
    Session:
      type: object
      description: A session as read back. Deliberately has NO token field of any kind.
      required:
        - id
        - object
        - device_id
        - mode
        - state
        - created_at
      properties:
        created_at:
          type: string
        device_id:
          type: string
        expires_at:
          type:
            - string
            - 'null'
        id:
          type: string
        mode:
          type: string
        object:
          type: string
        released_at:
          type:
            - string
            - 'null'
        state:
          type: string
          description: >-
            `active` | `holding` | `expired` | `revoked` — derived, never
            stored.
        takeover_at:
          type:
            - string
            - 'null'
  securitySchemes:
    bearer_operator:
      type: http
      scheme: bearer
      bearerFormat: Opaque

````