PHphala
Apps

Redeploy app from a specific revision

Changed on

Redeploy a CVM to a specific revision. If the app has exactly one CVM, it will be redeployed by default. If the app has multiple CVMs, you must specify target vm_uuids in request body. Does not change encrypted env unless encrypted_env is supplied. A mismatch between allowed_envs and the last env write is rejected unless encrypted_env is supplied or allow_env_mismatch is true. This schedules async CVM update task(s).

post/api/v1/apps/{app_id}/revisions/{revision_id}/redeploy

Request

Path parameters

app_idstring required

Hex app identifier

revision_idstring required

External AppRevisionId (prefix 'rev_'). Fully prefixed string required; bare payloads and raw integers are rejected.

Example:rev_0123abcd

Query parameters

transaction_hashstring nullable

Optional transaction hash proving on-chain compose hash registration

Request body

vm_uuidsstring[] nullable
encrypted_envstring nullable

Optional encrypted env blob. When omitted, rollback keeps each CVM's current encrypted env. Supply a blob only to deliberately roll env back.

allow_env_mismatchboolean

Continue even when this revision's allowed_envs differ from the last env write. Ignored when encrypted_env is supplied.

Response

Activation initiated

unknown required

Changes

  • c71a8dc90391Revision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the non-success response with the status