Skip to main content
Changelog bodies are not Markdown. The API expects TipTap JSON: a document with "type": "doc" and a content array of blocks.

Minimal valid document

Empty body:

Paragraph

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

  1. Call upload_changelog_image / POST /v1/changelog-images with { "content_type": "image/png" } (or jpeg/gif/webp).
  2. PUT the raw file bytes to upload_url using the returned headers.
  3. Put public_url into the image node’s attrs.src.

YouTube embed

attrs.src is required. Missing src is rejected (youtube_missing_src).

Common mistakes