meta {
  name: Update Board
  type: http
  seq: 14
}

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

params:path {
  id: {{board_id}}
}

body:json {
  {
    "name": "General Chat (renamed)",
    "description": "Updated description.",
    "sortOrder": 2
  }
}

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

docs {
  Update an existing forum board's name, description, and sortOrder.
  Fetches existing rkey and categoryRef from DB, calls putRecord with updated
  fields preserving the original category and createdAt. Category cannot be
  changed on edit (no reparenting).

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

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

  Body:
  - name (required): New display name
  - description (optional): New description (falls back to existing if omitted)
  - sortOrder (optional): New sort position (falls back to existing if omitted)

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

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