---
title: "Pre-launch script upgrade status"
method: GET
path: "/api/v1/cvms/{cvm_id}/pre-launch-script/upgrade-status"
tags: ["CVMs"]
---

# Pre-launch script upgrade status

`GET /api/v1/cvms/{cvm_id}/pre-launch-script/upgrade-status`

## Request

- Base URL: `https://cloud-api.phala.com`
- URL: `https://cloud-api.phala.com/api/v1/cvms/{cvm_id}/pre-launch-script/upgrade-status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/phala/apis/phala-cloud-api/docs/api/v1/cvms/:cvm_id/pre-launch-script/upgrade-status/get.ts> (a function with typed inputs; its response is checked against the schema)

Reports whether the CVM is running an unmodified official pre-launch script and whether a newer official version is available. Returns can_upgrade=true only when the current hash matches a historical official version that is not the latest.

## Path parameters

- `cvm_id` string, required

## Response `200`

Successful Response

- PreLaunchScriptUpgradeStatus
  - `current_hash` string, nullable, required
  - `latest_official_hash` string, required
  - `is_official` boolean, required
  - `is_latest` boolean, required
  - `can_upgrade` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-07** `c71a8dc90391`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/phala/apis/phala-cloud-api/changes/api/v1/cvms/:cvm_id/pre-launch-script/upgrade-status/get.md)

---

[API](https://skmtc.dev/phala/apis/phala-cloud-api.md) - [All operations](https://skmtc.dev/phala/apis/phala-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/phala/apis/phala-cloud-api/revisions/c71a8dc90391?raw)