Skip to main content
GET
Track an enrichment run (incl. per-row upsert outcomes)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

runId
string<uuid>
required

The enrichment-run id (also its legacy batchId).

Response

The enrichment-run detail.

A tracked batch of column-over-row work on a table (upserts, file ingests). id is canonical; batchId is the kept legacy alias (identical value).

object
string
required
Allowed value: "enrichment_run"
id
string<uuid>
required
batchId
string<uuid>
required

Legacy alias of id, kept for pre-restructure consumers.

tableId
string<uuid>
required
type
string
required

The run's work type (e.g. upsert).

status
string
required
createdAt
string<date-time>
required
completedAt
string<date-time> | null
required
tableRunId
string<uuid> | null
required

Linked table-run parent (enrich=true batches only). Lets consumers poll GET /tables/{tableId}/runs/{runId} or await the table.run.completed webhook without a version bump. null for enrich=false writes and pre-migration batches. Completion is first-owner scoped: overlapping cells already active under an earlier run are not adopted into this parent, so this run can complete while those cells are still executing elsewhere.

rowCount
integer
required

Rows this run processed. For upsert runs this is the per-row outcome ledger length (one entry per input row).

enrichments
object
required
creditsUsed
integer
required

Settled credit cost. 0 until the run reaches a terminal status.

outcomes
object[]

Present only on upsert-type runs: the per-row outcome ledger.

outcomeCounts
object

Present only on upsert-type runs.