meta {
  name: Create Category
  type: http
  seq: 10
}

post {
  url: {{appview_url}}/api/admin/categories
}

body:json {
  {
    "name": "General Discussion",
    "description": "Talk about anything.",
    "sortOrder": 1
  }
}

assert {
  res.status: eq 201
  res.body.uri: isDefined
  res.body.cid: isDefined
}

docs {
  Create a new forum category. Writes space.atbb.forum.category to the Forum DID's PDS.
  The firehose indexer creates the DB row asynchronously.

  **Requires:** space.atbb.permission.manageCategories

  Body:
  - name (required): Category display name
  - description (optional): Short description
  - sortOrder (optional): Numeric sort position (lower = first)

  Returns (201):
  {
    "uri": "at://did:plc:.../space.atbb.forum.category/abc123",
    "cid": "bafyrei..."
  }

  Error codes:
  - 400: Missing or empty name, malformed JSON
  - 401: Not authenticated
  - 403: Missing manageCategories permission
  - 500: ForumAgent not configured
  - 503: PDS network error
}