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: List Roles
3 type: http
4 seq: 2
5}
6
7get {
8 url: {{appview_url}}/api/admin/roles
9}
10
11assert {
12 res.status: eq 200
13 res.body: isArray
14}
15
16docs {
17 List all available roles for the forum.
18
19 **Requires:** Authentication (any authenticated user can view roles)
20
21 Query params: None
22
23 Returns:
24 [
25 {
26 "id": "1",
27 "name": "Owner",
28 "description": "Forum owner with full control",
29 "permissions": ["*"],
30 "priority": 0
31 },
32 {
33 "id": "2",
34 "name": "Admin",
35 "description": "Can manage forum structure and users",
36 "permissions": [
37 "space.atbb.permission.manageCategories",
38 "space.atbb.permission.manageRoles",
39 ...
40 ],
41 "priority": 10
42 },
43 ...
44 ]
45
46 Roles are sorted by priority (Owner first, Member last).
47
48 Error codes:
49 - 401: Not authenticated
50 - 500: Database error
51
52 Notes:
53 - Wildcard permission ("*") grants all permissions (Owner role)
54 - Lower priority value = higher authority
55}