Sign in
Content

Update a single post

Updates any combination of title, slug, markdown, and status. Sending markdown re-renders the stored HTML, and when title is omitted it is taken from the first heading in the markdown, keeping the existing title when the markdown has no heading. Slugs are only accepted for blog posts and changelogs.

patch/v1/posts/{postId}

Path parameters

postIdstring required
Example:post_123

Request body

titlestring
slugstring nullable
markdownstring
status'draft' | 'published'

Example request

{
  "title": "Ship notes for week 11",
  "slug": "ship-notes-week-11",
  "markdown": "# Ship notes\n\nWe shipped a faster editor.",
  "status": "published"
}

Response

Post updated successfully

Changes