Skip to main content
POST
Create Dedicated Run

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
config
Config · object
required

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
string
default:main

prime-rl container image tag

name
string | null

Optional human-readable run name

teamId
string | null

Owning team (defaults to caller's user)

wandbApiKey
string | null

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
string | null

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

gpuType
string | null

Optional GPU type constraint (e.g. 'H200_141GB', 'B200_180GB'). When set, dispatch is restricted to PrimeClusters whose gpuType matches. When omitted, the picker chooses the oldest eligible cluster with no type preference.

Response

Successful Response

runId
string
required
jobId
string
required
tokenValue
string
required

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