Skip to main content

Backfill

Trigger a backfill of the linking graph for all documents. Useful after link key configuration changes. Poll progress via the backfill progress endpoint.

POST/v1/linking/backfill

Response

Response fields (202 Accepted)

statusstringAlways "started" when the backfill is queued.
messagestringHuman-readable confirmation message.

Response (202)

{
  "status": "started",
  "message": "Backfill queued."
}
GET/v1/linking/backfill/progress

Response

Response fields

totalintegerTotal number of documents to process.
processedintegerNumber of documents processed so far.
runningbooleanWhether a backfill is currently in progress.
entities_createdintegerNumber of entity records created during this backfill.
links_createdintegerNumber of document-entity links created during this backfill.

Response

{
  "total": 540,
  "processed": 187,
  "running": true,
  "entities_created": 312,
  "links_created": 894
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Link Keys