Skip to main content
PUT
Replace CVM annotations

Path Parameters

cvm_id
string
required

Body

application/json

Full replacement of a CVM's annotations.

annotations
Annotations · object
required

Opaque key/value metadata for host-side tooling. The dstack VMM stores it with the VM; it is not passed to the guest, not measured, and not part of the compose hash, so it is host configuration that attestation does not cover. Do not rely on it for security. Replaces every annotation; an empty object clears them. Keys must not be empty.

Example:

Response

The annotations now stored

The annotations the node's VMM currently stores for one CVM.

annotations
Annotations · object
required

Opaque key/value metadata for host-side tooling. The dstack VMM stores it with the VM; it is not passed to the guest, not measured, and not part of the compose hash, so it is host configuration that attestation does not cover. Do not rely on it for security.