Blocks

A block is a unit of text content with optional styling. Every update must include at least one block in the blocks array. Blocks are rendered in order, left to right within the panel. In fullPanel mode, blocks render top to bottom instead.

Block fields

Field	Type	Required	Description
`text`	string	Yes	The text content to display.
`size`	string	No	Text size: `small`, `medium`, or `large`.
`weight`	string	No	Font weight: `regular`, `semibold`, or `bold`.
`color`	string	No	Text color in hex format (`#RRGGBB`).
`background`	string	No	Block background color in hex format (`#RRGGBB`).

Examples

Simple text

{
  "blocks": [{ "text": "System operational" }]
}

Styled blocks

{
  "blocks": [
    {
      "text": "Deploy completed",
      "color": "#E8FFF6",
      "background": "#0A4A36",
      "size": "large",
      "weight": "bold"
    },
    {
      "text": "Queue: 12 | Escalations: 0",
      "color": "#061A13",
      "size": "small"
    }
  ]
}

Multiple blocks

Include any number of blocks in a single update. Each block appears as a separate line or segment on the display, rendered in the order you provide them.