pub.chive.admin.triggerFreshnessScan Documentation (EN)

main procedure

Trigger a freshness scan to detect stale indexed records

Input

Encodingapplication/json

tier string Optional

Staleness tier to scan

Output

Encodingapplication/json

operationId string Required

ID of the started backfill operation

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://bsky.social)

Request Body (JSON) Enter valid JSON for the request body

View raw schema

{
  "type": "procedure",
  "input": {
    "schema": {
      "type": "object",
      "properties": {
        "tier": {
          "type": "string",
          "description": "Staleness tier to scan"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "AuthenticationRequired"
    },
    {
      "name": "AdminRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "operationId"
      ],
      "properties": {
        "operationId": {
          "type": "string",
          "description": "ID of the started backfill operation"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Trigger a freshness scan to detect stale indexed records"
}