Skip to main content
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

theme_id
string
required
The theme ID

Response

The asset array is nested under data.assets. Each asset object describes one file.
data.assets
array
Array of asset objects

Create/Update Asset

Create a new asset or update an existing one by writing its text content.

Request

Body Parameters

key
string
required
Asset path (e.g., snippets/custom-banner.aqua, assets/custom.css)
value
string
required
Asset text content

Response

The created/updated asset is nested under data.asset.

Delete Asset

Delete an asset file from the theme.

Request

Query Parameters

key
string
required
The asset key/path to delete

Response

Delete returns a message envelope (no data payload).

Asset Paths

Common asset paths:
Path PatternDescription
layout/*.aquaLayout templates
templates/*.jsonPage templates
sections/*.aquaSection files
snippets/*.aquaSnippet files
assets/*Static files (CSS, JS, images)
config/settings_schema.jsonTheme settings schema
config/settings_data.jsonTheme settings values
locales/*.jsonTranslation files

Error Response

StatusDescription
401Invalid or missing access token
403App doesn’t have the required read_themes / write_themes scope
404Theme does not exist
400Invalid asset key or content