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: Get Backfill Status
3 type: http
4 seq: 2
5}
6
7get {
8 url: {{appview_url}}/api/admin/backfill/1
9}
10
11assert {
12 res.status: eq 200
13 res.body.id: isDefined
14 res.body.status: isDefined
15 res.body.type: isDefined
16}
17
18docs {
19 Returns the status and progress for a specific backfill run by its integer ID.
20
21 Requires authentication via session cookie and `space.atbb.permission.manageForum` permission.
22
23 Path params:
24 - id: integer (required) - The numeric ID from the backfill_progress table
25
26 Returns:
27 {
28 "id": "1",
29 "status": "in_progress" | "completed" | "failed",
30 "type": "catch_up" | "full_sync",
31 "didsTotal": 150,
32 "didsProcessed": 75,
33 "recordsIndexed": 1200,
34 "errorCount": 2,
35 "startedAt": "2026-02-23T10:00:00.000Z",
36 "completedAt": null,
37 "errorMessage": null
38 }
39
40 Status values:
41 - "in_progress" — backfill is actively running
42 - "completed" — backfill finished successfully
43 - "failed" — backfill encountered a fatal error (see errorMessage)
44
45 Error codes:
46 - 400: Invalid backfill ID (non-integer path parameter)
47 - 401: Unauthorized (not authenticated)
48 - 403: Forbidden (lacks manageForum permission)
49 - 404: Backfill not found (ID does not exist in backfill_progress table)
50 - 500: Server error
51
52 Notes:
53 - errorCount is the number of per-DID failures (partial failures don't set status=failed)
54 - Use GET /api/admin/backfill/:id/errors to see per-DID error details
55 - completedAt is null while in_progress and when status=failed
56}