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