meta {
  name: Update Category
  type: http
  seq: 11
}

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

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

body:json {
  {
    "name": "Updated Name",
    "description": "Updated description.",
    "sortOrder": 2
  }
}

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

docs {
  Update an existing forum category. Fetches existing rkey from DB, calls putRecord
  with updated fields preserving the original createdAt.

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

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

  Body:
  - name (required): New display name
  - description (optional): New description
  - sortOrder (optional): New sort position

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

  Error codes:
  - 400: Missing name, empty name, invalid ID format, malformed JSON
  - 401: Not authenticated
  - 403: Missing manageCategories permission
  - 404: Category not found
  - 500: ForumAgent not configured
  - 503: PDS network error
}