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

# Get active session

> Returns the authenticated user profile, active tenant, and IAM role.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/auth/session
openapi: 3.1.0
info:
  title: Qumo Deploy REST API
  description: >
    The Qumo Deploy REST API provides programmatic control over edge relay
    clusters,

    ephemeral token issuance, tenant lifecycle, bot machine identities, and
    billing.
  version: 1.0.0
servers:
  - url: https://api.qumo-deploy.com
    description: Production Control Plane
  - url: http://localhost:8080
    description: Local Development / Sandbox
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /v1/auth/session:
    get:
      summary: Get active session
      description: Returns the authenticated user profile, active tenant, and IAM role.
      responses:
        '200':
          description: Current session info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Session'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    Session:
      type: object
      required:
        - user
        - org_id
        - org_name
        - role
      properties:
        user:
          $ref: '#/components/schemas/User'
        org_id:
          type: string
          example: ten_8f29acb0
        org_name:
          type: string
          example: Acme Corp
        role:
          type: string
          example: roles/tenant.admin
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          example: invalid or expired token
    User:
      type: object
      required:
        - id
        - email
      properties:
        id:
          type: string
          example: usr_9918231
        email:
          type: string
          example: alex@example.com
        name:
          type: string
          example: Alex Developer
        github_login:
          type: string
          example: alexdev
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |
        Bearer token (User session or Bot machine token).
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |
        Project-scoped API key (`qumo_live_...` or `qumo_test_...`).

````