Skip to main content
GET
/
api
/
v1
/
apps
/
{app_id}
/
revisions
/
{revision_id}
Get revision detail
curl --request GET \
  --url https://cloud-api.phala.com/api/v1/apps/{app_id}/revisions/{revision_id}
{
  "revision_id": "<string>",
  "app_id": "<string>",
  "vm_uuid": "<string>",
  "compose_hash": "<string>",
  "compose_file": {},
  "encrypted_env": "<string>",
  "user_config": "<string>",
  "created_at": "<string>",
  "trace_id": "<string>",
  "operation_type": "<string>",
  "triggered_by": {
    "object_type": "user",
    "id": "usr_0123abcd",
    "username": "<string>",
    "avatar_url": "<string>"
  },
  "cvm": {
    "vm_uuid": "<string>",
    "object_type": "cvm",
    "app_id": "<string>",
    "name": "<string>"
  },
  "workspace": {
    "id": "<string>",
    "name": "<string>",
    "object_type": "workspace",
    "slug": "<string>",
    "avatar_url": "<string>"
  }
}

Path Parameters

app_id
string
required

Hex app identifier

revision_id
string
required

Query Parameters

raw_compose_file
boolean
default:false

Return compose_file as string instead of dict

Response

Revision detail with compose file

Full revision detail with configuration data.

revision_id
string
required

Revision record identifier (hashid of snowflake_id)

app_id
string
required

Hex app identifier

vm_uuid
string
required

CVM UUID

compose_hash
string
required

SHA-256 hash of compose file

compose_file
required

Docker compose content (dict or raw string)

encrypted_env
string
required

Hex-encoded encrypted environment variables

user_config
string
required

JSON user configuration string

created_at
string
required

Revision timestamp (ISO 8601)

trace_id
string | null
required

Request trace ID for debugging

operation_type
string
required

Operation: deploy, update, restart, etc.

triggered_by
UserRef · object

User who triggered the operation

cvm
CvmRef · object

CVM reference

workspace
WorkspaceRef · object

Workspace reference