Theme Assets
Themes
Theme Assets
Manage theme assets
GET
Theme Assets
Theme Assets
Manage files within a theme including templates, sections, snippets, and static assets. All endpoints use the standard response envelope (status, state, message,
data).
List Assets
Returns a list of all asset files in a theme. Assets are returned as metadata only — the file body is not included in this response.Request
Path Parameters
The theme ID
Response
The asset array is nested underdata.assets. Each asset object describes one
file.
Array of asset objects
Create/Update Asset
Create a new asset or update an existing one by writing its text content.Request
Body Parameters
Asset path (e.g.,
snippets/custom-banner.aqua, assets/custom.css)Asset text content
Response
The created/updated asset is nested underdata.asset.
Delete Asset
Delete an asset file from the theme.Request
Query Parameters
The asset key/path to delete
Response
Delete returns a message envelope (nodata payload).
Asset Paths
Common asset paths:| Path Pattern | Description |
|---|---|
layout/*.aqua | Layout templates |
templates/*.json | Page templates |
sections/*.aqua | Section files |
snippets/*.aqua | Snippet files |
assets/* | Static files (CSS, JS, images) |
config/settings_schema.json | Theme settings schema |
config/settings_data.json | Theme settings values |
locales/*.json | Translation files |
Error Response
| Status | Description |
|---|---|
401 | Invalid or missing access token |
403 | App doesn’t have the required read_themes / write_themes scope |
404 | Theme does not exist |
400 | Invalid asset key or content |