KV Block

The kv block renders a clean two-column key/value table. Use it to display structured data like order details, customer info, metrics, or configuration values.

Fields

Field	Type	Required	Description
type	string	Yes	"kv"
rows	Row[]	Yes	Array of key/value pairs

Row Object

Field	Type	Required	Description
key	string	Yes	Left column label
value	string	Yes	Right column value

Examples

Order Details

{
  "type": "kv",
  "rows": [
    { "key": "Order #", "value": "1234" },
    { "key": "Customer", "value": "Jane Smith" },
    { "key": "Email", "value": "[email protected]" },
    { "key": "Total", "value": "$89.99" },
    { "key": "Status", "value": "Processing" }
  ]
}

System Metrics

{
  "type": "kv",
  "rows": [
    { "key": "CPU Usage", "value": "23%" },
    { "key": "Memory", "value": "4.2 GB / 8 GB" },
    { "key": "Uptime", "value": "14 days" },
    { "key": "Region", "value": "us-east-1" }
  ]
}

Patching

Overwrite All Rows

{
  "id": "details-kv",
  "patch": {
    "rows": [
      { "key": "Status", "value": "Shipped" },
      { "key": "Tracking", "value": "1Z999AA1234" }
    ]
  }
}

Append Rows

Use append_rows to add new rows without removing existing ones:

{
  "id": "details-kv",
  "patch": {
    "append_rows": [
      { "key": "Delivered At", "value": "Jan 15, 2025 2:30 PM" }
    ]
  }
}

append_rows is additive — the new rows are concatenated to the end of the existing rows array.