pub.chive.admin.getBackfillHistory Documentation (EN)

main query

Get history of completed, failed, and cancelled backfill operations

Output

Encodingapplication/json

operations array Required

Historical backfill operations

Errors

AuthenticationRequired

AdminRequired

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

View raw schema

{
  "description": "Get history of completed, failed, and cancelled backfill operations",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "operations": {
          "description": "Historical backfill operations",
          "items": {
            "ref": "#backfillOperation",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "required": [
        "operations"
      ],
      "type": "object"
    }
  },
  "parameters": {
    "properties": {},
    "type": "params"
  },
  "type": "query"
}

backfillOperation object

A backfill operation record

Properties

completedAt string datetime Optional

Operation completion time

error string Optional

Error message if failed

id string Required

Operation ID

recordsProcessed integer Required

Number of records processed

startedAt string datetime Required

Operation start time

startedBy string did Optional

DID of the admin who started it

status string Required

Operation status

Known values: completed, failed, cancelled

totalRecords integer Optional

Total records to process

type string Required

Backfill operation type

Known values: pds-scan, freshness-scan, citation-extraction, full-reindex, governance-sync, did-sync

View raw schema

{
  "description": "A backfill operation record",
  "properties": {
    "completedAt": {
      "description": "Operation completion time",
      "format": "datetime",
      "type": "string"
    },
    "error": {
      "description": "Error message if failed",
      "type": "string"
    },
    "id": {
      "description": "Operation ID",
      "type": "string"
    },
    "recordsProcessed": {
      "description": "Number of records processed",
      "type": "integer"
    },
    "startedAt": {
      "description": "Operation start time",
      "format": "datetime",
      "type": "string"
    },
    "startedBy": {
      "description": "DID of the admin who started it",
      "format": "did",
      "type": "string"
    },
    "status": {
      "description": "Operation status",
      "knownValues": [
        "completed",
        "failed",
        "cancelled"
      ],
      "type": "string"
    },
    "totalRecords": {
      "description": "Total records to process",
      "type": "integer"
    },
    "type": {
      "description": "Backfill operation type",
      "knownValues": [
        "pds-scan",
        "freshness-scan",
        "citation-extraction",
        "full-reindex",
        "governance-sync",
        "did-sync"
      ],
      "type": "string"
    }
  },
  "required": [
    "id",
    "type",
    "status",
    "startedAt",
    "recordsProcessed"
  ],
  "type": "object"
}