Skip to main content
POST
Create hot-load
The target checkpoint is named by identity, a single path segment beneath the deployment’s configured bucket and path prefix. The bucket and prefix come from the deployment, so this request carries no storage location. A deployment runs one hot-load at a time. Creating a second while one is unfinished fails, and the same interlock blocks deployment updates while a hot-load is running. Delta checkpoints require incrementalSnapshotMetadata, and their resolved chain holds at most 128 deltas before a full checkpoint is needed to reset it.
Example request

承認

Authorization
string
header
デフォルト:Bearer {API_ACCESS_TOKEN}
必須

CoreWeave API access token sent as a bearer token.

ボディ

application/json

Request for CreateHotLoad

deploymentId
string
必須

The ID of the deployment to hot-load

identity
string
必須

The identity of the target snapshot within the deployment. Must be a single path segment. Multiple hot-load operations may target the same snapshot identity.

type
enum<string>
必須

The type of the target snapshot. SNAPSHOT_TYPE_FULL carries a complete set of model weights and starts a new snapshot chain. SNAPSHOT_TYPE_INCREMENTAL is a delta against an earlier snapshot and requires incrementalSnapshotMetadata. This field is required; the zero value is rejected.

利用可能なオプション:
SNAPSHOT_TYPE_FULL,
SNAPSHOT_TYPE_INCREMENTAL
hotLoadId
string

The ID to use for the hot-load, which becomes its permanent identifier. Must be a UUID. If omitted, one is generated. Creating a second hot-load with an ID that already exists in the caller's organization fails with ALREADY_EXISTS; an ID that is unavailable for any other reason fails with INVALID_ARGUMENT.

incrementalSnapshotMetadata
object

Delta metadata, required when type is SNAPSHOT_TYPE_INCREMENTAL

promptCachePolicy
enum<string>

How the prompt cache is handled once the swap completes. PROMPT_CACHE_POLICY_RESET_ALL prevents reuse of any entry computed before the swap. PROMPT_CACHE_POLICY_PRESERVE allows reuse, knowingly stale under the new weights. The policy applies to requests admitted after the transition, not to requests already in flight. Omit the field rather than sending the zero value; omitting it applies PROMPT_CACHE_POLICY_PRESERVE.

利用可能なオプション:
PROMPT_CACHE_POLICY_RESET_ALL,
PROMPT_CACHE_POLICY_PRESERVE

レスポンス

OK

Response for CreateHotLoad

hotLoad
object

The created hot-load

最終更新日 2026年10月1日