Save a Draft

POST/drafts

Saves an article as a draft. Drafts are private and not indexed by search engines.

Request body

titlestringbodyrequired

Draft title.

contentstringbody

Markdown body (can be partial).

excerptstringbody

Preview text.

tagsstring[]body

Tag slugs (max 5).

featured_image_urlstringbody

Cover image URL.

Response fields

idstring

Unique identifier of the draft.

slugstring

The draft's URL slug.

titlestring

The draft title.

created_atstring

ISO 8601 creation time.

updated_atstring

ISO 8601 last-updated 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","content":"## Hello"}'

{
  "title": "My Work-in-Progress Post",
  "content": "## Introduction\n\nStill drafting...",
  "excerpt": "Optional preview text",
  "tags": ["ai", "tutorial"],
  "featured_image_url": "https://..."
}

{
  "id": "uuid",
  "slug": "my-work-in-progress-post",
  "title": "My Work-in-Progress Post",
  "created_at": "2026-04-15T09:00:00Z",
  "updated_at": "2026-04-15T09:00:00Z"
}

To publish a saved draft, use POST /articles with the same slug. The draft is converted to a published article automatically.

Status codes

401 — Invalid or missing API key
400 — Missing required title field