"type": "doc" and a content array of blocks.
Minimal valid document
Paragraph
Text marks (bold, italic, underline, link)
Heading (H2 / H3)
Bullet list
Ordered list
Image
attrs.src must be an HTTPS URL (upload via MCP upload_changelog_image / POST /v1/changelog-images, or use a public URL).
Upload flow
- Call
upload_changelog_image/POST /v1/changelog-imageswith{ "content_type": "image/png" }(or jpeg/gif/webp). PUTthe raw file bytes toupload_urlusing the returnedheaders.- Put
public_urlinto the image node’sattrs.src.
YouTube embed
attrs.src is required. Missing src is rejected (youtube_missing_src).

