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
  • Required range: x <= 100
  • Example: 50
offset integer

Versions to skip.

  • Default: 0
  • Required range: x >= 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 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 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.

  • Available options: read, write
500 Internal server error object
error string required

Error message