Blog

Create a blog theme version

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

Saves a new, unpublished theme version, numbered one above the highest existing version. Files left out are stored empty. Nothing changes on the blog until the version is published. 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

files object

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.

Response

201 Theme version created 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 - malformed body 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
500 Internal server error object
error string required

Error message