meta {
  name: Get Backfill Errors
  type: http
  seq: 3
}

get {
  url: {{appview_url}}/api/admin/backfill/1/errors
}

assert {
  res.status: eq 200
  res.body.errors: isDefined
}

docs {
  Lists per-DID errors recorded during a specific backfill run.

  Requires authentication via session cookie and `space.atbb.permission.manageForum` permission.

  Path params:
  - id: integer (required) - The numeric ID from the backfill_progress table

  Returns:
  {
    "errors": [
      {
        "id": "1",
        "did": "did:plc:example",
        "collection": "space.atbb.post",
        "errorMessage": "fetch failed: connection refused",
        "createdAt": "2026-02-23T10:05:00.000Z"
      }
    ]
  }

  Returns an empty errors array if the backfill completed with no per-DID failures.

  Error codes:
  - 400: Invalid backfill ID (non-integer path parameter)
  - 401: Unauthorized (not authenticated)
  - 403: Forbidden (lacks manageForum permission)
  - 500: Server error

  Notes:
  - Results are ordered by createdAt ascending (earliest errors first)
  - Limited to 1000 entries per response
  - Per-DID errors are partial failures; the backfill continues processing other DIDs
  - A null collection means the error occurred before reaching the collection sync stage
}