콘텐츠로 이동
Postlark Docs

블로그 API

Create Blog

섹션 제목: “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

섹션 제목: “List Blogs”
GET /blogs

Update Blog

섹션 제목: “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

섹션 제목: “Delete Blog”
DELETE /blogs/:id

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

API Keys

섹션 제목: “API Keys”

Generate Key

섹션 제목: “Generate Key”
POST /blogs/:id/api-keys

Returns the raw key once. Store it securely.

List Keys

섹션 제목: “List Keys”
GET /blogs/:id/api-keys

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

Revoke Key

섹션 제목: “Revoke Key”
DELETE /blogs/:id/api-keys/:keyId

Custom Domain (Starter+)

섹션 제목: “Custom Domain (Starter+)”

Register

섹션 제목: “Register”
POST /blogs/:id/domain
{ "hostname": "blog.yourdomain.com" }

Check Status

섹션 제목: “Check Status”
GET /blogs/:id/domain

Remove

섹션 제목: “Remove”
DELETE /blogs/:id/domain