pub.chive.admin.getBackfillStatus Documentation (EN)

main query

Get status of backfill operations

Parameters

id string Optional

Filter by specific operation ID

status string Optional

Filter by operation status

Output

Encodingapplication/json

operation ref#backfillOperation Optional

Single operation (when filtered by ID)

operations array Optional

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)

Parameters

id Filter by specific operation ID

status Filter by operation status

View raw schema

{
  "description": "Get status of backfill operations",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "operation": {
          "description": "Single operation (when filtered by ID)",
          "ref": "#backfillOperation",
          "type": "ref"
        },
        "operations": {
          "description": "Backfill operations",
          "items": {
            "ref": "#backfillOperation",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "parameters": {
    "properties": {
      "id": {
        "description": "Filter by specific operation ID",
        "type": "string"
      },
      "status": {
        "description": "Filter by operation status",
        "knownValues": [
          "running",
          "completed",
          "failed",
          "cancelled"
        ],
        "type": "string"
      }
    },
    "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 so far

startedAt string datetime Required

Operation start time

startedBy string did Optional

DID of the admin who started the operation

status string Required

Operation status

Known values: running, completed, failed, cancelled

totalRecords integer Optional

Total records to process (if known)

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 so far",
      "type": "integer"
    },
    "startedAt": {
      "description": "Operation start time",
      "format": "datetime",
      "type": "string"
    },
    "startedBy": {
      "description": "DID of the admin who started the operation",
      "format": "did",
      "type": "string"
    },
    "status": {
      "description": "Operation status",
      "knownValues": [
        "running",
        "completed",
        "failed",
        "cancelled"
      ],
      "type": "string"
    },
    "totalRecords": {
      "description": "Total records to process (if known)",
      "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"
}