pub.chive.admin.getBackfillHistory

chive.pub

Documentation

Get history of completed, failed, and cancelled backfill operations

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.

Base URL for XRPC calls (e.g., https://api.bsky.social)
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "operations"
      ],
      "properties": {
        "operations": {
          "type": "array",
          "items": {
            "ref": "#backfillOperation",
            "type": "ref"
          },
          "description": "Historical backfill operations"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {}
  },
  "description": "Get history of completed, failed, and cancelled backfill operations"
}
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 
{
  "type": "object",
  "required": [
    "id",
    "type",
    "status",
    "startedAt",
    "recordsProcessed"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Operation ID"
    },
    "type": {
      "type": "string",
      "description": "Backfill operation type",
      "knownValues": [
        "pds-scan",
        "freshness-scan",
        "citation-extraction",
        "full-reindex",
        "governance-sync",
        "did-sync"
      ]
    },
    "error": {
      "type": "string",
      "description": "Error message if failed"
    },
    "status": {
      "type": "string",
      "description": "Operation status",
      "knownValues": [
        "completed",
        "failed",
        "cancelled"
      ]
    },
    "startedAt": {
      "type": "string",
      "format": "datetime",
      "description": "Operation start time"
    },
    "startedBy": {
      "type": "string",
      "format": "did",
      "description": "DID of the admin who started it"
    },
    "completedAt": {
      "type": "string",
      "format": "datetime",
      "description": "Operation completion time"
    },
    "totalRecords": {
      "type": "integer",
      "description": "Total records to process"
    },
    "recordsProcessed": {
      "type": "integer",
      "description": "Number of records processed"
    }
  },
  "description": "A backfill operation record"
}

Lexicon Garden

@