Blog

List blog theme versions

GET https://demo.notifuse.com/api/blogThemes.list

Returns the workspace's theme versions, newest first, files included. Requires the blog read 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

Example ws_1234567890
limit integer

Versions per page. Values above the maximum are clamped to it rather than refused.

Default 50 Max 100 Example 50
offset integer

Versions to skip.

Default 0 Min 0 Example 0

Response

200 One page of theme versions object
themes object[] | null required

Newest version first. null rather than [] when the page is empty.

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
total_count integer required

Theme versions in the workspace across all pages.

Example 4
400 Bad request - invalid query parameters object
error string required

Error message

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

Error message

403 Forbidden - missing the blog read 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