Skip to main content
GET
/
api
/
v1
/
apps
/
{app_id}
/
revisions
List app revisions
curl --request GET \
  --url https://cloud-api.phala.com/api/v1/apps/{app_id}/revisions
{
  "revisions": [
    {
      "revision_id": "<string>",
      "app_id": "<string>",
      "vm_uuid": "<string>",
      "compose_hash": "<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>"
      }
    }
  ],
  "total": 123,
  "page": 123,
  "page_size": 123,
  "total_pages": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.phala.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
app_id
string
required

Hex app identifier

Query Parameters

​
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
​
page_size
integer
default:50

Items per page

Required range: 1 <= x <= 1000

Response

Paginated revision list

Paginated revision list.

​
revisions
AppRevisionResponse · object[]
required

Revision records

​
total
integer
required

Total revision count

​
page
integer
required

Current page number

​
page_size
integer
required

Items per page

​
total_pages
integer
required

Total page count