REST API

Everything you can do in the dashboard is also a REST API endpoint: posts, pages, categories, tags, media, settings, menus, redirects, team, leads, translations and deploys.

API access is available on the SUPER and BUSINESS plans.

Reference

  1. API reference with a playground:write.superblog.ai/api/v2/docs
  2. OpenAPI spec:write.superblog.ai/api/v2/openapi.json

Authenticate

Create an API key for your blog, then send it as a bearer token with every request. See Create API keys.

curl https://write.superblog.ai/api/v2/sites/yourblog/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

Replace yourblog with your blog's supername, the first part of its Superblog address.

Example: create a post from markdown

curl -X POST https://write.superblog.ai/api/v2/sites/yourblog/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post": {"title": "Hello from the API", "content": "## First section\n\nSome text.", "contentType": "markdown", "status": "DRAFT"} }'

Then trigger a deploy with POST /sites/yourblog/deploy, or deploy from the dashboard.

Errors

Errors come back with an HTTP status and a JSON body that says what went wrong, for example which field failed validation.

From the terminal

To preview, deploy or build a custom template from a terminal without writing API calls, use the Superblog CLI.

API or MCP

If you want an AI assistant to manage your blog for you, MCP is easier: it uses the same API underneath, and needs no code.

Next Article Create API keys