---
title: "List compose hash history"
method: GET
path: "/api/v1/apps/{app_id}/compose-hash-history"
tags: ["user", "Apps"]
---

# List compose hash history

`GET /api/v1/apps/{app_id}/compose-hash-history`

## Request

- Base URL: `https://cloud-api.phala.com`
- URL: `https://cloud-api.phala.com/api/v1/apps/{app_id}/compose-hash-history`
- Auth: OAuth 2
  - Authorization code
  - Token URL: `token`
- TypeScript: <https://skmtc.dev/phala/apis/phala-cloud-api/docs/api/v1/apps/:app_id/compose-hash-history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns every ClickHouse app_revisions row for the app in write order, including repeated hashes. Any authenticated caller can read it, whether or not they belong to the workspace that owns the app. Callers stop when a page has fewer than page_size items.

## Path parameters

- `app_id` string, required: Hex app identifier

## Query parameters

- `page` integer: Page number (1-indexed)
- `page_size` integer: Items per page

## Response `200`

Compose hash history in write order

- ComposeHashHistoryItem[]
  - `time` string, required: ClickHouse write time (UTC ISO 8601)
  - `compose_hash` string, required: SHA-256 hash of compose file

## Other responses

- `401`: Not authenticated
- `404`: App not found
- `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/apps/:app_id/compose-hash-history/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)