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: Create Board
3 type: http
4 seq: 13
5}
6
7post {
8 url: {{appview_url}}/api/admin/boards
9}
10
11body:json {
12 {
13 "name": "General Chat",
14 "description": "Talk about anything.",
15 "sortOrder": 1,
16 "categoryUri": "{{category_uri}}"
17 }
18}
19
20assert {
21 res.status: eq 201
22 res.body.uri: isDefined
23 res.body.cid: isDefined
24}
25
26docs {
27 Create a new forum board within a category. Fetches the category's CID from DB
28 to build the categoryRef strongRef. Writes space.atbb.forum.board to the Forum
29 DID's PDS. The firehose indexer creates the DB row asynchronously.
30
31 **Requires:** space.atbb.permission.manageCategories
32
33 Body:
34 - name (required): Board display name
35 - categoryUri (required): AT URI of the parent category
36 - description (optional): Short description
37 - sortOrder (optional): Numeric sort position (lower = first)
38
39 Returns (201):
40 {
41 "uri": "at://did:plc:.../space.atbb.forum.board/abc123",
42 "cid": "bafyrei..."
43 }
44
45 Error codes:
46 - 400: Missing or empty name, missing categoryUri, malformed JSON
47 - 401: Not authenticated
48 - 403: Missing manageCategories permission
49 - 404: categoryUri references unknown category
50 - 500: ForumAgent not configured
51 - 503: PDS network error
52}