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 Errors
3 type: http
4 seq: 3
5}
6
7get {
8 url: {{appview_url}}/api/admin/backfill/1/errors
9}
10
11assert {
12 res.status: eq 200
13 res.body.errors: isDefined
14}
15
16docs {
17 Lists per-DID errors recorded during a specific backfill run.
18
19 Requires authentication via session cookie and `space.atbb.permission.manageForum` permission.
20
21 Path params:
22 - id: integer (required) - The numeric ID from the backfill_progress table
23
24 Returns:
25 {
26 "errors": [
27 {
28 "id": "1",
29 "did": "did:plc:example",
30 "collection": "space.atbb.post",
31 "errorMessage": "fetch failed: connection refused",
32 "createdAt": "2026-02-23T10:05:00.000Z"
33 }
34 ]
35 }
36
37 Returns an empty errors array if the backfill completed with no per-DID failures.
38
39 Error codes:
40 - 400: Invalid backfill ID (non-integer path parameter)
41 - 401: Unauthorized (not authenticated)
42 - 403: Forbidden (lacks manageForum permission)
43 - 500: Server error
44
45 Notes:
46 - Results are ordered by createdAt ascending (earliest errors first)
47 - Limited to 1000 entries per response
48 - Per-DID errors are partial failures; the backfill continues processing other DIDs
49 - A null collection means the error occurred before reaching the collection sync stage
50}