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: Get Board Topics
3 type: http
4 seq: 2
5}
6
7get {
8 url: {{appview_url}}/api/boards/1/topics
9}
10
11params:query {
12 ~offset: 0
13 ~limit: 25
14}
15
16assert {
17 res.status: eq 200
18 res.body.topics: isDefined
19}
20
21docs {
22 Returns topics (posts with NULL root) for a specific board, sorted by creation time descending.
23
24 Path parameters:
25 - id: Board ID (numeric)
26
27 Query parameters:
28 - offset: Number of topics to skip (optional, default 0)
29 - limit: Maximum number of topics to return (optional, default 25, max 100)
30
31 Returns:
32 {
33 "topics": [
34 {
35 "id": "123",
36 "did": "did:plc:...",
37 "rkey": "3lbk7...",
38 "title": "Topic title",
39 "text": "Topic text",
40 "forumUri": "at://did:plc:.../space.atbb.forum.forum/self",
41 "boardUri": "at://did:plc:.../space.atbb.forum.board/...",
42 "boardId": "456",
43 "parentPostId": null,
44 "createdAt": "2026-02-13T00:00:00.000Z",
45 "author": { "did": "...", "handle": "..." } | null
46 }
47 ],
48 "total": 42,
49 "offset": 0,
50 "limit": 25
51 }
52
53 Error codes:
54 - 400: Invalid board ID format
55 - 404: Board not found
56 - 500: Server error
57}