Skip to content
WhiteBeard

List page builder blocks

GET
/cms/pagebuilder/blocks
curl --request GET \
  --url https://api.example.com/cms/pagebuilder/blocks \
  --header 'API-Key: <API-Key>'

Returns the enabled block types with their settings JSON Schema and their display variants (configured in the CMS). Use it to generate frontend types and to detect variants the frontend does not implement yet; unknown variants should fall back to defaultVariant.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

Block definitions

Media typeapplication/json
PageBuilderBlocks

The page builder blocks enabled on this deployment, with their settings and display variants as configured in the CMS (Publisher Configuration → Page Builder). Use it to generate frontend types and to detect variants the frontend does not implement yet.

object
schemaVersion

Version of the layout document format

integer
breakpoints

Breakpoints, desktop first

Array<string>
Allowed values: lg md xs
blocks

Enabled block types, in the order editors see them

Array<object>
PageBuilderBlockDefinition

A block type and its display variants

object
type

Block type, as used in PageLayoutBlock.type

string
label

Name shown to editors

string
kinds

Layout kinds the block can be used on

Array<string>
Allowed values: front landing category_template article_template author_template keyword_template
container

Whether the block holds child blocks (children)

boolean
childTypes

Block types allowed as children of a container

Array<string>
sourceKinds

Content sources of list blocks; empty for blocks without data

Array<string>
Allowed values: section query mostread mostcommented external
settings

JSON Schema of the block’s settings

object
key
additional properties
any
defaultVariant

Variant key used when a block’s variant is unknown or disabled

string
variantFallback

Whether an unknown variant falls back to defaultVariant. False for custom: its variants are components, and an unknown one must render nothing.

boolean
variants

Enabled display variants, in editor order

Array<object>
PageBuilderVariant

A display variant of a block type, configured in the CMS. The key is the contract with frontends and never changes.

object
key

Variant key, as used in PageLayoutBlock.variant

string
label

Name shown to editors

string
description

Description shown to editors

string
nullable
isDefault

Whether this is the block’s default variant

boolean
allowedSources

Source kinds this variant supports; null = all

Array<string>
nullable
breakpoints

Breakpoints this variant can be used on; null = all

Array<string>
nullable
Allowed values: lg md xs
constraints

Constraints on block settings for this variant

object
limit
object
min
integer
max
integer
default
integer
options

JSON Schema of this variant’s options (PageLayoutBlock.variantOptions)

object
key
additional properties
any

Example 

{
  "schemaVersion": 1,
  "breakpoints": [
    "lg",
    "md",
    "xs"
  ],
  "blocks": [
    {
      "type": "content_list",
      "label": "Content list",
      "kinds": [
        "front",
        "landing",
        "category_template",
        "article_template",
        "author_template",
        "keyword_template"
      ],
      "container": false,
      "childTypes": [],
      "sourceKinds": [
        "section",
        "query",
        "mostread",
        "mostcommented"
      ],
      "settings": {
        "type": "object",
        "required": [
          "source"
        ],
        "properties": {
          "source": {
            "type": "object"
          }
        }
      },
      "defaultVariant": "thumb_list",
      "variants": [
        {
          "key": "thumb_list",
          "label": "Thumbnail list",
          "description": "Vertical list with a small image beside each headline.",
          "isDefault": true,
          "allowedSources": null,
          "breakpoints": null,
          "constraints": {
            "limit": {
              "min": 1,
              "max": 20,
              "default": 5
            }
          },
          "options": {
            "type": "object",
            "properties": {
              "showByline": {
                "title": "Show byline",
                "type": "boolean"
              }
            },
            "additionalProperties": false
          }
        }
      ]
    }
  ]
}

404

Section titled “404”

Page builder is not enabled