PRprimeintellect
training

Resume Dedicated Run

Changed on

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.

post/api/v1/training/runs/{run_id}/resume

Request

  • Base URL
    https://api.primeintellect.ai
  • Auth
    HTTP bearer

Path parameters

run_idstring required

Request body

wandbApiKeystring nullable

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.

hfTokenstring nullable

HF token for gated/private model downloads. Same storage rules as wandbApiKey above.

secretsobject nullable

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.

gpuTypestring nullable

GPU type to resume on. Omit for the paused run's type.

imageTagstring nullable

prime-rl image tag to resume with. Omit for the paused run's image.

Response

Successful Response

runIdstring required
jobIdstring required
tokenValuestring required

PRIME_API_KEY for this run. Returned once — the platform stores only the token id.

onDemandboolean

True when this run landed on billed shared capacity rather than a cluster the caller holds an allocation on. Derived at dispatch, not requested.

gpuTypestring nullable

GPU type the run was placed on.

pricePerGpuHournumber nullable

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.

estimatedCostPerHournumber nullable

price_per_gpu_hour multiplied by the run's GPU count.

isBetaboolean

True when this run used on-demand capacity, which is in beta. False on the reserved path, which is GA.

Changes