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

# Who am I

> The name, role and sessions of the API key of this request, and what it may do (start and control runs, edit and delete sessions, change limits, send commands). With no key configured the role is ADMIN and authEnabled is false. Never returns the key or its hash.



## OpenAPI

````yaml /api/openapi.json get /api/me
openapi: 3.1.0
info:
  description: >-
    Create sessions and workflows, start and steer executions, and read their
    status, logs and results. Alpha: paths and schemas may change before v0.1.0.
  title: Yukta REST API
  version: 0.1.0-alpha.3
servers: []
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - description: Supervisors and control planes on the control bus
    name: Supervisors API
  - description: List the saved versions and roll back
    name: Workflow Versions API
  - description: Endpoints for starting workflows and listing their executions
    name: Workflow API
  - description: Edition, licence and features of this build
    name: Edition API
  - description: Stop, restart and observe workflow executions
    name: Execution API
  - description: Find runs across sessions
    name: Execution Search API
  - description: >-
      Endpoints for control bus operations, node management, and execution
      observability
    name: Control Bus & Observability API
  - description: Who is calling and what the key may do
    name: Session API
  - description: Read part of the output of a node
    name: Node Output API
  - description: Pause, resume, step and stop nodes
    name: Execution Control API
  - description: Endpoints for session and workflow discovery, configuration management
    name: Session API
  - description: Validate a draft workflow without saving it
    name: Session API
  - description: Workers connected to the control plane
    name: Workers API
  - description: Live feed of execution events
    name: Events API
  - description: Workflow DAG graph with plugin metadata and per-workflow execution history
    name: Workflow Details API
  - description: Follow the result of an execution
    name: Execution Results API
  - description: Stream execution logs
    name: Execution Logs API
  - description: Control commands and who sent them
    name: Control audit API
  - description: Example sessions to start from
    name: Templates API
  - description: Signed inbound calls that start a workflow
    name: Webhook API
  - description: Check a working directory before creating a session
    name: Session API
  - description: Endpoints for discovering workflow plugins
    name: Plugin API
paths:
  /api/me:
    get:
      tags:
        - Session API
      summary: Who am I
      description: >-
        The name, role and sessions of the API key of this request, and what it
        may do (start and control runs, edit and delete sessions, change limits,
        send commands). With no key configured the role is ADMIN and authEnabled
        is false. Never returns the key or its hash.
      operationId: me
      responses:
        '200':
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ApiResponseWhoami'
          description: OK
components:
  schemas:
    ApiResponseWhoami:
      description: >-
        Unified API response wrapper for both success and error responses.
        Success responses include data field; error responses include error,
        path, and errors fields.
      properties:
        data:
          $ref: '#/components/schemas/Whoami'
          description: The response data
        error:
          description: The HTTP status error name
          example: Bad Request
          type: string
        errors:
          description: The list of field validation errors
          items:
            $ref: '#/components/schemas/FieldError'
          type: array
        message:
          description: A human-readable message
          example: Operation successful
          type: string
        path:
          description: The request path
          example: /api/files
          type: string
        status:
          description: The HTTP status code
          example: 200
          format: int32
          type: integer
        timestamp:
          description: The time the response was generated
          format: date-time
          type: string
      type: object
    Whoami:
      properties:
        authEnabled:
          type: boolean
        authenticated:
          type: boolean
        keyName:
          type: string
        permissions:
          $ref: '#/components/schemas/Permissions'
        role:
          enum:
            - VIEWER
            - OPERATOR
            - ADMIN
          type: string
        sessions:
          items:
            type: string
          type: array
      type: object
    FieldError:
      description: Field-specific validation error detail
      properties:
        field:
          description: The name of the field that failed validation
          example: sessionId
          type: string
        message:
          description: The validation error message explaining the failure
          example: 'Session not found: ''unknown-session'''
          type: string
      type: object
    Permissions:
      properties:
        changeLimits:
          type: boolean
        controlRuns:
          type: boolean
        deleteSessions:
          type: boolean
        editSessions:
          type: boolean
        sendCommands:
          type: boolean
        startRuns:
          type: boolean
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    apiKeyAuth:
      in: header
      name: X-API-Key
      type: apiKey

````

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