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

# Create Dedicated Run

> Dispatch a dedicated full-FT prime-rl run on a registered PrimeCluster.



## OpenAPI

````yaml https://api.primeintellect.ai/openapi.json post /api/v1/training/runs
openapi: 3.1.0
info:
  title: PI API
  version: 0.1.0
servers:
  - url: https://api.primeintellect.ai
security: []
paths:
  /api/v1/training/runs:
    post:
      tags:
        - training
      summary: Create Dedicated Run
      description: Dispatch a dedicated full-FT prime-rl run on a registered PrimeCluster.
      operationId: create_dedicated_run_api_v1_training_runs_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateDedicatedRunRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateDedicatedRunResponse'
        '401':
          description: Authorization failed
        '422':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    CreateDedicatedRunRequest:
      properties:
        config:
          type: object
          title: Config
          description: >-
            Full prime-rl-style TOML, parsed to a dict. Same shape as
            `prime-rl/examples/*/rl.toml`; the platform splits it into trainer /
            orchestrator / inference subconfigs and bakes each into the
            corresponding pod's startup command.
        imageTag:
          type: string
          title: Imagetag
          description: prime-rl container image tag
          default: main
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: Optional human-readable run name
        teamId:
          anyOf:
            - type: string
            - type: 'null'
          title: Teamid
          description: Owning team (defaults to caller's user)
        wandbApiKey:
          anyOf:
            - type: string
            - type: 'null'
          title: Wandbapikey
          description: >-
            W&B key. Materialised into the run's k8s Secret only — never stored
            on the RFTRun row.
        hfToken:
          anyOf:
            - type: string
            - type: 'null'
          title: Hftoken
          description: HF token for gated/private model downloads.
      type: object
      required:
        - config
      title: CreateDedicatedRunRequest
    CreateDedicatedRunResponse:
      properties:
        runId:
          type: string
          title: Runid
        jobId:
          type: string
          title: Jobid
        tokenValue:
          type: string
          title: Tokenvalue
          description: >-
            PRIME_API_KEY for this run. Returned once — the platform stores only
            the token id.
      type: object
      required:
        - runId
        - jobId
        - tokenValue
      title: CreateDedicatedRunResponse
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          title: Errors
      type: object
      required:
        - errors
      title: ErrorResponse
    ErrorDetail:
      properties:
        param:
          type: string
          title: Param
        details:
          type: string
          title: Details
      type: object
      required:
        - param
        - details
      title: ErrorDetail
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````