Input schema (truncated preview — do not copy)
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"link"
],
"type": "string",
"description": "Use this variant only for a link block."
},
"props": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"description": "Destination URL using http, https, mailto, tel, or sms."
},
"icon": {
"type": "string",
"maxLength": 64
},
"label": {
"type": "string",
"maxLength": 120
},
"width": {
"enum": [
"full",
"half"
],
"type": "string",
"description": "half lets two consecutive half-width links render side by side as one row. Default full."
},
"highlight": {
"type": "boolean"
},
"thumbnail": {
"type": "object",
"required": [
"src"
],
"properties": {
"alt": {
"type": "string",
"description": "Alt text for accessibility."
},
"src": {
"type": "string",
"description": "Image URL or stored media URL."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"variants": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"mediaAssetId": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
"type": "string",
"description": "The block id returned by block_add or page_get. Stable across reorders."
},
"editToken": {
"type": "string"
}
},
"description": "Patch an existing block as link. Provide the block's current type unless intentionally changing it.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"social_row"
],
"type": "string",
"description": "Use this variant only for a social_row block."
},
"props": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "For social platforms: a public http(s) profile URL. For contact platforms (email/phone/whatsapp): the bare email address or phone number — the page builds the mailto:/tel:/wa.me link."
},
"label": {
"type": "string",
"maxLength": 64
},
"platform": {
"enum": [
"instagram",
"tiktok",
"youtube",
"x",
"facebook",
"linkedin",
"spotify",
"apple_music",
"soundcloud",
"github",
"pinterest",
"threads",
"twitch",
"discord",
"telegram",
"snapchat",
"vimeo",
"behance",
"dribbble",
"medium",
"substack",
"website",
"other",
"email",
"phone",
"whatsapp"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 16
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
"type": "string",
"description": "The block id returned by block_add or page_get. Stable across reorders."
},
"editToken": {
"type": "string"
}
},
"description": "Patch an existing block as social_row. Provide the block's current type unless intentionally changing it.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"whatsapp"
],
"type": "string",
"description": "Use this variant only for a whatsapp block."
},
"props": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "string",
"maxLength": 32,
"description": "Public WhatsApp phone number."
},
"message": {
"type": "string",
"maxLength": 500,
"description": "Optional prefilled message."
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
"type": "string",
"description": "The block id returned by block_add or page_get. Stable across reorders."
},
"editToken": {
"type": "string"
}
},
"description": "Patch an existing block as whatsapp. Provide the block's current type unless intentionally changing it.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"phone_call"
],
"type": "string",
"description": "Use this variant only for a phone_call block."
},
"props": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "string",
"maxLength": 32,
"description": "Public phone number."
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
"type": "string",
"description": "The block id returned by block_add or page_get. Stable across reorders."
},
"editToken": {
"type": "string"
}
},
"description": "Patch an existing block as phone_call. Provide the block's current type unless intentionally changing it.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"email_contact"
],
"type": "string",
"description": "Use this variant only for a email_contact block."
},
"props": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Public business email address."
},
"label": {
"type": "string",
"maxLength": 120
},
"subject": {
"type": "string",
"maxLength": 160
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
"type": "string",
"description": "The block id returned by block_add or page_get. Stable across reorders."
},
"editToken": {
"type": "string"
}
},
"description": "Patch an existing block as email_contact. Provide the block's current type unless intentionally changing it.",
"additionalProperties": false
},
{
"type": "object",
"required": [
"blockId",
"pageId",
"props",
"type"
],
"properties": {
"type": {
"enum": [
"image"
],
"type": "string",
"description": "Use this variant only for a image block."
},
"props": {
"type": "object",
"properties": {
"image": {
"type": "object",
"required": [
"src"
],
"properties": {
"alt": {
"type": "string",
"description": "Alt text for accessibility."
},
"src": {
"type": "string",
"description": "Image URL or stored media URL."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"variants": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"mediaAssetId": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"layout": {
"enum": [
"classic",
"wide",
"background"
],
"type": "string"
},
"caption": {
"type": "string",
"maxLength": 280
},
"link_url": {
"type": "string",
"maxLength": 2048
}
},
"description": "Partial props patch for this block type. Include only fields you want to change.",
"additionalProperties": false
},
"pageId": {
"type": "string",
"format": "uuid"
},
"blockId": {
… [server-provided details truncated]