Post management REST API

Manage workspace content programmatically using authenticated session endpoints:

Endpoints

1. List Workspace Posts

GET /api/v1/posts?workspaceId=UUID&status=draft&limit=50

2. Create Post

POST /api/v1/posts
Content-Type: application/json

{
  "workspaceId": "UUID",
  "title": "Scaling Next.js Applications",
  "slug": "scaling-nextjs-applications",
  "body": {
    "format": "markdown",
    "content": "# Scaling Next.js\n\nHere is how to scale..."
  },
  "excerpt": "A practical guide to scaling Next.js apps.",
  "status": "draft",
  "categoryIds": ["UUID"],
  "tagIds": ["UUID"],
  "seo": {
    "metaTitle": "Scaling Next.js Applications (2026 Guide)",
    "metaDescription": "Learn how to optimize Next.js performance at scale.",
    "focusKeyword": "nextjs performance"
  }
}

3. Get Post by ID

GET /api/v1/posts/:id

4. Update Post

PATCH /api/v1/posts/:id
Content-Type: application/json

{
  "title": "Updated Title",
  "seo": {
    "focusKeyword": "updated keyword"
  }
}

5. Publish / Schedule Post

POST /api/v1/posts/:id/publish
Content-Type: application/json

{
  "action": "publish",
  "notifySubscribers": true
}

6. Delete Post

DELETE /api/v1/posts/:id           # Soft-delete (archive)
DELETE /api/v1/posts/:id?permanent=true  # Hard-delete (Owner/Admin)