Create Document

Create a new document in your account. The document is saved but not published until you explicitly publish it.

Creates a new document stored in your account. The document starts in an unpublished state. You can edit it later with the Update endpoint or publish it with the Publish endpoint.

Important

Free accounts are limited to 5 documents. Attempting to create a 6th document returns a 403 error.

POST/v1/documents

Create a new document. The document is stored but not published.

Parameters

Parameter	Type	Description
`title`	string	Document titleDefault: `Untitled`
`content`	string	Markdown content of the documentDefault: `""`
`template_id`	string	Template ID for stylingDefault: `swiss`
`theme_mode`	string	Color theme: light or dark

Request

bash

curl -X POST https://api.unmarkdown.com/v1/documents \
  -H "Authorization: Bearer um_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Project Roadmap",
    "content": "# Project Roadmap\n\nQ1 goals and milestones.",
    "template_id": "swiss"
  }'

Response

json

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "title": "Project Roadmap",
  "template_id": "swiss",
  "theme_mode": "light",
  "created_at": "2026-02-17T10:30:00Z"
}

Error Response

json

{
  "error": {
    "code": "quota_exceeded",
    "message": "Free accounts are limited to 5 documents",
    "status": 403
  }
}

Status Codes

Status	Description
201	Document created successfully
400	Invalid body or unknown template_id
401	Missing or invalid API key
403	Free tier document limit reached (5 documents)
429	Rate limit or quota exceeded
500	Internal server error

Convert List Documents