Backfill

Confirm a Backfill company match

Changed on

Link a needs_match company to a candidate by short-lived list index. The live candidate list is re-read and re-sorted server-side; a stale index returns backfill_candidate_conflict. Requires an Idempotency-Key header.

post/backfill/companies/{companyId}/match

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/backfill/companies/{companyId}/match
  • Auth: HTTP bearer

Path parameters

companyIdstring required

Cavuno company ID from the companies or Backfill list.

Request body

candidateIndexinteger required

Zero-based index into the short-lived candidates array from list (needs_match). Re-validated server-side.

startboolean required

When true, start backfill after linking the match; when false, only record the match (available).

Response

The company after match.

object'backfill_company' required
companyIdstring required
namestring required
websitestring nullable required
state'backfilling' | 'available' | 'needs_match' | 'not_backfilling' required

Changes