🔒
The List Theme File Versions API allows developers to fetch the version history of a specific documentation file within a theme query by type and location.
This API is especially useful for:
- Tracking changes to critical theme files over time
- Rolling back to previous versions if needed
📘
| Parameter | Type | Required | Example | Description |
|---|
theme_id | string | Yes | 1500021b-88ed-4750-bbc5-97ec98351dc0 | Theme's unique identifier. |
| Parameter | Type | Required | Description | Example |
|---|
type | string | No | The type of file to retrieve versions for (e.g., 'assets', 'layout', 'template'). Defaults to 'layout' | 'template' |
location | string | No | The path location of the file within the theme. Defaults to 'theme.liquid' | 'sections/header.liquid' |
📘
| Parameter | Type | Example | Description |
|---|
code | string | "200" | The response status code |
message | string | "Success" | The response message |
data.versions | array | [...] | Array of version objects containing file version details |
| Parameter | Type | Example | Description |
|---|
id | string | "version_123456789" | Unique identifier for this version |
version | string | "1.2.3" | Version number |
created_at | string | "2025-06-15T10:30:00Z" | Timestamp when this version was created |
theme_id | string | "theme_123456789" | ID of the theme this version belongs to |
type | string | "layout" | Type of the file |
location | string | "theme.liquid" | Path location of the file |
updated_at | string | "2025-06-15T10:30:00Z" | Timestamp when this version was last updated |
| Field | Type | Example | Description |
|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |
