Blog

List blogs for the given workspace.

get/workspaces/{workspace_id}/blogs

Request

Path parameters

workspace_idstring required

Query parameters

afterstring

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

per_pageinteger

Records per page. Defaults to 20; raise it up to 100 for bulk reads. A larger value returns 100 records. Zero, a negative or a non-integer value is a 422. The Link next-page URL keeps the value, so a client following it keeps the page size. More in our guides.

sort_order'asc' | 'desc'

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

sort_property'id' | 'updated_at'

Sort property of a list response. The default is id and thus the created_at order. If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

Response

OK

idinteger

Blog ID

public_idstring

The public identifier of the blog

workspace_idinteger

Workspace ID that the blog belongs to

site_idinteger nullable

Site ID that the blog belongs to

namestring

Name of the blog

current_pathstring

The URL path for the blog

urlstring

The full public URL of the blog

theme_idinteger nullable

Theme ID for the blog

resolved_template_page_idinteger nullable

Effective Page ID used to render the blog index

resolved_post_template_page_idinteger nullable

Effective Page ID used to render individual blog posts

resolved_category_template_page_idinteger nullable

Effective Page ID used to render blog category archives

style_idinteger nullable

Style ID for the blog

seo_image_idinteger nullable

Default sharing image ID for the blog

seo_titlestring nullable

Default Blog title for SEO

seo_descriptionstring nullable

Default Blog description for SEO

created_atstring date-time

Created at

updated_atstring date-time

Updated at

Example response

[
  {
    "id": 1,
    "public_id": "aBcDeF",
    "workspace_id": 42000,
    "site_id": 10,
    "name": "My Blog",
    "current_path": "/blog",
    "url": "https://myworkspace.myclickfunnels.com/blog",
    "theme_id": 5,
    "resolved_template_page_id": 101,
    "resolved_post_template_page_id": 102,
    "resolved_category_template_page_id": 103,
    "style_id": null,
    "seo_image_id": null,
    "seo_title": "My Blog - Latest Articles",
    "seo_description": "Read our latest articles and updates.",
    "created_at": "2025-01-01T00:00:00.000Z",
    "updated_at": "2025-01-01T00:00:00.000Z"
  }
]

Changes

    • info

      added the new optional query request parameter per_page

    • info

      for the path request parameter workspace_id, the type was generalized from integer to string

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status