Developer API v1

Build on top of Mrakdon

Fetch your generated markdown directly into your CMS, build pipeline, or custom application with a simple REST API.

Authentication

Bearer Token required

All API requests must be authenticated using your unique API key in the header. Keep this key secret.

Authorization: Bearer mk_live_...

Base URL

All endpoints start here

https://mrakdon.com/api/v1

All Systems Operational

LIVE

45 days ago100.00% UptimeToday

RPM

0reqs / min

Avg. Latency

580ms

GET

/documents/:id

Fetch a single document

curl https://mrakdon.com/api/v1/documents/doc_12345 \
  -H "Authorization: Bearer mk_live_8f3a..."

Response Object

JSON

{
  "id": "doc_12345",
  "title": "My Awesome Blog Post",
  "type": "blog",
  "version": 2,
  "content": "# Hello World\n\nThis is my generated markdown...",
  "timestamps": {
    "created": "2024-01-20T10:00:00Z",
    "updated": "2024-01-21T15:30:00Z"
  }
}

idString

Unique identifier for the document.

contentMarkdown

The raw generated markdown content.

typeEnum

blog | readme | docs | tutorial

versionInteger

Current version number of the doc.

timestampsObject

ISO 8601 dates for creation/updates.

Error Handling

401

Unauthorized

Your API key is missing or invalid.

404

Not Found

Document ID does not exist.

429

Rate Limit

Too many requests. Slow down.