Workbench

Run Workbench Ai

Run every configured AI pass over the table. SPENDS CREDITS.

OMITTING row_ids RUNS EVERY ROW, and the body is optional - so a bare POST with no body at all is "enrich this entire table". On a 10,000-row table with three configured columns that is 30,000 model calls.

Set approved_max_credits. The run refuses to exceed it, and a credit preflight happens before any work starts, so an over-budget request costs nothing rather than costing until the balance runs out.

Returns 202 and a handle: the work happens in the background. The group's skip_existing_values and skip_recently_enriched settings still apply, so re-running is usually far cheaper than the first pass.

post/workbench/tables/{table_id}/ai/run-all

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/workbench/tables/{table_id}/ai/run-all
  • Auth: HTTP bearer

Path parameters

table_idstring required

Workbench table id (UUID).

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

row_idsinteger[] nullable

Rows to run. OMIT to run EVERY row in the table.

exclude_row_idsinteger[] nullable
modelstring nullable

Override the configured model.

promptstring nullable

Override the configured prompt.

status_filterstring nullable
conditionsobject[] nullable
qualification_modeboolean
multi_row_outputboolean nullable
max_rows_per_sourceinteger nullable
approved_max_creditsinteger nullable

Ceiling the caller approves. The run refuses to exceed it.

quote_expires_atstring date-time nullable
quote_idstring uuid nullable

Response

Successful Response

dataEnrichmentPayload required

One enrichment object, open-shaped.

Open on purpose: a workbench column set is defined by the CUSTOMER at runtime, and the enrichment result shapes grow with every provider added. Pinning them would drop whatever a provider returned that this contract had not caught up on, which on an enrichment surface is the data the customer paid for.

Changes

No recorded changes to this operation across all 2 revisions of this API.