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

# Get session configuration

> The full configuration of a session including tag values and workflow definitions, so an editor can change it and send it back with POST /api/sessions



## OpenAPI

````yaml /api/openapi.json get /api/sessions/{sessionId}/config
openapi: 3.1.0
info:
  title: Yukta REST API
  version: 0.0.1-SNAPSHOT
  description: >-
    Create sessions and workflows, start and steer executions, and read their
    status, logs and results. Pre-beta: paths and schemas may change before
    v0.1.0.
servers:
  - url: http://localhost:8080
    description: Local server (default address)
security:
  - bearerAuth: []
  - apiKeyAuth: []
tags:
  - name: Supervisors API
    description: Supervisors and control planes on the control bus
  - name: Workflow Versions API
    description: List the saved versions and roll back
  - name: Workflow API
    description: Endpoints for starting workflows and listing their executions
  - name: Execution API
    description: Stop, restart and observe workflow executions
  - name: Execution Search API
    description: Find runs across sessions
  - name: Control Bus & Observability API
    description: >-
      Endpoints for control bus operations, node management, and execution
      observability
  - name: Execution Control API
    description: Pause, resume, step and stop nodes
  - name: Session API
    description: Endpoints for session and workflow discovery, configuration management
  - name: Session API
    description: Validate a draft workflow without saving it
  - name: Workers API
    description: Workers connected to the control plane
  - name: Events API
    description: Live feed of execution events
  - name: Workflow Details API
    description: Workflow DAG graph with plugin metadata and per-workflow execution history
  - name: Execution Results API
    description: Follow the result of an execution
  - name: Execution Logs API
    description: Stream execution logs
  - name: Control audit API
    description: Control commands and who sent them
  - name: Plugin API
    description: Endpoints for discovering workflow plugins
paths:
  /api/sessions/{sessionId}/config:
    get:
      tags:
        - Session API
      summary: Get session configuration
      description: >-
        The full configuration of a session including tag values and workflow
        definitions, so an editor can change it and send it back with POST
        /api/sessions
      operationId: getSessionConfig
      parameters:
        - name: sessionId
          in: path
          description: The unique identifier of the session
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ApiResponseSessionConfigResponse'
components:
  schemas:
    ApiResponseSessionConfigResponse:
      type: object
      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:
        timestamp:
          type: string
          format: date-time
          description: The time the response was generated
        status:
          type: integer
          format: int32
          description: The HTTP status code
          example: 200
        message:
          type: string
          description: A human-readable message
          example: Operation successful
        data:
          $ref: '#/components/schemas/SessionConfigResponse'
          description: The response data
        error:
          type: string
          description: The HTTP status error name
          example: Bad Request
        path:
          type: string
          description: The request path
          example: /api/files
        errors:
          type: array
          description: The list of field validation errors
          items:
            $ref: '#/components/schemas/FieldError'
    SessionConfigResponse:
      type: object
      properties:
        sessionId:
          type: string
        name:
          type: string
        description:
          type: string
        initiator:
          type: string
        tags:
          type: object
          additionalProperties:
            type: string
        projectPath:
          type: string
        workflows:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/WorkflowDefinition'
    FieldError:
      type: object
      description: Field-specific validation error detail
      properties:
        field:
          type: string
          description: The name of the field that failed validation
          example: sessionId
        message:
          type: string
          description: The validation error message explaining the failure
          example: 'Session not found: ''unknown-session'''
    WorkflowDefinition:
      type: object
      description: Definition of a reactive workflow DAG
      properties:
        workflowId:
          type: string
          description: Unique workflow identifier
          minLength: 1
        description:
          type: string
          description: A human-readable description of the workflow
          example: Quality check
          maxLength: 256
          minLength: 0
        nodes:
          type: array
          description: Nodes in the workflow
          items:
            $ref: '#/components/schemas/Node'
          minItems: 1
        edges:
          type: array
          description: Edges connecting the nodes
          items:
            $ref: '#/components/schemas/Edge'
      required:
        - description
        - edges
        - nodes
        - workflowId
    Node:
      type: object
      description: A single node in the workflow DAG
      properties:
        nodeId:
          type: string
          description: Unique ID for the node
          minLength: 1
        type:
          type: string
          description: Plugin type
          minLength: 1
        config:
          type: object
          additionalProperties: {}
          description: Plugin configuration
      required:
        - nodeId
        - type
    Edge:
      type: object
      description: A connection between two nodes
      properties:
        source:
          type: string
          description: Source node ID
          minLength: 1
        target:
          type: string
          description: Target node ID
          minLength: 1
        sourcePort:
          type: string
          description: Source port name (optional; omit to route all messages)
      required:
        - source
        - target
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key sent as `Authorization: Bearer <key>`. Needed only when the
        server has a key configured.
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: The same API key sent as `X-API-Key`.

````

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