upload_post_image

Upload a cover or inline content image for an existing post. Create the post first with draft_post so you have a postId or slug.

Arguments

• type — required: cover (saved on the post) or content (returns a markdown snippet)
• filename — required, e.g. diagram.png
• contentBase64 — required raw base64 bytes (data-URL prefix optional)
• postId or slug — identify the post
• alt — optional alt text for the returned markdown (content only)
• projectSlug — when the account has more than one project

Limits: cover max 2MB, content max 5MB. PNG/JPG/WebP/SVG. Recommended cover size: 1200×630 px.

Workflow

1. draft_post → get post.id
2. upload_post_image with type=content
3. update_post with content including the returned markdown field

For covers, step 2 with type=cover is enough — the image is stored on the post immediately. HTTP equivalent: Upload post image.