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

# Get current principal

> For the complete documentation index, see https://devlookout.com/llms.txt. Returns the authenticated principal and its assigned roles.



## OpenAPI

````yaml /openapi.yaml get /api/v1/me
openapi: 3.1.0
info:
  title: Lookout HTTP API
  version: 1.0.0
  description: >-
    Versioned interface for querying Lookout security state, ingesting evidence,
    managing Alerts, and promoting Incidents. The deployed Lookout instance is
    authoritative and raw evidence remains local unless export is explicitly
    enabled.
servers:
  - url: https://lookout.example.com
    description: Replace with the private URL of your Lookout deployment
security:
  - bearerAuth: []
tags:
  - name: System
  - name: Security graph
  - name: Rules
  - name: Events
  - name: Collectors
  - name: Alerts
  - name: Incidents
paths:
  /api/v1/me:
    get:
      tags:
        - System
      summary: Get current principal
      description: >-
        For the complete documentation index, see
        https://devlookout.com/llms.txt. Returns the authenticated principal and
        its assigned roles.
      operationId: getCurrentPrincipal
      responses:
        '200':
          description: Authenticated principal
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Principal'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    Principal:
      type: object
      required:
        - id
        - roles
      properties:
        id:
          type: string
        displayName:
          type:
            - string
            - 'null'
        loginName:
          type:
            - string
            - 'null'
        roles:
          type: array
          items:
            type: string
            enum:
              - console
              - viewer
              - ingestor
              - collector
              - analyst
              - rule_admin
              - admin
        authentication:
          type:
            - string
            - 'null'
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
        issues:
          type: array
          items:
            type: string
  responses:
    Unauthorized:
      description: Missing or invalid credentials
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: opaque
      description: A 256-bit token generated by the Lookout CLI.

````