CVMs

Trigger compose file update

Applies a provisioned compose file update. Requires compose_hash from provision endpoint. Restarts the CVM with new configuration.

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

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/compose_file/patch.ts
A function with typed inputs. Its response is checked against the schema.

cvm_idstring required

compose_hashstring required

Hash from provision response

encrypted_envstring nullable

New encrypted env blob (hex)

env_keysstring[] nullable

Allowed env var names

update_env_varsboolean nullable

Update allowed_envs list

Update initiated

unknown required

Nov 7, 2026c71a8dc90391 Revision changes
- info
  added the non-success response with the status