Submit an immutable checkpoint hot-load to a deployment configured with hot_load. Creation returns after acceptance; refresh observes progress. Destroy cancels an active operation without waiting for replica updates to stop or rolling back weights. If the API does not implement cancellation, destroy warns and removes the operation from state while it keeps running. Terminal operation history remains on the server.
Example usage
Schema
Required
deployment_id (String) UUID of the target deployment.
identity (String) Snapshot identity within the deployment, a single path segment.
type (String) Snapshot type: SNAPSHOT_TYPE_FULL or SNAPSHOT_TYPE_INCREMENTAL.
Optional
incremental_snapshot_metadata (Attributes) Required for incremental snapshots; omitted for full snapshots. (see below for nested schema)
prompt_cache_policy (String) Prompt cache handling after the swap: PROMPT_CACHE_POLICY_PRESERVE (default) or PROMPT_CACHE_POLICY_RESET_ALL.
Read-Only
canceled_at (String) Cancellation time in RFC3339, or null.
conditions (Attributes List) Detailed operation conditions and error messages. (see below for nested schema)
created_at (String) Creation time in RFC3339.
finished_at (String) Terminal time in RFC3339, or null while unfinished.
id (String) Hot-load operation UUID.
organization_id (String) Organization owning the operation.
snapshot_chain (Attributes List) Resolved snapshot chain, oldest first. (see below for nested schema)
state (String) Aggregate HotLoad state. Acceptance does not imply completion.
updated_at (String) Last update time in RFC3339.
Required:
checksum_format (String) Snapshot integrity checksum: CHECKSUM_FORMAT_ADLER32.
compression_format (String) Incremental snapshot compression: COMPRESSION_FORMAT_ZSTD.
previous_snapshot_identity (String) Identity of the predecessor snapshot.
Nested Schema for conditions
Read-Only:
last_update_time (String) Last condition update in RFC3339.
message (String) Condition details.
reason (String) Machine-readable condition reason.
status (String) Condition status.
type (String) Condition type.
Nested Schema for snapshot_chain
Read-Only:
checksum_format (String) Checksum format.
compression_format (String) Compression format.
hot_load_id (String) Operation that introduced this snapshot.
identity (String) Snapshot identity.
type (String) Snapshot type.
Import
Import is supported using the following syntax:
Last modified on November 5, 2026