Skip to main content
POST
cURL

Authorizations

Authorization
string
header
default:Bearer {API_ACCESS_TOKEN}
required

CoreWeave API access token sent as a bearer token.

Body

application/json

Request for CreateHotLoad

deploymentId
string
required

The ID of the deployment to hot-load

identity
string
required

The identity of the target snapshot within the deployment. Must be a single path segment. Identity names a snapshot, not a hot-load operation: the same identity may be hot-loaded repeatedly (retry, rollback, reconvergence).

type
integer<enum>
required

The type of the target snapshot

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 CodeAlreadyExists; an ID that is unavailable for any other reason fails with CodeInvalidArgument.

incrementalSnapshotMetadata
object

Delta metadata, required when type is SNAPSHOT_TYPE_INCREMENTAL

promptCachePolicy
integer<enum>

Prompt cache handling once the swap completes. Defaults to PROMPT_CACHE_POLICY_PRESERVE when unspecified.

Response

OK

Response for CreateHotLoad

hotLoad
object

The created hot-load

Last modified on September 15, 2026