malpercio.dev
WIP! A BB-style forum, on the ATmosphere!
We're still working... we'll be back soon when we have something to show off!
node
typescript
hono
htmx
atproto
1meta {
2 name: Update Board
3 type: http
4 seq: 14
5}
6
7put {
8 url: {{appview_url}}/api/admin/boards/:id
9}
10
11params:path {
12 id: {{board_id}}
13}
14
15body:json {
16 {
17 "name": "General Chat (renamed)",
18 "description": "Updated description.",
19 "sortOrder": 2
20 }
21}
22
23assert {
24 res.status: eq 200
25 res.body.uri: isDefined
26 res.body.cid: isDefined
27}
28
29docs {
30 Update an existing forum board's name, description, and sortOrder.
31 Fetches existing rkey and categoryRef from DB, calls putRecord with updated
32 fields preserving the original category and createdAt. Category cannot be
33 changed on edit (no reparenting).
34
35 **Requires:** space.atbb.permission.manageCategories
36
37 Path params:
38 - id: Board database ID (bigint as string)
39
40 Body:
41 - name (required): New display name
42 - description (optional): New description (falls back to existing if omitted)
43 - sortOrder (optional): New sort position (falls back to existing if omitted)
44
45 Returns (200):
46 {
47 "uri": "at://did:plc:.../space.atbb.forum.board/abc123",
48 "cid": "bafyrei..."
49 }
50
51 Error codes:
52 - 400: Missing name, empty name, invalid ID format, malformed JSON
53 - 401: Not authenticated
54 - 403: Missing manageCategories permission
55 - 404: Board not found
56 - 500: ForumAgent not configured
57 - 503: PDS network error
58}