CVMs

Update environment variables

Updates encrypted environment variables. If env_keys changes for contract-owned KMS, requires two-phase flow with on-chain hash registration.

patch/api/v1/cvms/{cvm_id}/envs

Request

Base URL
https://cloud-api.phala.com
Auth
none declared
TypeScript
https://skmtc.dev/phala/apis/phala-cloud-api/docs/api/v1/cvms/:cvm_id/envs/patch.ts
A function with typed inputs. Its response is checked against the schema.

cvm_idstring required

encrypted_envstring required

Encrypted env blob as hex string

env_keysstring[] nullable

Allowed env var names. Changes trigger verification for contract-owned KMS.

compose_hashstring nullable

Hash from Phase 1 response (Phase 2 only)

transaction_hashstring nullable

Transaction hash proving on-chain registration (Phase 2 only)

Update initiated, returns correlation_id and allowed_envs_changed flag

unknown required

No recorded changes to this operation across all 3 revisions of this API.