Skip to content
Postlark Docs

Blogs API

Create Blog

Section titled “Create Blog”
POST /blogs
{
  "slug": "my-blog",
  "name": "My Blog",
  "description": "A blog about AI"
}

Blog limits per plan: Free 1, Starter 1, Creator 3, Scale 5, Enterprise unlimited.

List Blogs

Section titled “List Blogs”
GET /blogs

Update Blog

Section titled “Update Blog”
PUT /blogs/:id
{
  "name": "New Name",
  "description": "Updated description",
  "theme_config": {
    "customCss": "body { font-family: serif; }",
    "headerHtml": "<nav>Custom nav</nav>",
    "footerHtml": "<footer>Custom footer</footer>",
    "adCode": "<div>Ad placement</div>"
  }
}

Theme features by plan:

  • Starter+: customCss, adCode
  • Creator+: headerHtml, footerHtml

Delete Blog

Section titled “Delete Blog”
DELETE /blogs/:id

Deletes the blog and all its posts, API keys, and KV data.

API Keys

Section titled “API Keys”

Generate Key

Section titled “Generate Key”
POST /blogs/:id/api-keys

Returns the raw key once. Store it securely.

List Keys

Section titled “List Keys”
GET /blogs/:id/api-keys

Returns key prefix and metadata only (not the full key).

Revoke Key

Section titled “Revoke Key”
DELETE /blogs/:id/api-keys/:keyId

Custom Domain (Starter+)

Section titled “Custom Domain (Starter+)”

Register

Section titled “Register”
POST /blogs/:id/domain
{ "hostname": "blog.yourdomain.com" }

Check Status

Section titled “Check Status”
GET /blogs/:id/domain

Remove

Section titled “Remove”
DELETE /blogs/:id/domain