Create hot-load
Load a full or delta checkpoint into a running deployment’s replicas.
- The API server is
https://api.coreweave.com. - Replace
{API_ACCESS_TOKEN}with your CoreWeave API access token. - For required permissions, see IAM Access Policies.
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.
承認
CoreWeave API access token sent as a bearer token.
ボディ
Request for CreateHotLoad
The ID of the deployment to hot-load
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.
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 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.
Delta metadata, required when type is SNAPSHOT_TYPE_INCREMENTAL
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
The created hot-load