meta {
  name: Create Board
  type: http
  seq: 13
}

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

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

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

docs {
  Create a new forum board within a category. Fetches the category's CID from DB
  to build the categoryRef strongRef. Writes space.atbb.forum.board to the Forum
  DID's PDS. The firehose indexer creates the DB row asynchronously.

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

  Body:
  - name (required): Board display name
  - categoryUri (required): AT URI of the parent category
  - description (optional): Short description
  - sortOrder (optional): Numeric sort position (lower = first)

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

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