🔒
Requires read_themes access 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:

Request Parameters

📘
Public Request Parameters

Parameter	Type	Required	Description	Example
`theme_id`	`string`	Yes	Unique identifier of the theme	`"theme_123456789"`

Response Explanation

📘
Public Response Parameters

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

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

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message