pub.chive.sync.refreshRecord Documentation (EN)

main procedure

Refresh a stale record from PDS

Input

Encodingapplication/json

uri stringat-uri Required

AT-URI of the record to refresh

Output

Encodingapplication/json

error string Optional

Error message if refresh failed

newCid stringcid Optional

New CID after refresh

refreshed boolean Required

Whether refresh succeeded

uri stringat-uri Required

An AT Protocol URI (e.g., at://did:plc:xyz/app.bsky.feed.post/abc).

Errors

NotFound

AuthenticationRequired

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",
      "required": [
        "uri"
      ],
      "properties": {
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the record to refresh"
        }
      }
    },
    "encoding": "application/json"
  },
  "errors": [
    {
      "name": "NotFound"
    },
    {
      "name": "AuthenticationRequired"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "uri",
        "refreshed"
      ],
      "properties": {
        "uri": {
          "type": "string",
          "format": "at-uri"
        },
        "error": {
          "type": "string",
          "description": "Error message if refresh failed"
        },
        "newCid": {
          "type": "string",
          "format": "cid",
          "description": "New CID after refresh"
        },
        "refreshed": {
          "type": "boolean",
          "description": "Whether refresh succeeded"
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Refresh a stale record from PDS"
}