API Reference
Drafts
Save articles as drafts without publishing them.
Save a Draft
POST
/draftsSaves an article as a draft. Drafts are private and not indexed by search engines.
Request body
titlestringbodyrequiredDraft title.
body_markdownstringbodyrequiredMarkdown body (can be partial).
tagsstring[]bodyTag slugs (max 10).
Response fields
idstringUnique identifier of the draft.
slugstringThe draft's URL slug (auto-generated from the title).
titlestringThe draft title.
statusstringAlways draft.
editor_urlstringURL to open the draft in the web editor.
created_atstringISO 8601 creation time.
curl -X POST https://api.misar.io/blog/v1/drafts \
-H "Authorization: Bearer mbk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"My Draft","body_markdown":"## Hello"}'{
"title": "My Work-in-Progress Post",
"body_markdown": "## Introduction\n\nStill drafting...",
"tags": ["ai", "tutorial"]
}{
"id": "uuid",
"slug": "my-work-in-progress-post",
"title": "My Work-in-Progress Post",
"status": "draft",
"editor_url": "https://www.misar.blog/editor/uuid",
"created_at": "2026-04-15T09:00:00Z"
}A draft is saved as an unpublished article. Open its editor_url to finish and publish it in the web editor, or call POST /articles to publish a new article directly.
Status codes
400— Missing requiredtitleorbody_markdown401— Invalid or missing API key