meta {
  name: Get Backfill Status
  type: http
  seq: 2
}

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

assert {
  res.status: eq 200
  res.body.id: isDefined
  res.body.status: isDefined
  res.body.type: isDefined
}

docs {
  Returns the status and progress for a specific backfill run by its integer ID.

  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:
  {
    "id": "1",
    "status": "in_progress" | "completed" | "failed",
    "type": "catch_up" | "full_sync",
    "didsTotal": 150,
    "didsProcessed": 75,
    "recordsIndexed": 1200,
    "errorCount": 2,
    "startedAt": "2026-02-23T10:00:00.000Z",
    "completedAt": null,
    "errorMessage": null
  }

  Status values:
  - "in_progress" — backfill is actively running
  - "completed"   — backfill finished successfully
  - "failed"      — backfill encountered a fatal error (see errorMessage)

  Error codes:
  - 400: Invalid backfill ID (non-integer path parameter)
  - 401: Unauthorized (not authenticated)
  - 403: Forbidden (lacks manageForum permission)
  - 404: Backfill not found (ID does not exist in backfill_progress table)
  - 500: Server error

  Notes:
  - errorCount is the number of per-DID failures (partial failures don't set status=failed)
  - Use GET /api/admin/backfill/:id/errors to see per-DID error details
  - completedAt is null while in_progress and when status=failed
}