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: Delete Category
3 type: http
4 seq: 12
5}
6
7delete {
8 url: {{appview_url}}/api/admin/categories/:id
9}
10
11params:path {
12 id: {{category_id}}
13}
14
15assert {
16 res.status: eq 200
17 res.body.success: isTrue
18}
19
20docs {
21 Delete a forum category. Pre-flight check refuses with 409 if any boards reference
22 this category. If clear, calls deleteRecord on the Forum DID's PDS.
23 The firehose indexer removes the DB row asynchronously.
24
25 **Requires:** space.atbb.permission.manageCategories
26
27 Path params:
28 - id: Category database ID (bigint as string)
29
30 Returns (200):
31 {
32 "success": true
33 }
34
35 Error codes:
36 - 400: Invalid ID format
37 - 401: Not authenticated
38 - 403: Missing manageCategories permission
39 - 404: Category not found
40 - 409: Category has boards — remove them first
41 - 500: ForumAgent not configured
42 - 503: PDS network error
43}