Blog

Update a blog theme version

POST https://demo.notifuse.com/api/blogThemes.update

Edits an unpublished theme version in place. Only the files named in files are replaced. The published version cannot be edited: create a new version, or edit an older one, and publish that instead. Requires the blog write permission.

Authorizations

Authorization string header required

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

Query Parameters

workspace_id string required

The ID of the workspace. Passed in the query string, not the body.

Example ws_1234567890

Body application/json

version integer required

An unpublished theme version.

Example 4
files object

Only the files named here are replaced; the others keep their stored content. Send a file as "" to empty it.

Show 8 child attributes Hide 8 child attributes
home.liquid string

The blog home page.

category.liquid string

A category page.

post.liquid string

A post page.

header.liquid string
footer.liquid string
shared.liquid string

Snippets shared by the other templates.

styles.css string
scripts.js string
notes string

Kept as stored when omitted.

Response

200 Theme version updated object
theme object required
Show 7 child attributes Hide 7 child attributes
version integer required

Assigned on creation, one above the highest existing version.

Example 4
published_at string<date-time>

Present only on the theme currently live on the blog.

published_by_user_id string

The user or API key that published it. Present only on the live theme.

files object required

The theme's source files. Liquid files render the blog's pages; see the blog theme guide for the variables each one receives.

Show 8 child attributes Hide 8 child attributes
home.liquid string

The blog home page.

category.liquid string

A category page.

post.liquid string

A post page.

header.liquid string
footer.liquid string
shared.liquid string

Snippets shared by the other templates.

styles.css string
scripts.js string
notes string
Example Darker header, larger body text.
created_at string<date-time> required
updated_at string<date-time> required
400 Bad request - version missing, not found or published object
error string required

Error message

401 Unauthorized - invalid or missing authentication token object
error string required

Error message

403 Forbidden - missing the blog write permission object
error string required

Error message

resource string required

The permission resource the endpoint requires.

Example blog
permission string required

The access level the endpoint requires on that resource.

Options read, write