get
https://{subdomain}.myshoplaza.com/openapi/2025-06/themes//doc/version-records
Requiresread_themesaccess scope. More access scope
The List Theme File Versions API allows developers to retrieve all versions of a theme file, including its metadata and content.
This API is especially useful for:
- Reviewing historical versions of a theme files
- Reverting to previous file versions
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
theme_id | string | Yes | Unique identifier of the theme | "theme_123456789" |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Example | Description |
|---|---|---|---|
code | string | "success" | Status code of the response |
message | string | "OK" | Descriptive message of the response |
data.versions | array of object | [{...}] | Detailed version object |
Version Object
| Parameter | Type | Example | Description |
|---|---|---|---|
id | string | "version_987654321" | Unique version identifier |
version | string | "2" | Version number |
created_at | string | "2025-01-01T00:00:00Z" | Timestamp when version was created |
theme_id | string | "theme_123456789" | Parent theme ID |
type | string | "template" | File type (layout/template/section/etc.) |
location | string | "templates/product.liquid" | Relative path to the file |
updated_at | string | "2025-01-01T00:05:00Z" | Timestamp when version was last updated |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |