Workbench

Unlock Workbench Rows

Reveal masked contact details. SPENDS ONE CREDIT PER ROW.

This is the most expensive operation on the Workbench and the one a script is most likely to run by accident, because OMITTING row_ids UNLOCKS EVERY LOCKED ROW IN THE TABLE. A 10,000-row table costs 10,000 credits.

operation_id is REQUIRED and comes from unlock-quote. It is what binds the charge to a price the caller was shown, and it makes a retried unlock idempotent rather than charging twice for the same rows. Without it the request is refused.

Set approved_max_credits as well: the run refuses to exceed it, which is the difference between a bug costing you one request and costing you a balance.

post/workbench/tables/{table_id}/unlock-rows

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/workbench/tables/{table_id}/unlock-rows
  • 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 act on. OMIT to mean EVERY locked row in the table.

exclude_row_idsinteger[] nullable

Rows to leave locked.

approved_max_creditsinteger nullable

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

quote_expires_atstring date-time nullable

Expiry of the quote being approved.

operation_idstring uuid nullable

The quote's operation id. REQUIRED by the unlock - it is what ties the charge to a price the caller was shown, and it makes a retried unlock idempotent instead of charging twice.

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.