v1

latestOpenAPI 3.1.02026-07-26106201349.6 KB
Gateway

Resume Rlor Trainer Job

post/v1/accounts/{account_id}/rlorTrainerJobs/{rlor_trainer_job_id}:resume

Path parameters

account_idstring required

The Account Id

rlor_trainer_job_idstring required

The Rlor Trainer Job Id

Request body

GatewayGatewayResumeRlorTrainerJobBody required

Response

A successful response.

namestring
displayNamestring
createTimestring date-time
completedTimestring date-time
datasetstring

The name of the dataset used for training.

evaluationDatasetstring

The name of a separate dataset to use for evaluation.

evalAutoCarveoutboolean

Whether to auto-carve the dataset for eval.

state'JOB_STATE_UNSPECIFIED' | 'JOB_STATE_CREATING' | 'JOB_STATE_RUNNING' | 'JOB_STATE_COMPLETED' | 'JOB_STATE_FAILED' | 'JOB_STATE_CANCELLED' | 'JOB_STATE_DELETING' | 'JOB_STATE_WRITING_RESULTS' | 'JOB_STATE_VALIDATING' | 'JOB_STATE_DELETING_CLEANING_UP' | 'JOB_STATE_PENDING' | 'JOB_STATE_EXPIRED' | 'JOB_STATE_RE_QUEUEING' | 'JOB_STATE_CREATING_INPUT_DATASET' | 'JOB_STATE_IDLE' | 'JOB_STATE_CANCELLING' | 'JOB_STATE_EARLY_STOPPED' | 'JOB_STATE_PAUSED' | 'JOB_STATE_DELETED' | 'JOB_STATE_ARCHIVED'

JobState represents the state an asynchronous job can be in.

  • JOB_STATE_PAUSED: Job is paused, typically due to account suspension or manual intervention.
  • JOB_STATE_DELETED: Job has been deleted.
  • JOB_STATE_ARCHIVED: User-facing state for jobs whose row is retained post-delete (e.g. RLOR trainers within the checkpoint retention window). The internal row is still in JOB_STATE_DELETED; the gateway translates it to ARCHIVED on public responses.
createdBystring

The email address of the user who initiated this fine-tuning job.

rewardWeightsstring[]

A list of reward metrics to use for training in format of "<reward_name>=<weight>".

keepAliveboolean
rolloutDeploymentNamestring

Rollout deployment name associated with this RLOR trainer job. This is optional. If not set, trainer will not trigger weight sync to rollout engine.

nodeCountinteger

The number of nodes to use for the fine-tuning job. If not specified, the default is 1.

acceleratorSecondsobject

Accelerator seconds used by the job, keyed by accelerator type (e.g., "NVIDIA_H100_80GB"). Updated periodically.

serviceModeboolean
directRouteHandlestring
hotLoadDeploymentIdstring

The deployment ID used for hot loading. When set, checkpoints are saved to this deployment's hot load bucket, enabling weight swaps on inference. Only valid for service-mode or keep-alive jobs.

purpose'PURPOSE_UNSPECIFIED' | 'PURPOSE_PILOT'

Scheduling purpose for training jobs and deployments.

forwardOnlyboolean

When true, run the trainer in forward-only mode (no backward/optimizer). Used for reference models in GRPO that only need forward passes.

managedBystring

For managed service use only. Users do not need to set this field.

trainerReplicaCountinteger

Data-parallel replica count for service-mode trainers. When unset or 0, defaults to 1. Values greater than 1 launch replicated HSDP training.

inactivityTimeoutstring

Trainer inactivity timeout. The trainer reports tracked activity, including trainer API operations and active-session heartbeats. If no tracked activity is observed for this duration, the trainer is automatically stopped. When unset or 0, defaults to 60 minutes. Set disable_inactivity_cleanup to true to disable automatic cleanup. GPU usage continues to accrue while the trainer is running.

disableInactivityCleanupboolean

Disable trainer inactivity cleanup. When true, the trainer is not automatically stopped due to inactivity. GPU usage continues to accrue while the trainer is running.

encryptionState'ENCRYPTION_STATE_UNSPECIFIED' | 'ENCRYPTION_STATE_PLAINTEXT' | 'ENCRYPTION_STATE_CMEK'

EncryptionState is the authoritative, per-resource CMEK marker: the single source of truth for whether a resource's customer-data artifacts are encrypted. It is stamped at resource creation from the owning account's CMEK config and is immutable for the resource's life, so a resource always reads back with the state it was created under regardless of the account's current flag. The encrypt-on-write / decrypt-on-read decision for the resource's data keys off this field.

  • ENCRYPTION_STATE_UNSPECIFIED: Unstamped/legacy rows that predate CMEK. Treated as PLAINTEXT.
  • ENCRYPTION_STATE_PLAINTEXT: Customer-data artifacts are stored as plaintext (Fireworks-owned, no CMEK).
  • ENCRYPTION_STATE_CMEK: Customer-data artifacts are CMEK-encrypted; reads MUST decrypt (fail-closed).