meta {
  name: Delete Category
  type: http
  seq: 12
}

delete {
  url: {{appview_url}}/api/admin/categories/:id
}

params:path {
  id: {{category_id}}
}

assert {
  res.status: eq 200
  res.body.success: isTrue
}

docs {
  Delete a forum category. Pre-flight check refuses with 409 if any boards reference
  this category. If clear, calls deleteRecord on the Forum DID's PDS.
  The firehose indexer removes the DB row asynchronously.

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

  Path params:
  - id: Category database ID (bigint as string)

  Returns (200):
  {
    "success": true
  }

  Error codes:
  - 400: Invalid ID format
  - 401: Not authenticated
  - 403: Missing manageCategories permission
  - 404: Category not found
  - 409: Category has boards — remove them first
  - 500: ForumAgent not configured
  - 503: PDS network error
}