openapi_spec.yaml

openapi: 3.1.0
info:
  title: BReaDv3 API
  description: "\n    BReaDv3 Production API\n    \n    A git-centric AI model fine-tuning platform that uses distributed git repositories \n    for coordination instead of traditional databases.\n    \n    Key Features:\n    - Repository Management: Create and manage AI training repositories\n    - Prompt Management: Store and organize training prompts\n    - Target Management: Define training targets and configurations\n    - Async Workflows: Git-based coordination for distributed training\n    \n    Authentication:\n    All endpoints require authentication via Bearer token.\n    \n    API Structure:\n    - /v1/repo/* - Repository operations\n    - /v1/repo/{repo_name}/prompts/* - Prompt management\n    - /v1/repo/{repo_name}/targets/* - Target management\n    - /v1/repo/{repo_name}/bakes/* - Bake management\n    "
  version: 0.1.0
servers:
  - url: http://localhost:8080
    description: Development server
paths:
  /v1/repo:
    get:
      tags:
        - repositories
      summary: List Repos
      description: "Returns repositories visible to the authenticated team.\n    \n    - Default: Returns simple list of repo names (backward compatible)\n    - With metadata: Use ?include_metadata=true to get repos with base_model\n    - Pagination: Use ?include_metadata=true&offset=0&limit=50 for paginated results"
      operationId: list_repos_v1_repo_get
      security:
        - HTTPBearer: []
      parameters:
        - name: include_metadata
          in: query
          required: false
          schema:
            type: boolean
            description: Include base_model metadata for each repo
            default: false
            title: Include Metadata
          description: Include base_model metadata for each repo
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Starting offset for pagination (only used with include_metadata=true)
            default: 0
            title: Offset
          description: Starting offset for pagination (only used with include_metadata=true)
        - name: limit
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                minimum: 1
              - type: "null"
            description: Page size for pagination (only used with include_metadata=true)
            title: Limit
          description: Page size for pagination (only used with include_metadata=true)
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/RepoList'
                  - $ref: '#/components/schemas/PaginatedRepoList'
                title: Response List Repos V1 Repo Get
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
        - repositories
      summary: Set Repo
      description: '[DEPRECATED] Use POST /v1/repo instead. Creates the repository if missing or returns the existing one. Idempotent; base_model cannot be changed (409 on conflict). This endpoint will be removed in a future version.'
      operationId: set_repo_v1_repo_put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepoCreate'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepoResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Repository already exists - base_model is immutable
          content:
            application/json:
              example:
                message: Repository 'my-repo' already exists with base_model 'Qwen/Qwen3-32B'. Repository base_model is immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - repositories
      summary: Create Repo
      description: 'Creates a new repository. Idempotent: if repo exists with same base_model, returns existing (200). If exists with different base_model, returns 409 Conflict.'
      operationId: create_repo_v1_repo_post
      security:
        - HTTPBearer: []
      parameters:
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepoCreate'
      responses:
        "201":
          description: Repository created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepoResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Repository already exists with different base_model
          content:
            application/json:
              example:
                message: Repository 'my-repo' already exists with base_model 'Qwen/Qwen3-32B'. Repository base_model is immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}:
    get:
      tags:
        - repositories
      summary: Get Repo
      description: Returns repository configuration and metadata.
      operationId: get_repo_v1_repo__repo_name__get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepoResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/prompts:
    get:
      tags:
        - prompts
      summary: List Prompts
      description: Lists prompts in the repository for discovery and validation.
      operationId: list_prompts_v1_repo__repo_name__prompts_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptList'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - prompts
      summary: Create Prompt
      description: 'Creates a new prompt. Idempotent: if prompt exists with same content, returns existing (200). If exists with different content, returns 409 Conflict.'
      operationId: create_prompt_v1_repo__repo_name__prompts_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptCreate'
      responses:
        "201":
          description: Prompt created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Prompt already exists with different content
          content:
            application/json:
              example:
                message: Prompt 'my-prompt' already exists with different content. Prompts are immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation error - invalid prompt name
          content:
            application/json:
              example:
                message: 'Name contains invalid character: ''/'''
                code: VALIDATION_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /v1/repo/{repo_name}/prompts/{prompt_name}:
    get:
      tags:
        - prompts
      summary: Get Prompt
      description: Returns the prompt definition and metadata.
      operationId: get_prompt_v1_repo__repo_name__prompts__prompt_name__get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: prompt_name
          in: path
          required: true
          schema:
            type: string
            title: Prompt Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
        - prompts
      summary: Set Prompt
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/prompts instead. Creates or updates a single prompt. Idempotent; invalid names return 422. This endpoint will be removed in a future version.'
      operationId: set_prompt_v1_repo__repo_name__prompts__prompt_name__put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: prompt_name
          in: path
          required: true
          schema:
            type: string
            title: Prompt Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PromptSet'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PromptResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation error - invalid prompt name
          content:
            application/json:
              example:
                message: 'Name contains invalid character: ''/'''
                code: VALIDATION_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /v1/repo/{repo_name}/prompts/batch:
    put:
      tags:
        - prompts
      summary: Batch Set Prompts
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/prompts/batch instead. Creates or updates multiple prompts. Idempotent; invalid names return 422.'
      operationId: batch_set_prompts_v1_repo__repo_name__prompts_batch_put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchPromptSet'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchPromptResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation error - invalid prompt name
          content:
            application/json:
              example:
                message: 'Name contains invalid character: ''/'''
                code: VALIDATION_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    post:
      tags:
        - prompts
      summary: Batch Create Prompts
      description: Creates or updates multiple prompts. Idempotent; invalid names return 422.
      operationId: batch_create_prompts_v1_repo__repo_name__prompts_batch_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchPromptSet'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchPromptResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation error - invalid prompt name
          content:
            application/json:
              example:
                message: 'Name contains invalid character: ''/'''
                code: VALIDATION_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /v1/repo/{repo_name}/targets:
    get:
      tags:
        - targets
      summary: List Targets
      description: Lists targets in the repository for discovery and validation.
      operationId: list_targets_v1_repo__repo_name__targets_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetList'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - targets
      summary: Create Target
      description: 'Creates a new target. Idempotent: if target exists with same config, returns existing (200). If exists with different config, returns 409 Conflict.'
      operationId: create_target_v1_repo__repo_name__targets_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetCreate'
      responses:
        "201":
          description: Target created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Target already exists with different configuration
          content:
            application/json:
              example:
                message: Target 'my-target' already exists with different configuration. Targets are immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/batch:
    put:
      tags:
        - targets
      summary: Batch Set Targets
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/targets/batch instead. Create or update multiple targets (idempotent).'
      operationId: batch_set_targets_v1_repo__repo_name__targets_batch_put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchTargetCreate'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchTargetResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Target already exists with different configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - targets
      summary: Batch Create Targets
      description: 'Creates multiple targets. Idempotent: if target exists with same config, returns existing. If exists with different config, returns 409 Conflict.'
      operationId: batch_create_targets_v1_repo__repo_name__targets_batch_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchTargetCreate'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchTargetResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Target already exists with different configuration
          content:
            application/json:
              example:
                message: Target 'my-target' already exists with different configuration. Targets are immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/{target_name}:
    put:
      tags:
        - targets
      summary: Set Target
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/targets instead. Create or update a target (idempotent). This endpoint will be removed in a future version.'
      operationId: set_target_v1_repo__repo_name__targets__target_name__put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetConfig'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Target already exists with different configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
        - targets
      summary: Get Target
      description: Get target definition and metadata.
      operationId: get_target_v1_repo__repo_name__targets__target_name__get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
        - targets
      summary: Delete Target
      description: Deletes a target from the repository.
      operationId: delete_target_v1_repo__repo_name__targets__target_name__delete
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/{target_name}/stim:
    get:
      tags:
        - targets
      summary: Get Stim Status
      description: Returns the stim job status.
      operationId: get_stim_status_v1_repo__repo_name__targets__target_name__stim_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StimResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - targets
      summary: Run Stim
      description: |-
        Queue a stim (stimulus generation) job for the target.

        Prereqs: target has stim configuration (u, v, generators).
        Idempotent: repeated calls while a job exists return the current state (no duplicate jobs).

        Async: returns immediately. Poll GET stim status to monitor and fetch results via GET stim output (paginated).
      operationId: run_stim_v1_repo__repo_name__targets__target_name__stim_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StimResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/{target_name}/stim/output:
    get:
      tags:
        - targets
      summary: Get Stim Output
      description: |-
        Get paginated stim output data.

        Returns the generated stimuli from the stim job.
        Use offset and limit parameters to paginate through large datasets.
      operationId: get_stim_output_v1_repo__repo_name__targets__target_name__stim_output_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Starting line number (0-indexed)
            default: 0
            title: Offset
          description: Starting line number (0-indexed)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 1000
            minimum: 1
            description: Number of lines to return (max 1000)
            default: 100
            title: Limit
          description: Number of lines to return (max 1000)
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StimOutputResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/{target_name}/rollout:
    get:
      tags:
        - targets
      summary: Get Rollout Status
      description: Get rollout job status.
      operationId: get_rollout_status_v1_repo__repo_name__targets__target_name__rollout_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RolloutResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - targets
      summary: Run Rollout
      description: |-
        Start a rollout (trajectory generation) job for the specified target.

        The target must have:
        - Completed stim job (stim output must exist)
        - Configured rollout parameters (model_name is required)
        - Sufficient credit balance (prepaid credits required)

        This endpoint creates a job marker and returns immediately - job execution is asynchronous.
      operationId: run_rollout_v1_repo__repo_name__targets__target_name__rollout_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RolloutResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/targets/{target_name}/rollout/output:
    get:
      tags:
        - targets
      summary: Get Rollout Output
      description: "Get paginated rollout output data.\n    \n    Returns the generated trajectories/responses from the rollout job.\n    Use offset and limit parameters to paginate through large datasets."
      operationId: get_rollout_output_v1_repo__repo_name__targets__target_name__rollout_output_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: target_name
          in: path
          required: true
          schema:
            type: string
            title: Target Name
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            description: Starting line number (0-indexed)
            default: 0
            title: Offset
          description: Starting line number (0-indexed)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 1000
            minimum: 1
            description: Number of lines to return (max 1000)
            default: 100
            title: Limit
          description: Number of lines to return (max 1000)
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RolloutOutputResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/bakes:
    get:
      tags:
        - bakes
      summary: List Bakes
      description: Lists bakes in the repository for discovery and validation.
      operationId: list_bakes_v1_repo__repo_name__bakes_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BakeList'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - bakes
      summary: Create Bake
      description: 'Creates a new bake. Idempotent: if bake exists with same config, returns existing (200). If exists with different config, returns 409 Conflict.'
      operationId: create_bake_v1_repo__repo_name__bakes_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BakeCreate'
      responses:
        "201":
          description: Bake created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Bake already exists with different configuration
          content:
            application/json:
              example:
                message: Bake 'my-bake' already exists with different configuration. Bakes are immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/bakes/batch:
    put:
      tags:
        - bakes
      summary: Batch Set Bakes
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/bakes/batch instead. Create or update multiple bakes (idempotent).'
      operationId: batch_set_bakes_v1_repo__repo_name__bakes_batch_put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchBakeCreate'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchBakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Bake already exists with different configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - bakes
      summary: Batch Create Bakes
      description: 'Creates multiple bakes. Idempotent: if bake exists with same config, returns existing. If exists with different config, returns 409 Conflict.'
      operationId: batch_create_bakes_v1_repo__repo_name__bakes_batch_post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchBakeCreate'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchBakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Bake already exists with different configuration
          content:
            application/json:
              example:
                message: Bake 'my-bake' already exists with different configuration. Bakes are immutable and cannot be changed.
                code: RESOURCE_CONFLICT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/bakes/{bake_name}:
    put:
      tags:
        - bakes
      summary: Set Bake
      description: '[DEPRECATED] Use POST /v1/repo/{repo_name}/bakes instead. Create or update a bake (idempotent). This endpoint will be removed in a future version.'
      operationId: set_bake_v1_repo__repo_name__bakes__bake_name__put
      deprecated: true
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BakeConfig'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "409":
          description: Bake already exists with different configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
        - bakes
      summary: Get Bake
      description: Get bake definition and metadata.
      operationId: get_bake_v1_repo__repo_name__bakes__bake_name__get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
        - bakes
      summary: Delete Bake
      description: Deletes a bake from the repository.
      operationId: delete_bake_v1_repo__repo_name__bakes__bake_name__delete
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
        - bakes
      summary: Start Bake
      description: |-
        Queue a bake (model training) job for the specified bake.

        Prereqs: bake config is complete (datasets + training settings); all referenced targets have completed rollouts; sufficient credit balance.
        Idempotent: repeated calls while a job exists return the current state (no duplicate jobs).

        Async: returns immediately. Poll GET bake to monitor (status/job) and access artifacts after completion.
      operationId: start_bake_v1_repo__repo_name__bakes__bake_name__post
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BakeResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/bakes/{bake_name}/download:
    get:
      tags:
        - bakes
      summary: Get Bake Download Url
      description: "Get presigned URL for downloading model weights.\n    \n    Downloads the latest checkpoint by default, or specify checkpoint number via query parameter.\n    Returns a presigned URL valid for 1 hour (configurable via R2_PRESIGNED_URL_EXPIRY)."
      operationId: get_bake_download_url_v1_repo__repo_name__bakes__bake_name__download_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: checkpoint
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
              - type: "null"
            description: Checkpoint number (defaults to latest)
            title: Checkpoint
          description: Checkpoint number (defaults to latest)
        - name: expires_in
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 604800
                minimum: 1
              - type: "null"
            description: URL expiry in seconds (1-604800, default 3600)
            title: Expires In
          description: URL expiry in seconds (1-604800, default 3600)
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadUrlResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/models/download:
    get:
      tags:
        - bakes
      summary: Get Model Download Url
      description: "Get presigned URL for downloading model weights by model name.\n    \n    Model name format: user/repo/bake_name/checkpoint\n    Returns a presigned URL valid for 1 hour (configurable via R2_PRESIGNED_URL_EXPIRY)."
      operationId: get_model_download_url_v1_models_download_get
      security:
        - HTTPBearer: []
      parameters:
        - name: name
          in: query
          required: true
          schema:
            type: string
            description: Model name in format 'user/repo/bake_name/checkpoint'
            title: Name
          description: Model name in format 'user/repo/bake_name/checkpoint'
        - name: expires_in
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 604800
                minimum: 1
              - type: "null"
            description: URL expiry in seconds (1-604800, default 3600)
            title: Expires In
          description: URL expiry in seconds (1-604800, default 3600)
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DownloadUrlResponse'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/bakes/{bake_name}/metrics:
    get:
      tags:
        - bakes
      summary: Get Bake Metrics
      description: "Get training metrics for a bake.\n    \n    Returns all metrics from train_log_metrics.jsonl as a JSON array.\n    Each entry contains metrics like iter, loss, train_loss, lr, etc.\n    Useful for plotting loss curves and other training metrics on the frontend."
      operationId: get_bake_metrics_v1_repo__repo_name__bakes__bake_name__metrics_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  additionalProperties: true
                title: Response Get Bake Metrics V1 Repo  Repo Name  Bakes  Bake Name  Metrics Get
              example:
                - epoch: 2
                  iter: 168
                  iter_tflops: 177.41332358604856
                  iter_time: 8.794658203125
                  loss: 1.369626261293888e-07
                  lr: 0.0009090909090909091
                  seqlen: 5813.0
                  step_tflops: 179.12959608847672
                  step_time: 8.71039501953125
                - epoch: 2
                  iter: 169
                  iter_tflops: 178.12345678901235
                  iter_time: 8.812345678901234
                  loss: 1.345678901234567e-07
                  lr: 0.0009090909090909091
                  seqlen: 5820.0
                  step_tflops: 180.12345678901235
                  step_time: 8.623456789012344
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/recipe/{bake_name}/dependency-graph:
    get:
      tags:
        - recipes
      summary: Get Dependency Graph
      description: "Get the dependency graph for a bake.\n    \n    Returns all resources (bakes, targets, prompts) and their dependencies\n    needed to recreate this bake, including parent bakes and all transitive dependencies.\n    The graph is built using BFS traversal starting from the specified bake."
      operationId: get_dependency_graph_v1_repo__repo_name__recipe__bake_name__dependency_graph_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DependencyGraph'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/recipe/{bake_name}/recreation-plan:
    get:
      tags:
        - recipes
      summary: Get Recreation Plan
      description: "Get the recreation plan for a bake.\n    \n    Returns a step-by-step plan to recreate the bake, including all dependencies.\n    The plan includes all prompts, targets, and bakes needed, in the correct execution order.\n    Parent bake checkpoints are assumed to use the final checkpoint from each bake.\n    \n    The plan is topologically sorted to ensure dependencies are created before dependents.\n    All configurations are cleaned and ready for use (no internal file paths)."
      operationId: get_recreation_plan_v1_repo__repo_name__recipe__bake_name__recreation_plan_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: bake_name
          in: path
          required: true
          schema:
            type: string
            title: Bake Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecreationPlan'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/repo/{repo_name}/tree:
    get:
      tags:
        - recipes
      summary: Get Repo Tree
      description: "Get the complete model lineage tree for a repository.\n    \n    Returns all bakes in the repository with their parent-child relationships,\n    status, checkpoints, and full model paths. This provides a complete view of\n    model evolution without requiring a specific starting bake.\n    \n    Unlike dependency-graph which starts from a specific bake, this endpoint\n    returns the entire repository's model lineage tree in a single call."
      operationId: get_repo_tree_v1_repo__repo_name__tree_get
      security:
        - HTTPBearer: []
      parameters:
        - name: repo_name
          in: path
          required: true
          schema:
            type: string
            title: Repo Name
        - name: user_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override (requires master API key)
            title: User Id
          description: User ID override (requires master API key)
        - name: X-User-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            description: User ID override via header (requires master API key)
            title: X-User-Id
          description: User ID override via header (requires master API key)
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepoTree'
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "402":
          description: Insufficient credits
          content:
            application/json:
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "404":
          description: Resource not found
          content:
            application/json:
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "500":
          description: Internal server error
          content:
            application/json:
              example:
                message: Internal server error
                code: INTERNAL_ERROR
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/admin/users:
    post:
      tags:
        - admin
      summary: Create User
      description: |-
        Admin endpoint to create a user with password.

        Requires master API key for authentication.
        Creates user in LiteLLM, sets up Lago billing, and sets password.
      operationId: create_user_v1_admin_users_post
      parameters:
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: "null"
            title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUserRequest'
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema: {}
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/admin/done_job:
    post:
      tags:
        - admin
      summary: Done Job
      description: "Admin endpoint called by coordinator when a job is complete.\n    \n    This endpoint pulls the repository to sync local state with remote changes.\n    Called automatically by the coordinator when __done_*.txt or __error_*.txt files are pushed."
      operationId: done_job_v1_admin_done_job_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DoneJobPayload'
        required: true
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema: {}
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
        "402":
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
        "404":
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
        "500":
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Internal server error
                code: INTERNAL_ERROR
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/admin/model_ready:
    post:
      tags:
        - admin
      summary: Model Ready
      description: "Admin endpoint to mark a bake as ready for inference.\n    \n    Creates a __model_ready__.txt file in the bake directory to signify\n    that the model is ready for inference."
      operationId: model_ready_v1_admin_model_ready_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ModelReadyPayload'
        required: true
      responses:
        "200":
          description: Successful Response
          content:
            application/json:
              schema: {}
        "400":
          description: Bad request - Invalid input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Invalid input parameters
                code: INVALID_INPUT
        "402":
          description: Insufficient credits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Insufficient credits. Please add funds to continue.
                code: PAYMENT_REQUIRED
        "404":
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Resource not found
                code: RESOURCE_NOT_FOUND
        "500":
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Internal server error
                code: INTERNAL_ERROR
        "422":
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/health:
    get:
      tags:
        - health
      summary: Health Check
      description: Check API health and status
      operationId: health_v1_health_get
      responses:
        "200":
          description: API is healthy and operational
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
components:
  schemas:
    BakeConfig:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing bake name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/BakeConfigBase'
            - type: "null"
          description: Fields to override from template
      additionalProperties: false
      type: object
      required:
        - template
      title: BakeConfig
      description: Bake configuration for create/update (template-based)
    BakeConfigBase:
      properties:
        model_name:
          anyOf:
            - type: string
            - type: "null"
          title: Model Name
          description: Model name
        total_trajectories:
          anyOf:
            - type: integer
            - type: "null"
          title: Total Trajectories
          description: Total trajectories
        seed:
          anyOf:
            - type: integer
            - type: "null"
          title: Seed
          description: Random seed
        datasets:
          anyOf:
            - items:
                $ref: '#/components/schemas/DatasetItem'
              type: array
            - type: "null"
          title: Datasets
          description: List of datasets
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Bake type (e.g., 'single_baker')
        micro_batch_size:
          anyOf:
            - type: integer
            - type: "null"
          title: Micro Batch Size
          description: Micro batch size
        gradient_accumulation_steps:
          anyOf:
            - type: integer
            - type: "null"
          title: Gradient Accumulation Steps
          description: Gradient accumulation steps
        epochs:
          anyOf:
            - type: integer
            - type: "null"
          title: Epochs
          description: Number of epochs
        model:
          anyOf:
            - $ref: '#/components/schemas/ModelConfig'
            - type: "null"
          description: Model configuration
        data:
          anyOf:
            - $ref: '#/components/schemas/DataConfig'
            - type: "null"
          description: Data configuration
        optimizer:
          anyOf:
            - $ref: '#/components/schemas/OptimizerConfig'
            - type: "null"
          description: Optimizer configuration
        scheduler:
          anyOf:
            - $ref: '#/components/schemas/SchedulerConfig'
            - type: "null"
          description: Scheduler configuration
        wandb:
          anyOf:
            - $ref: '#/components/schemas/WandbConfig'
            - type: "null"
          description: Wandb configuration
        deepspeed:
          anyOf:
            - $ref: '#/components/schemas/DeepSpeedConfig'
            - type: "null"
          description: DeepSpeed configuration
        checkpoint:
          anyOf:
            - items:
                $ref: '#/components/schemas/CheckpointConfig'
              type: array
            - type: "null"
          title: Checkpoint
          description: Checkpoint configuration
        train_log_iter_interval:
          anyOf:
            - type: integer
            - type: "null"
          title: Train Log Iter Interval
          description: Training log interval
        eval_interval:
          anyOf:
            - type: integer
            - type: "null"
          title: Eval Interval
          description: Evaluation interval
        activation_checkpoint_cpu_offload:
          anyOf:
            - type: boolean
            - type: "null"
          title: Activation Checkpoint Cpu Offload
          description: Offload activation checkpoints to CPU memory to save GPU memory
      additionalProperties: false
      type: object
      title: BakeConfigBase
      description: Base bake configuration fields (for responses - all optional)
    BakeConfigWithName:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing bake name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/BakeConfigBase'
            - type: "null"
          description: Fields to override from template
        bake_name:
          type: string
          title: Bake Name
          description: Bake name
      additionalProperties: false
      type: object
      required:
        - template
        - bake_name
      title: BakeConfigWithName
      description: Bake configuration with explicit name for batch operations
    BakeCreate:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing bake name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/BakeConfigBase'
            - type: "null"
          description: Fields to override from template
        bake_name:
          type: string
          title: Bake Name
          description: Name of the bake
      additionalProperties: false
      type: object
      required:
        - template
        - bake_name
      title: BakeCreate
      description: Bake create model (includes bake_name in body)
    BakeList:
      properties:
        bakes:
          items:
            type: string
          type: array
          title: Bakes
          description: List of bake names
      additionalProperties: false
      type: object
      required:
        - bakes
      title: BakeList
      description: Bake list
      example:
        bakes:
          - bake_v1
          - bake_v2
          - bake_v3
    BakeResource:
      properties:
        bake_name:
          type: string
          title: Bake Name
          description: Name of the bake
        model_names:
          items:
            type: string
          type: array
          title: Model Names
          description: List of model names (checkpoints) for this bake
      type: object
      required:
        - bake_name
      title: BakeResource
      description: Bake resource with model names
    BakeResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Job status: not_started, running, complete, failed'
        lines:
          anyOf:
            - type: integer
            - type: "null"
          title: Lines
          description: Number of output lines (not applicable for bakes)
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Config
          description: Job config parameters
        error:
          anyOf:
            - type: string
            - type: "null"
          title: Error
          description: Error message if job failed
        job_id:
          anyOf:
            - type: integer
            - type: "null"
          title: Job Id
          description: Coordinator job ID (if job is queued/running)
        progress_percent:
          anyOf:
            - type: number
            - type: "null"
          title: Progress Percent
          description: Job progress percentage (0-100) if job is running
        model_name:
          anyOf:
            - items:
                type: string
              type: array
            - type: "null"
          title: Model Name
          description: List of model names in format 'user/repo/bake_name/checkpoint'. Index 0 is the latest checkpoint. Only present when status is 'complete'
        loss:
          anyOf:
            - additionalProperties:
                type: number
              type: object
            - type: "null"
          title: Loss
          description: Loss values from training. Contains 'latest_loss', 'final_loss', 'min_loss', 'max_loss'. Present when status is 'running' or 'complete' and metrics are available
      additionalProperties: false
      type: object
      required:
        - status
      title: BakeResponse
      description: 'Bake response: Inherits all fields from JobStatus'
      example:
        config:
          epochs: 3
          micro_batch_size: 8
          model:
            baked_adapter_config:
              bias: none
              lora_alpha: 32
              lora_dropout: 0.05
              r: 32
              target_modules: all-linear
            type: bake
          type: single_baker
        job_id: 1
        loss:
          final_loss: 1.395237632095814e-07
          latest_loss: 1.395237632095814e-07
          max_loss: 1.5422701835632324e-06
          min_loss: 1.314911060035229e-07
        model_name:
          - user/repo/bake_name/183
          - user/repo/bake_name/100
        progress_percent: 100.0
        status: complete
    BakeTreeNode:
      properties:
        status:
          type: string
          title: Status
          description: 'Bake status: complete, failed, running, pending, unknown'
        model_name:
          items:
            type: string
          type: array
          title: Model Name
          description: List of full model paths with checkpoints
        checkpoints:
          items:
            type: integer
          type: array
          title: Checkpoints
          description: List of checkpoint numbers
        config:
          additionalProperties: true
          type: object
          title: Config
          description: Bake configuration (bake.yml)
      additionalProperties: false
      type: object
      required:
        - status
        - config
      title: BakeTreeNode
      description: A node in the repository tree representing a single bake.
    BatchBakeCreate:
      properties:
        bakes:
          items:
            $ref: '#/components/schemas/BakeConfigWithName'
          type: array
          title: Bakes
          description: List of bakes to create/update
      additionalProperties: false
      type: object
      required:
        - bakes
      title: BatchBakeCreate
      description: Batch bake creation
      example:
        bakes:
          - bake_name: bake_v1
            overrides:
              epochs: 5
              micro_batch_size: 16
            template: default
          - bake_name: bake_v2
            overrides:
              optimizer:
                learning_rate: 0.001
            template: bake_v1
    BatchBakeResponse:
      properties:
        created:
          items:
            type: string
          type: array
          title: Created
          description: List of successfully created items
        failed:
          additionalProperties:
            type: string
          type: object
          title: Failed
          description: Dictionary of failed items with error messages
      additionalProperties: false
      type: object
      required:
        - created
        - failed
      title: BatchBakeResponse
      description: Batch bake response
      example:
        created:
          - coding_bake_v1
          - math_bake_v1
        failed:
          bad_config_bake: 'Invalid dataset reference: target ''missing_target'' not found'
          invalid_bake: Template 'nonexistent_bake' not found
    BatchPromptResponse:
      properties:
        created:
          items:
            type: string
          type: array
          title: Created
          description: List of successfully created items
        failed:
          additionalProperties:
            type: string
          type: object
          title: Failed
          description: Dictionary of failed items with error messages
      additionalProperties: false
      type: object
      required:
        - created
        - failed
      title: BatchPromptResponse
      description: Batch prompt response model
      example:
        created:
          - greeting_prompt
          - mathematics_prompt
        failed:
          invalid_prompt: 'Name contains invalid character: ''/'''
    BatchPromptSet:
      properties:
        prompts:
          additionalProperties:
            items:
              $ref: '#/components/schemas/Message'
            type: array
          type: object
          title: Prompts
          description: Dictionary mapping prompt_name to messages list
      additionalProperties: false
      type: object
      required:
        - prompts
      title: BatchPromptSet
      description: Batch prompt set model
      examples:
        - prompts:
            greeting_prompt:
              - content: You must always greet the user with a warm welcome.
                role: assistant
            mathematics_prompt:
              - content: |-
                  You are a helpful assistant that can answer questions
                                                  about mathematics.
                role: assistant
    BatchTargetCreate:
      properties:
        targets:
          items:
            $ref: '#/components/schemas/TargetConfigWithName'
          type: array
          title: Targets
          description: List of targets to create/update
      additionalProperties: false
      type: object
      required:
        - targets
      title: BatchTargetCreate
      description: Batch target creation
      example:
        targets:
          - overrides:
              temperature: 0.8
              u: my_unconditioned_prompt
            target_name: target_alpha
            template: default
          - overrides:
              v: my_conditioned_prompt
            target_name: target_beta
            template: target_alpha
    BatchTargetResponse:
      properties:
        created:
          items:
            type: string
          type: array
          title: Created
          description: List of successfully created items
        failed:
          additionalProperties:
            type: string
          type: object
          title: Failed
          description: Dictionary of failed items with error messages
      additionalProperties: false
      type: object
      required:
        - created
        - failed
      title: BatchTargetResponse
      description: Batch target response model
      example:
        created:
          - target_alpha
          - target_beta
        failed:
          target_delta: Template 'nonexistent' not found
          target_gamma: 'Missing required stim fields: [''teacher_prompt'', ''student_prompt'']'
    CheckpointConfig:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Checkpoint engine type
        output_dir:
          anyOf:
            - type: string
            - type: "null"
          title: Output Dir
          description: Output directory for checkpoints (will be resolved to Path)
        enabled:
          anyOf:
            - type: boolean
            - type: "null"
          title: Enabled
          description: Enable this checkpoint engine
          default: true
        auto_resume:
          anyOf:
            - type: boolean
            - type: "null"
          title: Auto Resume
          description: If a checkpoint is found in output_dir, resume training from that checkpoint
          default: false
        save_every_n_steps:
          anyOf:
            - type: integer
              minimum: 0.0
            - type: "null"
          title: Save Every N Steps
          description: How often to trigger a checkpoint save by training global step count
        save_every_n_epochs:
          anyOf:
            - type: integer
              minimum: 0.0
            - type: "null"
          title: Save Every N Epochs
          description: How often to trigger a checkpoint save by training epoch count
        save_end_of_training:
          anyOf:
            - type: boolean
            - type: "null"
          title: Save End Of Training
          description: Whether to save a checkpoint at the end of training
          default: false
      additionalProperties: false
      type: object
      title: CheckpointConfig
      description: Checkpoint configuration
    CreateUserRequest:
      properties:
        user_id:
          type: string
          title: User Id
        user_alias:
          type: string
          title: User Alias
        user_email:
          type: string
          format: email
          title: User Email
        password:
          type: string
          title: Password
      type: object
      required:
        - user_id
        - user_alias
        - user_email
        - password
      title: CreateUserRequest
      description: Request to create a new user account.
    DataConfig:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Data type (e.g., 'single_baker')
        sources:
          anyOf:
            - items:
                $ref: '#/components/schemas/DataSource'
              type: array
            - type: "null"
          title: Sources
          description: List of data sources
        eval_sources:
          anyOf:
            - items:
                $ref: '#/components/schemas/DataSource'
              type: array
            - type: "null"
          title: Eval Sources
          description: List of data sources to use for evaluation
        beta:
          anyOf:
            - type: number
            - type: "null"
          title: Beta
          description: Beta parameter for training
        temperature:
          anyOf:
            - type: number
            - type: "null"
          title: Temperature
          description: Sampling temperature
        max_length:
          anyOf:
            - type: integer
            - type: "null"
          title: Max Length
          description: Maximum sequence length
        train_eval_split:
          anyOf:
            - items:
                type: number
              type: array
            - type: "null"
          title: Train Eval Split
          description: Train/eval split ratio [train, eval]
        cache_dir:
          anyOf:
            - type: string
            - type: "null"
          title: Cache Dir
          description: Cache directory
        dl_num_workers:
          anyOf:
            - type: integer
            - type: "null"
          title: Dl Num Workers
          description: Number of dataloader workers per GPU
        num_proc:
          anyOf:
            - type: integer
            - type: "null"
          title: Num Proc
          description: Number of processes to use for data loading
        seed:
          anyOf:
            - type: integer
            - type: "null"
          title: Seed
          description: Seed for data loading
        use_data_cache:
          anyOf:
            - type: boolean
            - type: "null"
          title: Use Data Cache
          description: Whether to cache loaded data. Deprecated - data cache is used by default now.
        cache_fs_type:
          anyOf:
            - type: string
            - type: "null"
          title: Cache Fs Type
          description: 'Cache filesystem type: ''auto'', ''local'', or ''shared'''
      additionalProperties: false
      type: object
      title: DataConfig
      description: Data configuration for training
    DataSource:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Source type (e.g., 'bake_jsonl')
        name_or_path:
          anyOf:
            - type: string
            - type: "null"
          title: Name Or Path
          description: Path to data file
        split:
          anyOf:
            - type: string
            - type: "null"
          title: Split
          description: Split to load (e.g., 'train' or 'eval'). Defaults to 'train' for training sources, 'eval' for eval sources.
        max_samples:
          anyOf:
            - type: integer
            - type: "null"
          title: Max Samples
          description: Maximum samples to use (-1 for all)
        sample_ratio:
          anyOf:
            - type: number
            - type: "null"
          title: Sample Ratio
          description: Ratio of the dataset to randomly sample. If None, all examples are used.
        sample_count:
          anyOf:
            - type: integer
            - type: "null"
          title: Sample Count
          description: Number of examples to randomly sample. If None, all examples are used.
        sample_seed:
          anyOf:
            - type: integer
            - type: "null"
          title: Sample Seed
          description: Seed for random sampling. Used only if sample_ratio or sample_count is set.
          default: 42
        process:
          anyOf:
            - type: boolean
            - type: "null"
          title: Process
          description: Whether to process the data with the data factory process function (e.g., tokenization for SFTDataFactory).
          default: true
      additionalProperties: false
      type: object
      title: DataSource
      description: Individual data source configuration
    DatasetItem:
      properties:
        target:
          type: string
          title: Target
          description: Target name
        weight:
          type: number
          title: Weight
          description: Dataset weight
          default: 1.0
      additionalProperties: false
      type: object
      required:
        - target
      title: DatasetItem
      description: Dataset reference for collation (API-facing, simplified)
    DeepSpeedConfig:
      properties:
        zero_optimization:
          anyOf:
            - $ref: '#/components/schemas/DeepSpeedZeroConfig'
            - type: "null"
          description: ZeRO optimization settings
      additionalProperties: false
      type: object
      title: DeepSpeedConfig
      description: DeepSpeed configuration
    DeepSpeedZeroConfig:
      properties:
        stage:
          anyOf:
            - type: integer
            - type: "null"
          title: Stage
          description: ZeRO stage (0, 1, 2, or 3)
      additionalProperties: false
      type: object
      title: DeepSpeedZeroConfig
      description: DeepSpeed ZeRO optimization configuration
    DeleteResponse:
      properties:
        message:
          type: string
          title: Message
          description: Success message confirming deletion
      additionalProperties: false
      type: object
      required:
        - message
      title: DeleteResponse
      description: Standard delete operation response
      example:
        message: Resource deleted successfully
    DependencyGraph:
      properties:
        base_model:
          type: string
          title: Base Model
          description: Base model name
        bakes:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Bakes
          description: Dictionary of bake configs (collation + bake)
        targets:
          additionalProperties:
            additionalProperties: true
            type: object
          type: object
          title: Targets
          description: Dictionary of target configs (stim + rollout)
        prompts:
          additionalProperties:
            anyOf:
              - type: string
              - type: "null"
          type: object
          title: Prompts
          description: Dictionary of prompt names to file paths
        edges:
          items:
            prefixItems:
              - type: string
              - type: string
              - type: string
              - type: string
            type: array
            maxItems: 4
            minItems: 4
          type: array
          title: Edges
          description: List of dependency edges (source_type, source_name, target_type, target_name)
      additionalProperties: false
      type: object
      required:
        - base_model
        - bakes
        - targets
        - prompts
        - edges
      title: DependencyGraph
      description: |-
        Dependency graph for a bake.

        Represents the complete dependency graph including all parent bakes,
        targets, prompts, and their relationships. Built using BFS traversal
        starting from the specified bake.
    DoneJobPayload:
      properties:
        file:
          type: string
          title: File
        user:
          type: string
          title: User
        repo:
          type: string
          title: Repo
      additionalProperties: false
      type: object
      required:
        - file
        - user
        - repo
      title: DoneJobPayload
      description: Payload for done_job webhook from coordinator
    DownloadUrlResponse:
      properties:
        url:
          type: string
          title: Url
          description: Presigned URL for downloading weights
        expires_in:
          type: integer
          title: Expires In
          description: URL expiry time in seconds
        checkpoint:
          type: integer
          title: Checkpoint
          description: Checkpoint number
        bake_name:
          type: string
          title: Bake Name
          description: Bake name
      additionalProperties: false
      type: object
      required:
        - url
        - expires_in
        - checkpoint
        - bake_name
      title: DownloadUrlResponse
      description: Presigned URL response for downloading model weights
      example:
        bake_name: my_bake_v1
        checkpoint: 0
        expires_in: 3600
        url: https://r2-presigned-url.example.com/lfs/ab/cd/abcdef123456...?X-Amz-Algorithm=...
    ErrorResponse:
      properties:
        message:
          type: string
          title: Message
          description: Error message
        code:
          anyOf:
            - type: string
            - type: "null"
          title: Code
          description: Error code for programmatic handling
      additionalProperties: false
      type: object
      required:
        - message
      title: ErrorResponse
      description: Standard error response
    Generator:
      properties:
        type:
          type: string
          title: Type
          description: 'Generator type: oneshot_qs, hardcoded, persona, from_dataset, custom'
        model:
          anyOf:
            - type: string
            - type: "null"
          title: Model
          description: Model name for oneshot_qs
        numq:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Numq
          description: Number of questions to generate
        temperature:
          anyOf:
            - type: number
              maximum: 2.0
              minimum: 0.0
            - type: "null"
          title: Temperature
          description: Generation temperature (0.0-2.0)
        max_tokens:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Max Tokens
          description: Maximum number of tokens to generate
        dataset:
          anyOf:
            - type: string
            - type: "null"
          title: Dataset
          description: Dataset name for from_dataset
        questions:
          anyOf:
            - items:
                type: string
              type: array
            - type: "null"
          title: Questions
          description: Hardcoded questions
        template_path:
          anyOf:
            - type: string
            - type: "null"
          title: Template Path
          description: Template filename for custom generator type. When template_content is provided, the file is written to the repo-level templates/ directory (same level as prompts/, bakes/, targets/). The path is normalized to templates/{filename} format. Used by bake_dataset_utils to reference the template file during dataset generation.
        template_content:
          anyOf:
            - type: string
            - type: "null"
          title: Template Content
          description: Template file content (for upload)
        seed:
          anyOf:
            - type: integer
            - type: "null"
          title: Seed
          description: Random seed
        rollout_with_conditioned:
          anyOf:
            - type: boolean
            - type: "null"
          title: Rollout With Conditioned
          description: 'If True, use conditioned_stimulus (v) for trajectory generation instead of unconditioned_stimulus (u). When set, adds trajectory_override_stimulus field to stimulus output. Default: false (trajectories use unconditioned stimulus).'
      additionalProperties: false
      type: object
      required:
        - type
      title: Generator
      description: Generator model
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    HealthResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'API health status: ''healthy'' or ''degraded'''
        api:
          type: string
          title: Api
          description: API name
        version:
          type: string
          title: Version
          description: API version
      additionalProperties: false
      type: object
      required:
        - status
        - api
        - version
      title: HealthResponse
      description: Health check response
      example:
        api: bread-api
        status: healthy
        version: 0.1.0
    LoRAAdapterConfig:
      properties:
        r:
          anyOf:
            - type: integer
            - type: "null"
          title: R
          description: LoRA rank
        lora_alpha:
          anyOf:
            - type: integer
            - type: "null"
          title: Lora Alpha
          description: LoRA alpha parameter
        target_modules:
          anyOf:
            - type: string
            - type: "null"
          title: Target Modules
          description: Target modules (e.g., 'all-linear')
        lora_dropout:
          anyOf:
            - type: number
            - type: "null"
          title: Lora Dropout
          description: LoRA dropout rate
        bias:
          anyOf:
            - type: string
            - type: "null"
          title: Bias
          description: Bias setting (e.g., 'none')
      additionalProperties: false
      type: object
      title: LoRAAdapterConfig
      description: LoRA adapter configuration
    Message:
      properties:
        role:
          type: string
          title: Role
          description: Role of the message sender
        content:
          anyOf:
            - type: string
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: "null"
          title: Content
          description: Content of the message (can be null for assistant with tool_calls)
      additionalProperties: true
      type: object
      required:
        - role
      title: Message
      description: Message model with flexible tool support
    ModelConfig:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Model factory type
        parent_model_name:
          anyOf:
            - type: string
            - type: "null"
          title: Parent Model Name
          description: Parent model name (e.g., 'user/repo/bake_name/checkpoint' or base model like 'Qwen/Qwen3-32B')
        baked_adapter_config:
          anyOf:
            - $ref: '#/components/schemas/LoRAAdapterConfig'
            - type: "null"
          description: LoRA adapter configuration
        dtype:
          anyOf:
            - type: string
            - type: "null"
          title: Dtype
          description: Data type for model weights (e.g., 'bf16', 'fp16', 'fp32')
        save_name:
          anyOf:
            - type: string
            - type: "null"
          title: Save Name
          description: Name to use when saving the model
        attn_implementation:
          anyOf:
            - type: string
            - type: "null"
          title: Attn Implementation
          description: Attention implementation to use (e.g., 'sdpa', 'flash_attention_2')
        disable_activation_checkpoint:
          anyOf:
            - type: boolean
            - type: "null"
          title: Disable Activation Checkpoint
          description: Disable the use of activation checkpointing
          default: false
        peft_config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Peft Config
          description: Configuration for Parameter Efficient Fine Tuning
        student_model_path:
          anyOf:
            - type: string
            - type: "null"
          title: Student Model Path
          description: Name of student model if doing distill baking. This makes teacher and student different models (eg. 'Qwen/Qwen3-0.6B')
      additionalProperties: false
      type: object
      title: ModelConfig
      description: Model configuration for baking
    ModelReadyPayload:
      properties:
        user:
          type: string
          title: User
          description: User name
        repo:
          type: string
          title: Repo
          description: Repository name
        bake_name:
          type: string
          title: Bake Name
          description: Bake name
      additionalProperties: false
      type: object
      required:
        - user
        - repo
        - bake_name
      title: ModelReadyPayload
      description: Payload for model_ready admin endpoint
    OptimizerConfig:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Optimizer factory type. Defaults to trainer's optimizer_factory_type.
        learning_rate:
          anyOf:
            - type: number
            - type: "null"
          title: Learning Rate
          description: The initial learning rate
        weight_decay:
          anyOf:
            - type: number
              minimum: 0.0
            - type: "null"
          title: Weight Decay
          description: Coefficient for L2 regularization applied to the optimizer's weights.
        betas:
          anyOf:
            - prefixItems:
                - type: number
                - type: number
              type: array
              maxItems: 2
              minItems: 2
            - type: "null"
          title: Betas
          description: Tuple of coefficients used for computing running averages of gradient and its square (e.g., (beta1, beta2) for Adam).
      additionalProperties: false
      type: object
      title: OptimizerConfig
      description: Optimizer configuration
    PaginatedRepoList:
      properties:
        repos:
          items:
            $ref: '#/components/schemas/RepoItem'
          type: array
          title: Repos
          description: List of repositories with metadata
        offset:
          type: integer
          minimum: 0.0
          title: Offset
          description: Starting offset
        limit:
          type: integer
          minimum: 1.0
          title: Limit
          description: Page size
        has_more:
          type: boolean
          title: Has More
          description: Whether more repositories are available
        total:
          anyOf:
            - type: integer
            - type: "null"
          title: Total
          description: Total number of repositories (if available)
      additionalProperties: false
      type: object
      required:
        - repos
        - offset
        - limit
        - has_more
      title: PaginatedRepoList
      description: Paginated repository list with metadata
    PromptCreate:
      properties:
        prompt_name:
          type: string
          title: Prompt Name
          description: Name of the prompt
        messages:
          items:
            $ref: '#/components/schemas/Message'
          type: array
          title: Messages
          description: List of messages in the prompt
        tools:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: "null"
          title: Tools
          description: List of available tools/functions (OpenAI format)
      additionalProperties: false
      type: object
      required:
        - prompt_name
        - messages
      title: PromptCreate
      description: Prompt create model (includes prompt_name in body)
    PromptList:
      properties:
        prompts:
          items:
            type: string
          type: array
          title: Prompts
          description: List of prompt names
      additionalProperties: false
      type: object
      required:
        - prompts
      title: PromptList
      description: Prompt list model
      example:
        prompts:
          - system_prompt_coding
          - user_prompt_python
          - greeting_prompt
    PromptResponse:
      properties:
        prompt_name:
          type: string
          title: Prompt Name
          description: Prompt identifier
        messages:
          items:
            $ref: '#/components/schemas/Message'
          type: array
          title: Messages
          description: List of messages in the prompt
        tools:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: "null"
          title: Tools
          description: List of available tools/functions (OpenAI format)
      additionalProperties: false
      type: object
      required:
        - prompt_name
        - messages
      title: PromptResponse
      description: Prompt response model
      example:
        messages:
          - content: You are an expert Python programmer.
            role: system
        prompt_name: system_prompt_coding
    PromptSet:
      properties:
        messages:
          items:
            $ref: '#/components/schemas/Message'
          type: array
          title: Messages
          description: List of messages in the prompt
        tools:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: "null"
          title: Tools
          description: List of available tools/functions (OpenAI format)
      additionalProperties: false
      type: object
      required:
        - messages
      title: PromptSet
      description: Prompt set model
    RecreationPlan:
      properties:
        base_model:
          type: string
          title: Base Model
          description: Base model name (e.g., 'Qwen/Qwen3-32B')
        steps:
          items:
            $ref: '#/components/schemas/RecreationPlanStep'
          type: array
          title: Steps
          description: Ordered list of steps to recreate the bake
        total_steps:
          type: integer
          title: Total Steps
          description: Total number of steps
        resources:
          $ref: '#/components/schemas/RecreationPlanResources'
          description: Summary of all resources
      additionalProperties: false
      type: object
      required:
        - base_model
        - steps
        - total_steps
        - resources
      title: RecreationPlan
      description: |-
        Recreation plan for a bake.

        A complete step-by-step plan to recreate a bake, including all dependencies
        in the correct execution order. The plan is topologically sorted to ensure
        dependencies are created before dependents.
    RecreationPlanResources:
      properties:
        prompts:
          items:
            type: string
          type: array
          title: Prompts
          description: List of prompt names
        targets:
          items:
            type: string
          type: array
          title: Targets
          description: List of target names
        bakes:
          items:
            $ref: '#/components/schemas/BakeResource'
          type: array
          title: Bakes
          description: List of bake resources with model names
      additionalProperties: false
      type: object
      required:
        - prompts
        - targets
        - bakes
      title: RecreationPlanResources
      description: Resources summary in recreation plan.
    RecreationPlanStep:
      properties:
        step:
          type: integer
          title: Step
          description: Step number in execution order
        action:
          type: string
          title: Action
          description: 'Action to perform: create_prompt, create_target, run_stim, run_rollout, create_bake, run_bake'
        resource_type:
          type: string
          title: Resource Type
          description: 'Type of resource: prompt, target, or bake'
        resource_name:
          type: string
          title: Resource Name
          description: Name of the resource
        dependencies:
          items:
            type: string
          type: array
          title: Dependencies
          description: List of dependencies in format 'resource_type:resource_name' or 'resource_type:resource_name:status'
        config:
          additionalProperties: true
          type: object
          title: Config
          description: Configuration for this resource (cleaned, no internal paths)
      additionalProperties: false
      type: object
      required:
        - step
        - action
        - resource_type
        - resource_name
        - dependencies
        - config
      title: RecreationPlanStep
      description: |-
        A single step in the recreation plan.

        Represents one action needed to recreate a bake, including its dependencies
        and configuration.
    RepoCreate:
      properties:
        repo_name:
          type: string
          title: Repo Name
          description: Name of the repository
        base_model:
          anyOf:
            - type: string
            - type: "null"
          title: Base Model
          description: Base model for the repository (optional)
          default: Qwen/Qwen3-32B
      additionalProperties: false
      type: object
      required:
        - repo_name
      title: RepoCreate
      description: Repository create model
    RepoItem:
      properties:
        repo_name:
          type: string
          title: Repo Name
          description: Repository name
        base_model:
          type: string
          title: Base Model
          description: Base model identifier
      additionalProperties: false
      type: object
      required:
        - repo_name
        - base_model
      title: RepoItem
      description: Repository item with metadata
    RepoList:
      properties:
        repos:
          items:
            type: string
          type: array
          title: Repos
          description: List of repository names
      additionalProperties: false
      type: object
      required:
        - repos
      title: RepoList
      description: Repository list model
      example:
        repos:
          - production
          - development
          - experiment-1
    RepoResponse:
      properties:
        repo_name:
          type: string
          title: Repo Name
          description: Repository name
        base_model:
          type: string
          title: Base Model
          description: Base model identifier
      additionalProperties: false
      type: object
      required:
        - repo_name
        - base_model
      title: RepoResponse
      description: Repository response model
      example:
        base_model: Qwen/Qwen3-32B
        repo_name: my-project
    RepoTree:
      properties:
        base_model:
          type: string
          title: Base Model
          description: Base model name (e.g., 'Qwen/Qwen3-32B')
        bakes:
          additionalProperties:
            $ref: '#/components/schemas/BakeTreeNode'
          type: object
          title: Bakes
          description: Dictionary of all bakes in the repository
        edges:
          items:
            items:
              type: string
            type: array
          type: array
          title: Edges
          description: 'List of parent-child edges: [source_type, source_name, target_type, target_name]'
      additionalProperties: false
      type: object
      required:
        - base_model
        - bakes
        - edges
      title: RepoTree
      description: |-
        Complete model lineage tree for a repository.

        Provides a full view of all bakes in the repository and their parent-child
        relationships, showing the complete model evolution tree.
    RolloutOutputResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Job status: not_started, running, complete, failed'
        lines:
          anyOf:
            - type: integer
            - type: "null"
          title: Lines
          description: Number of output lines (not applicable for bakes)
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Config
          description: Job config parameters
        error:
          anyOf:
            - type: string
            - type: "null"
          title: Error
          description: Error message if job failed
        job_id:
          anyOf:
            - type: integer
            - type: "null"
          title: Job Id
          description: Coordinator job ID (if job is queued/running)
        progress_percent:
          anyOf:
            - type: number
            - type: "null"
          title: Progress Percent
          description: Job progress percentage (0-100) if job is running
        output:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Output
          description: Paginated output data
        offset:
          type: integer
          minimum: 0.0
          title: Offset
          description: Starting line offset
        limit:
          type: integer
          minimum: 1.0
          title: Limit
          description: Page size
        has_more:
          type: boolean
          title: Has More
          description: Whether more data is available
        total_expected:
          anyOf:
            - type: integer
            - type: "null"
          title: Total Expected
          description: Total expected number of rollouts (num_stimuli * num_traj_per_stimulus). Used for progress calculation.
      additionalProperties: false
      type: object
      required:
        - status
        - output
        - offset
        - limit
        - has_more
      title: RolloutOutputResponse
      description: |-
        Paginated rollout output response

        Returns rollout job status along with paginated output data.
      example:
        config:
          max_concurrency: 50
          max_tokens: 150
          model_name: Qwen/Qwen3-32B
          num_traj_per_stimulus: 5
          temperature: 1.0
        has_more: true
        limit: 100
        lines: 7500
        offset: 0
        output:
          - response: Python is a high-level programming language...
            stimulus_id: 0
            tokens: 42
            trajectory_id: 0
          - response: Python is an interpreted language...
            stimulus_id: 0
            tokens: 38
            trajectory_id: 1
        status: complete
        total_expected: 15000
    RolloutResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Job status: not_started, running, complete, failed'
        lines:
          anyOf:
            - type: integer
            - type: "null"
          title: Lines
          description: Number of output lines (not applicable for bakes)
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Config
          description: Job config parameters
        error:
          anyOf:
            - type: string
            - type: "null"
          title: Error
          description: Error message if job failed
        job_id:
          anyOf:
            - type: integer
            - type: "null"
          title: Job Id
          description: Coordinator job ID (if job is queued/running)
        progress_percent:
          anyOf:
            - type: number
            - type: "null"
          title: Progress Percent
          description: Job progress percentage (0-100) if job is running
        total_expected:
          anyOf:
            - type: integer
            - type: "null"
          title: Total Expected
          description: Total expected number of rollouts (num_stimuli * num_traj_per_stimulus). Used for progress calculation.
      additionalProperties: false
      type: object
      required:
        - status
      title: RolloutResponse
      description: |-
        Rollout job execution status

        Inherits all fields from JobStatus. Separated from StimResponse
        for future extensibility (e.g., model checkpoint paths, inference metrics).
      example:
        config:
          max_concurrency: 50
          max_tokens: 150
          model_name: Qwen/Qwen3-32B
          num_traj_per_stimulus: 5
          temperature: 1.0
        lines: 75
        status: running
        total_expected: 150
    SchedulerConfig:
      properties:
        type:
          anyOf:
            - type: string
            - type: "null"
          title: Type
          description: Scheduler factory type. Defaults to trainer's scheduler_factory_type.
        lr:
          anyOf:
            - type: number
            - type: "null"
          title: Lr
          description: The initial learning rate (deprecated - use optimizer.learning_rate instead). This field will raise an error if set.
      additionalProperties: false
      type: object
      title: SchedulerConfig
      description: Learning rate scheduler configuration
    StimOutputResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Job status: not_started, running, complete, failed'
        lines:
          anyOf:
            - type: integer
            - type: "null"
          title: Lines
          description: Number of output lines (not applicable for bakes)
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Config
          description: Job config parameters
        error:
          anyOf:
            - type: string
            - type: "null"
          title: Error
          description: Error message if job failed
        job_id:
          anyOf:
            - type: integer
            - type: "null"
          title: Job Id
          description: Coordinator job ID (if job is queued/running)
        progress_percent:
          anyOf:
            - type: number
            - type: "null"
          title: Progress Percent
          description: Job progress percentage (0-100) if job is running
        output:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Output
          description: Paginated output data
        offset:
          type: integer
          minimum: 0.0
          title: Offset
          description: Starting line offset
        limit:
          type: integer
          minimum: 1.0
          title: Limit
          description: Page size
        has_more:
          type: boolean
          title: Has More
          description: Whether more data is available
      additionalProperties: false
      type: object
      required:
        - status
        - output
        - offset
        - limit
        - has_more
      title: StimOutputResponse
      description: |-
        Paginated stim output response

        Returns stim job status along with paginated output data.
      example:
        config:
          generators:
            - model: claude-3-5-sonnet-20241022
              numq: 10
              temperature: 1.0
              type: oneshot_qs
          student_prompt: user_prompt_v1
          teacher_prompt: system_prompt_v1
        has_more: true
        limit: 100
        lines: 1500
        offset: 0
        output:
          - question: What is Python?
            stimulus_id: 0
          - question: Explain machine learning
            stimulus_id: 1
        status: complete
    StimResponse:
      properties:
        status:
          type: string
          title: Status
          description: 'Job status: not_started, running, complete, failed'
        lines:
          anyOf:
            - type: integer
            - type: "null"
          title: Lines
          description: Number of output lines (not applicable for bakes)
        config:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Config
          description: Job config parameters
        error:
          anyOf:
            - type: string
            - type: "null"
          title: Error
          description: Error message if job failed
        job_id:
          anyOf:
            - type: integer
            - type: "null"
          title: Job Id
          description: Coordinator job ID (if job is queued/running)
        progress_percent:
          anyOf:
            - type: number
            - type: "null"
          title: Progress Percent
          description: Job progress percentage (0-100) if job is running
      additionalProperties: false
      type: object
      required:
        - status
      title: StimResponse
      description: |-
        Stim job execution status

        Inherits all fields from JobStatus. Separated from RolloutResponse
        for future extensibility (e.g., generator-specific metadata).
      example:
        config:
          generators:
            - model: claude-3-5-sonnet-20241022
              numq: 10
              temperature: 1.0
              type: oneshot_qs
          u: system_prompt_v1
          v: user_prompt_v1
        lines: 150
        status: complete
    TargetConfig:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing target name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/TargetConfigBase-Input'
            - type: "null"
          description: Fields to override from template
      additionalProperties: false
      type: object
      required:
        - template
      title: TargetConfig
      description: Target configuration model
      example:
        overrides:
          generators:
            - model: claude-3-5-sonnet-20241022
              numq: 10
              temperature: 1.0
              type: oneshot_qs
            - dataset: code_contests
              numq: 15
              seed: 42
              type: from_dataset
            - questions:
                - Write a function to reverse a string
                - Implement binary search
                - Create a linked list class
              rollout_with_conditioned: false
              type: hardcoded
            - numq: 5
              seed: 123
              temperature: 0.9
              type: persona
          max_concurrency: 50
          max_tokens: 150
          model_name: Qwen/Qwen3-32B
          num_traj_per_stimulus: 5
          student_prompt: user_prompt_v1
          teacher_prompt: system_prompt_v1
          temperature: 1.0
        template: default
    TargetConfigBase-Input:
      properties:
        teacher_prompt:
          anyOf:
            - type: string
            - type: "null"
          title: Teacher Prompt
          description: Teacher prompt name (unconditioned stimulus)
        student_prompt:
          anyOf:
            - type: string
            - type: "null"
          title: Student Prompt
          description: Student prompt name (conditioned stimulus)
        u:
          anyOf:
            - type: string
            - type: "null"
          title: U
          description: '[DEPRECATED] Use ''teacher_prompt'' instead. Unconditioned stimulus prompt name.'
          deprecated: true
        v:
          anyOf:
            - type: string
            - type: "null"
          title: V
          description: '[DEPRECATED] Use ''student_prompt'' instead. Conditioned stimulus prompt name.'
          deprecated: true
        generators:
          anyOf:
            - items:
                $ref: '#/components/schemas/Generator'
              type: array
            - type: "null"
          title: Generators
          description: Data generation strategies
        model_name:
          anyOf:
            - type: string
            - type: "null"
          title: Model Name
          description: Base model for rollout
        num_traj_per_stimulus:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Num Traj Per Stimulus
          description: Number of trajectories per stimulus
        max_concurrency:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Max Concurrency
          description: Maximum concurrent requests
        temperature:
          anyOf:
            - type: number
              maximum: 2.0
              minimum: 0.0
            - type: "null"
          title: Temperature
          description: Generation temperature (0.0-2.0)
        max_tokens:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Max Tokens
          description: Maximum tokens to generate
        extra_kwargs:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Extra Kwargs
          description: Additional kwargs passed to chat.completions.create()
      additionalProperties: false
      type: object
      title: TargetConfigBase
      description: Target configuration base model
    TargetConfigBase-Output:
      properties:
        teacher_prompt:
          anyOf:
            - type: string
            - type: "null"
          title: Teacher Prompt
          description: Teacher prompt name (unconditioned stimulus)
        student_prompt:
          anyOf:
            - type: string
            - type: "null"
          title: Student Prompt
          description: Student prompt name (conditioned stimulus)
        generators:
          anyOf:
            - items:
                $ref: '#/components/schemas/Generator'
              type: array
            - type: "null"
          title: Generators
          description: Data generation strategies
        model_name:
          anyOf:
            - type: string
            - type: "null"
          title: Model Name
          description: Base model for rollout
        num_traj_per_stimulus:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Num Traj Per Stimulus
          description: Number of trajectories per stimulus
        max_concurrency:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Max Concurrency
          description: Maximum concurrent requests
        temperature:
          anyOf:
            - type: number
              maximum: 2.0
              minimum: 0.0
            - type: "null"
          title: Temperature
          description: Generation temperature (0.0-2.0)
        max_tokens:
          anyOf:
            - type: integer
              minimum: 1.0
            - type: "null"
          title: Max Tokens
          description: Maximum tokens to generate
        extra_kwargs:
          anyOf:
            - additionalProperties: true
              type: object
            - type: "null"
          title: Extra Kwargs
          description: Additional kwargs passed to chat.completions.create()
      additionalProperties: false
      type: object
      title: TargetConfigBase
      description: Target configuration base model
    TargetConfigWithName:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing target name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/TargetConfigBase-Input'
            - type: "null"
          description: Fields to override from template
        target_name:
          type: string
          title: Target Name
          description: Target name
      additionalProperties: false
      type: object
      required:
        - template
        - target_name
      title: TargetConfigWithName
      description: Target configuration with explicit name for batch operations
      example:
        overrides:
          generators:
            - model: claude-3-5-sonnet-20241022
              numq: 10
              temperature: 1.0
              type: oneshot_qs
            - dataset: code_contests
              numq: 15
              seed: 42
              type: from_dataset
            - questions:
                - Write a function to reverse a string
                - Implement binary search
                - Create a linked list class
              rollout_with_conditioned: false
              type: hardcoded
            - numq: 5
              seed: 123
              temperature: 0.9
              type: persona
          max_concurrency: 50
          max_tokens: 150
          model_name: Qwen/Qwen3-32B
          num_traj_per_stimulus: 5
          student_prompt: user_prompt_v1
          teacher_prompt: system_prompt_v1
          temperature: 1.0
        template: default
    TargetCreate:
      properties:
        template:
          type: string
          title: Template
          description: 'Template: ''default'' or existing target name'
        overrides:
          anyOf:
            - $ref: '#/components/schemas/TargetConfigBase-Input'
            - type: "null"
          description: Fields to override from template
        target_name:
          type: string
          title: Target Name
          description: Name of the target
      additionalProperties: false
      type: object
      required:
        - template
        - target_name
      title: TargetCreate
      description: Target create model (includes target_name in body)
      example:
        overrides:
          generators:
            - model: claude-3-5-sonnet-20241022
              numq: 10
              temperature: 1.0
              type: oneshot_qs
            - dataset: code_contests
              numq: 15
              seed: 42
              type: from_dataset
            - questions:
                - Write a function to reverse a string
                - Implement binary search
                - Create a linked list class
              rollout_with_conditioned: false
              type: hardcoded
            - numq: 5
              seed: 123
              temperature: 0.9
              type: persona
          max_concurrency: 50
          max_tokens: 150
          model_name: Qwen/Qwen3-32B
          num_traj_per_stimulus: 5
          student_prompt: user_prompt_v1
          teacher_prompt: system_prompt_v1
          temperature: 1.0
        template: default
    TargetList:
      properties:
        targets:
          items:
            type: string
          type: array
          title: Targets
          description: List of target names
      additionalProperties: false
      type: object
      required:
        - targets
      title: TargetList
      description: Target list model
      example:
        targets:
          - target_alpha
          - target_beta
          - target_gamma
    TargetResponse:
      properties:
        target_name:
          type: string
          title: Target Name
        config:
          $ref: '#/components/schemas/TargetConfigBase-Output'
      additionalProperties: false
      type: object
      required:
        - target_name
        - config
      title: TargetResponse
      description: Target response
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    WandbConfig:
      properties:
        enable:
          anyOf:
            - type: boolean
            - type: "null"
          title: Enable
          description: Enable wandb logging
        project:
          anyOf:
            - type: string
            - type: "null"
          title: Project
          description: Wandb project name
        name:
          anyOf:
            - type: string
            - type: "null"
          title: Name
          description: Run name
        entity:
          anyOf:
            - type: string
            - type: "null"
          title: Entity
          description: Wandb entity/team
      additionalProperties: false
      type: object
      title: WandbConfig
      description: Weights & Biases configuration
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
tags:
  - name: repositories
    description: Repository management operations
  - name: prompts
    description: Prompt management within repositories
  - name: targets
    description: Training target configuration and management
  - name: bakes
    description: Bake management operations
  - name: recipes
    description: Dependency graph and recreation plan operations
  - name: health
    description: System health and status