🔒
Requires write_themes access scope. More access scope

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

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Parameter	Type	Required	Example	Description
`theme_id`	string	Yes	`1500021b-88ed-4750-bbc5-97ec98351dc0`	Theme's unique identifier.

Query Parameters

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'`

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Successful Response

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

Version Object

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

Error Response

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

API Structure Overview

200OK