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

# Resume Dedicated Run

> Resume a PAUSED dedicated run as a new run from its checkpoint.

The new run reuses the paused run's config, team, name, mode, image and
GPU type, attaches its volume and starts from its last checkpoint.
`gpuType` and `imageTag` override the stored ones; secrets are sent
again because they are dropped once a run deploys.



## OpenAPI

````yaml https://api.primeintellect.ai/openapi.json post /api/v1/training/runs/{run_id}/resume
openapi: 3.1.0
info:
  title: PI API
  version: 0.1.0
servers:
  - url: https://api.primeintellect.ai
security: []
paths:
  /api/v1/training/runs/{run_id}/resume:
    post:
      tags:
        - training
      summary: Resume Dedicated Run
      description: |-
        Resume a PAUSED dedicated run as a new run from its checkpoint.

        The new run reuses the paused run's config, team, name, mode, image and
        GPU type, attaches its volume and starts from its last checkpoint.
        `gpuType` and `imageTag` override the stored ones; secrets are sent
        again because they are dropped once a run deploys.
      operationId: resume_dedicated_run_api_v1_training_runs__run_id__resume_post
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            title: Run Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResumeDedicatedRunRequest'
      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:
    ResumeDedicatedRunRequest:
      properties:
        wandbApiKey:
          anyOf:
            - type: string
            - type: 'null'
          title: Wandbapikey
          description: >-
            W&B key. On the PENDING fast-path it's materialised straight into
            the run's k8s Secret. On the QUEUED path it's stashed AES-encrypted
            on the RFTRun row so the drainer can rebuild the same Secret at
            promotion time without re-prompting.
        hfToken:
          anyOf:
            - type: string
            - type: 'null'
          title: Hftoken
          description: >-
            HF token for gated/private model downloads. Same storage rules as
            wandbApiKey above.
        secrets:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
          title: Secrets
          description: >-
            Arbitrary env-var secrets projected into trainer / inference /
            orchestrator / env-server pods (parity with the LoRA path). Keys
            must be uppercase POSIX env-var names (e.g. 'OPENAI_API_KEY');
            WANDB_API_KEY / HF_TOKEN / PRIME_API_KEY are reserved — use the
            dedicated fields for those. Materialised into the per-run k8s
            Secret. Held encrypted on the RFTRun row only for the sync ->
            dispatch-task hop, then cleared once the run deploys (or on stop /
            delete / rollback); never returned by any read endpoint.
        gpuType:
          anyOf:
            - type: string
            - type: 'null'
          title: Gputype
          description: GPU type to resume on. Omit for the paused run's type.
        imageTag:
          anyOf:
            - type: string
            - type: 'null'
          title: Imagetag
          description: prime-rl image tag to resume with. Omit for the paused run's image.
      type: object
      title: ResumeDedicatedRunRequest
      description: |-
        Wire payload for resuming a PAUSED dedicated run. Everything else
        comes from the paused run; secrets are sent again because the platform
        drops them once a run deploys.
    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.
        onDemand:
          type: boolean
          title: Ondemand
          description: >-
            True when this run landed on billed shared capacity rather than a
            cluster the caller holds an allocation on. Derived at dispatch, not
            requested.
          default: false
        gpuType:
          anyOf:
            - type: string
            - type: 'null'
          title: Gputype
          description: GPU type the run was placed on.
        pricePerGpuHour:
          anyOf:
            - type: number
            - type: 'null'
          title: Pricepergpuhour
          description: >-
            USD per GPU-hour this run will be charged, discount applied and
            frozen for its lifetime. NULL on reserved capacity, which bills
            nothing per-hour. Echoed so a caller who named no gpuType sees the
            rate now rather than at invoice time.
        estimatedCostPerHour:
          anyOf:
            - type: number
            - type: 'null'
          title: Estimatedcostperhour
          description: price_per_gpu_hour multiplied by the run's GPU count.
        isBeta:
          type: boolean
          title: Isbeta
          description: >-
            True when this run used on-demand capacity, which is in beta. False
            on the reserved path, which is GA.
          default: false
      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

````

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