@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/workbench.md

@@ -0,0 +1,4884 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.workbench`: Workbench
+
+107 operations (41 read, 30 write, 12 destructive, 21 billable, 3 external).
+
+No hand-written client covers this area. Call it through `g8.api.workbench.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [workbench.d.ts](workbench.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`addWorkbenchColumn`](#op-addworkbenchcolumn) | `POST /api/v1/workbench/tables/{table_id}/columns` | write | `lists:write` | Add Workbench Column |
+| [`addWorkbenchRow`](#op-addworkbenchrow) | `POST /api/v1/workbench/tables/{table_id}/rows` | write | `lists:write` | Add Workbench Row |
+| [`bulkDeleteWorkbenchRows`](#op-bulkdeleteworkbenchrows) | `POST /api/v1/workbench/tables/{table_id}/rows/bulk-delete` | destructive | `lists:delete` | Bulk Delete Workbench Rows |
+| [`bulkExtractWorkbenchColumns`](#op-bulkextractworkbenchcolumns) | `POST /api/v1/workbench/tables/{table_id}/columns/bulk-extract` | write | `lists:write` | Bulk Extract Workbench Columns |
+| [`checkWorkbenchScraperToken`](#op-checkworkbenchscrapertoken) | `GET /api/v1/workbench/scraper/providers/{provider}/check-token` | read | `lists:read` | Check Workbench Scraper Token |
+| [`computeWorkbenchFormula`](#op-computeworkbenchformula) | `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/compute` | write | `lists:write` | Compute Workbench Formula |
+| [`configureWorkbenchAi`](#op-configureworkbenchai) | `POST /api/v1/workbench/tables/{table_id}/ai/configure` | write | `lists:write` | Configure Workbench Ai |
+| [`configureWorkbenchColumnSource`](#op-configureworkbenchcolumnsource) | `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources` | write | `lists:write` | Configure Workbench Column Source |
+| [`configureWorkbenchFindPeople`](#op-configureworkbenchfindpeople) | `POST /api/v1/workbench/tables/{table_id}/find-people/configure` | billable | `lists:run` | Configure Workbench Find People |
+| [`createWorkbenchAiGroup`](#op-createworkbenchaigroup) | `POST /api/v1/workbench/tables/{table_id}/ai/groups/config` | write | `lists:write` | Create Workbench Ai Group |
+| [`createWorkbenchBindings`](#op-createworkbenchbindings) | `POST /api/v1/workbench-bindings` | write | `lists:write` | Create Workbench Bindings |
+| [`createWorkbenchConnection`](#op-createworkbenchconnection) | `POST /api/v1/workbench/tables/{table_id}/connections` | write | `lists:write` | Create Workbench Connection |
+| [`createWorkbenchFormulaColumns`](#op-createworkbenchformulacolumns) | `POST /api/v1/workbench/tables/{table_id}/formula-columns` | write | `lists:write` | Create Workbench Formula Columns |
+| [`createWorkbenchPipeline`](#op-createworkbenchpipeline) | `POST /api/v1/workbench/tables/{table_id}/pipelines` | billable | `lists:run` | Create Workbench Pipeline |
+| [`createWorkbenchTable`](#op-createworkbenchtable) | `POST /api/v1/workbench/tables` | write | `lists:write` | Create Workbench Table |
+| [`createWorkbenchTrigger`](#op-createworkbenchtrigger) | `POST /api/v1/workbench/tables/{table_id}/triggers` | billable | `lists:run` | Create Workbench Trigger |
+| [`deleteScraperProviderConnection`](#op-deletescraperproviderconnection) | `DELETE /api/v1/workbench/scraper/providers/{provider}/connection` | destructive | `lists:delete` | Delete Scraper Provider Connection |
+| [`deleteWorkbenchAiGroup`](#op-deleteworkbenchaigroup) | `DELETE /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}` | destructive | `lists:delete` | Delete Workbench Ai Group |
+| [`deleteWorkbenchBinding`](#op-deleteworkbenchbinding) | `DELETE /api/v1/workbench-bindings/{binding_id}` | destructive | `lists:delete` | Delete Workbench Binding |
+| [`deleteWorkbenchColumn`](#op-deleteworkbenchcolumn) | `DELETE /api/v1/workbench/tables/{table_id}/columns/{column_id}` | destructive | `lists:delete` | Delete Workbench Column |
+| [`deleteWorkbenchConnection`](#op-deleteworkbenchconnection) | `DELETE /api/v1/workbench/tables/{table_id}/connections/{connection_id}` | destructive | `lists:delete` | Delete Workbench Connection |
+| [`deleteWorkbenchFindPeopleConfig`](#op-deleteworkbenchfindpeopleconfig) | `DELETE /api/v1/workbench/tables/{table_id}/find-people/{config_id}` | destructive | `lists:delete` | Delete Workbench Find People Config |
+| [`deleteWorkbenchPipeline`](#op-deleteworkbenchpipeline) | `DELETE /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}` | destructive | `lists:delete` | Delete Workbench Pipeline |
+| [`deleteWorkbenchSchedule`](#op-deleteworkbenchschedule) | `DELETE /api/v1/workbench/tables/{table_id}/schedule` | destructive | `lists:delete` | Delete Workbench Schedule |
+| [`deleteWorkbenchTable`](#op-deleteworkbenchtable) | `DELETE /api/v1/workbench/tables/{table_id}` | destructive | `lists:delete` | Delete Workbench Table |
+| [`deleteWorkbenchTrigger`](#op-deleteworkbenchtrigger) | `DELETE /api/v1/workbench/tables/{table_id}/triggers/{trigger_id}` | destructive | `lists:delete` | Delete Workbench Trigger |
+| [`discoverWorkbenchFields`](#op-discoverworkbenchfields) | `POST /api/v1/workbench/tables/{table_id}/discover-fields` | write | `lists:write` | Discover Workbench Fields |
+| [`estimateWorkbenchProviderScraperCredits`](#op-estimateworkbenchproviderscrapercredits) | `GET /api/v1/workbench/scraper/providers/{provider}/credit-estimate` | read | `lists:read` | Estimate Workbench Provider Scraper Credits |
+| [`estimateWorkbenchScraperCredits`](#op-estimateworkbenchscrapercredits) | `GET /api/v1/workbench/scraper/credit-estimate` | read | `lists:read` | Estimate Workbench Scraper Credits |
+| [`expandWorkbenchArray`](#op-expandworkbencharray) | `POST /api/v1/workbench/tables/{table_id}/expand-array` | write | `lists:write` | Expand Workbench Array |
+| [`exportWorkbenchAiFindPeople`](#op-exportworkbenchaifindpeople) | `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/export` | write | `lists:write` | Export Workbench Ai Find People |
+| [`exportWorkbenchTable`](#op-exportworkbenchtable) | `POST /api/v1/workbench/tables/{table_id}/export` | write | `lists:write` | Export Workbench Table |
+| [`extractWorkbenchColumn`](#op-extractworkbenchcolumn) | `POST /api/v1/workbench/tables/{table_id}/columns/extract` | write | `lists:write` | Extract Workbench Column |
+| [`generateWorkbenchPrompt`](#op-generateworkbenchprompt) | `POST /api/v1/workbench/tables/{table_id}/ai/generate-prompt` | billable | `lists:run` | Generate Workbench Prompt |
+| [`getScraperProviderConnection`](#op-getscraperproviderconnection) | `GET /api/v1/workbench/scraper/providers/{provider}/connection` | read | `lists:read` | Get Scraper Provider Connection |
+| [`getWorkbenchAiFindPeopleRow`](#op-getworkbenchaifindpeoplerow) | `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/rows/{source_row_id}` | read | `lists:read` | Get Workbench Ai Find People Row |
+| [`getWorkbenchAiGroup`](#op-getworkbenchaigroup) | `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}` | read | `lists:read` | Get Workbench Ai Group |
+| [`getWorkbenchAnalytics`](#op-getworkbenchanalytics) | `GET /api/v1/workbench/tables/{table_id}/analytics` | read | `lists:read` | Get Workbench Analytics |
+| [`getWorkbenchColumnAiConfig`](#op-getworkbenchcolumnaiconfig) | `GET /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai-config` | read | `lists:read` | Get Workbench Column Ai Config |
+| [`getWorkbenchHistory`](#op-getworkbenchhistory) | `GET /api/v1/workbench/tables/{table_id}/history` | read | `lists:read` | Get Workbench History |
+| [`getWorkbenchLockedRowCount`](#op-getworkbenchlockedrowcount) | `GET /api/v1/workbench/tables/{table_id}/locked-row-count` | read | `lists:read` | Get Workbench Locked Row Count |
+| [`getWorkbenchMappingSuggestion`](#op-getworkbenchmappingsuggestion) | `GET /api/v1/workbench/tables/{table_id}/suggest-mappings/{job_id}` | read | `lists:read` | Get Workbench Mapping Suggestion |
+| [`getWorkbenchPipeline`](#op-getworkbenchpipeline) | `GET /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}` | read | `lists:read` | Get Workbench Pipeline |
+| [`getWorkbenchRow`](#op-getworkbenchrow) | `GET /api/v1/workbench/tables/{table_id}/rows/{row_id}` | read | `lists:read` | Get Workbench Row |
+| [`getWorkbenchSchedule`](#op-getworkbenchschedule) | `GET /api/v1/workbench/tables/{table_id}/schedule` | read | `lists:read` | Get Workbench Schedule |
+| [`getWorkbenchScraperRun`](#op-getworkbenchscraperrun) | `GET /api/v1/workbench/tables/{table_id}/scraper/runs/{run_id}` | read | `lists:read` | Get Workbench Scraper Run |
+| [`getWorkbenchTable`](#op-getworkbenchtable) | `GET /api/v1/workbench/tables/{table_id}` | read | `lists:read` | Get Workbench Table |
+| [`getWorkbenchWaterfall`](#op-getworkbenchwaterfall) | `GET /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}` | read | `lists:read` | Get Workbench Waterfall |
+| [`importWorkbenchDatafile`](#op-importworkbenchdatafile) | `POST /api/v1/workbench/tables/{table_id}/import/datafile` | write | `lists:write` | Import Workbench Datafile |
+| [`importWorkbenchFromCrm`](#op-importworkbenchfromcrm) | `POST /api/v1/workbench/tables/{table_id}/import/crm` | external | `lists:run` | Import Workbench From Crm |
+| [`importWorkbenchFromSearch`](#op-importworkbenchfromsearch) | `POST /api/v1/workbench/tables/{table_id}/import/search` | billable | `lists:run` | Import Workbench From Search |
+| [`listWorkbenchAiPresets`](#op-listworkbenchaipresets) | `GET /api/v1/workbench/ai-presets` | read | `lists:read` | List Workbench Ai Presets |
+| [`listWorkbenchBindings`](#op-listworkbenchbindings) | `GET /api/v1/workbench-bindings` | read | `lists:read` | List Workbench Bindings |
+| [`listWorkbenchColumnSources`](#op-listworkbenchcolumnsources) | `GET /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources` | read | `lists:read` | List Workbench Column Sources |
+| [`listWorkbenchColumns`](#op-listworkbenchcolumns) | `GET /api/v1/workbench/tables/{table_id}/columns` | read | `lists:read` | List Workbench Columns |
+| [`listWorkbenchConnections`](#op-listworkbenchconnections) | `GET /api/v1/workbench/tables/{table_id}/connections` | read | `lists:read` | List Workbench Connections |
+| [`listWorkbenchEnrichmentConfigs`](#op-listworkbenchenrichmentconfigs) | `GET /api/v1/workbench/tables/{table_id}/enrichment-configs` | read | `lists:read` | List Workbench Enrichment Configs |
+| [`listWorkbenchFindPeopleConfigs`](#op-listworkbenchfindpeopleconfigs) | `GET /api/v1/workbench/tables/{table_id}/find-people/configs` | read | `lists:read` | List Workbench Find People Configs |
+| [`listWorkbenchFindPeopleContacts`](#op-listworkbenchfindpeoplecontacts) | `GET /api/v1/workbench/tables/{table_id}/find-people/{config_id}/contacts` | read | `lists:read` | List Workbench Find People Contacts |
+| [`listWorkbenchPipelines`](#op-listworkbenchpipelines) | `GET /api/v1/workbench/tables/{table_id}/pipelines` | read | `lists:read` | List Workbench Pipelines |
+| [`listWorkbenchRows`](#op-listworkbenchrows) | `GET /api/v1/workbench/tables/{table_id}/rows` | read | `lists:read` | List Workbench Rows |
+| [`listWorkbenchScraperPresets`](#op-listworkbenchscraperpresets) | `GET /api/v1/workbench/scraper/presets` | read | `lists:read` | List Workbench Scraper Presets |
+| [`listWorkbenchScraperRuns`](#op-listworkbenchscraperruns) | `GET /api/v1/workbench/tables/{table_id}/scraper/runs` | read | `lists:read` | List Workbench Scraper Runs |
+| [`listWorkbenchSourceCredentials`](#op-listworkbenchsourcecredentials) | `GET /api/v1/workbench/source-credentials` | read | `lists:read` | List Workbench Source Credentials |
+| [`listWorkbenchTableAiPresets`](#op-listworkbenchtableaipresets) | `GET /api/v1/workbench/tables/{table_id}/ai-presets` | read | `lists:read` | List Workbench Table Ai Presets |
+| [`listWorkbenchTables`](#op-listworkbenchtables) | `GET /api/v1/workbench/tables` | read | `lists:read` | List Workbench Tables |
+| [`listWorkbenchTargetFields`](#op-listworkbenchtargetfields) | `GET /api/v1/workbench/target-fields` | read | `lists:read` | List Workbench Target Fields |
+| [`listWorkbenchTriggers`](#op-listworkbenchtriggers) | `GET /api/v1/workbench/tables/{table_id}/triggers` | read | `lists:read` | List Workbench Triggers |
+| [`mapWorkbenchColumn`](#op-mapworkbenchcolumn) | `PUT /api/v1/workbench/tables/{table_id}/columns/{column_id}/mapping` | write | `lists:write` | Map Workbench Column |
+| [`migrateWorkbenchLegacyAiConfig`](#op-migrateworkbenchlegacyaiconfig) | `POST /api/v1/workbench/tables/{table_id}/ai/migrate-legacy` | write | `lists:write` | Migrate Workbench Legacy Ai Config |
+| [`pasteImportWorkbenchRows`](#op-pasteimportworkbenchrows) | `POST /api/v1/workbench/tables/{table_id}/import/paste` | write | `lists:write` | Paste Import Workbench Rows |
+| [`previewWorkbenchAi`](#op-previewworkbenchai) | `POST /api/v1/workbench/tables/{table_id}/ai/preview` | billable | `lists:run` | Preview Workbench Ai |
+| [`previewWorkbenchResearchImport`](#op-previewworkbenchresearchimport) | `POST /api/v1/workbench/tables/{table_id}/import/search/research/preview` | billable | `lists:run` | Preview Workbench Research Import |
+| [`previewWorkbenchSearchImport`](#op-previewworkbenchsearchimport) | `POST /api/v1/workbench/tables/{table_id}/import/search/preview` | read | `lists:read` | Preview Workbench Search Import |
+| [`queryWorkbenchRows`](#op-queryworkbenchrows) | `POST /api/v1/workbench/tables/{table_id}/rows/query` | read | `lists:read` | Query Workbench Rows |
+| [`quoteWorkbenchAiRun`](#op-quoteworkbenchairun) | `POST /api/v1/workbench/tables/{table_id}/ai/validate-credits` | read | `lists:read` | Quote Workbench Ai Run |
+| [`quoteWorkbenchFormulaGeneration`](#op-quoteworkbenchformulageneration) | `GET /api/v1/workbench/tables/{table_id}/formula-columns/generate-quote` | read | `lists:read` | Quote Workbench Formula Generation |
+| [`quoteWorkbenchUnlock`](#op-quoteworkbenchunlock) | `POST /api/v1/workbench/tables/{table_id}/unlock-quote` | read | `lists:read` | Quote Workbench Unlock |
+| [`quoteWorkbenchWaterfallRun`](#op-quoteworkbenchwaterfallrun) | `POST /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}/validate-credits` | read | `lists:read` | Quote Workbench Waterfall Run |
+| [`regenerateWorkbenchKey`](#op-regenerateworkbenchkey) | `POST /api/v1/workbench/tables/{table_id}/regenerate-key` | write | `lists:write` | Regenerate Workbench Key |
+| [`reviewWorkbenchFindPeopleCandidates`](#op-reviewworkbenchfindpeoplecandidates) | `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/review` | read | `lists:read` | Review Workbench Find People Candidates |
+| [`revokeWorkbenchColumnSource`](#op-revokeworkbenchcolumnsource) | `DELETE /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources/{source_type}` | destructive | `lists:delete` | Revoke Workbench Column Source |
+| [`runWorkbenchAi`](#op-runworkbenchai) | `POST /api/v1/workbench/tables/{table_id}/ai/run-all` | billable | `lists:run` | Run Workbench Ai |
+| [`runWorkbenchAiGroup`](#op-runworkbenchaigroup) | `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/run` | billable | `lists:run` | Run Workbench Ai Group |
+| [`runWorkbenchColumnAi`](#op-runworkbenchcolumnai) | `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai/run` | billable | `lists:run` | Run Workbench Column Ai |
+| [`runWorkbenchDefaultAi`](#op-runworkbenchdefaultai) | `POST /api/v1/workbench/tables/{table_id}/ai/run` | billable | `lists:run` | Run Workbench Default Ai |
+| [`runWorkbenchFindPeople`](#op-runworkbenchfindpeople) | `POST /api/v1/workbench/tables/{table_id}/find-people/{config_id}/run` | billable | `lists:run` | Run Workbench Find People |
+| [`runWorkbenchProviderScraper`](#op-runworkbenchproviderscraper) | `POST /api/v1/workbench/tables/{table_id}/scraper/providers/{provider}/runs` | billable | `lists:run` | Run Workbench Provider Scraper |
+| [`runWorkbenchScraper`](#op-runworkbenchscraper) | `POST /api/v1/workbench/tables/{table_id}/scraper/runs` | billable | `lists:run` | Run Workbench Scraper |
+| [`runWorkbenchWaterfall`](#op-runworkbenchwaterfall) | `POST /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}/run` | billable | `lists:run` | Run Workbench Waterfall |
+| [`saveScraperProviderConnection`](#op-savescraperproviderconnection) | `PUT /api/v1/workbench/scraper/providers/{provider}/connection` | write | `lists:write` | Save Scraper Provider Connection |
+| [`saveWorkbenchColumnAiConfig`](#op-saveworkbenchcolumnaiconfig) | `PUT /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai-config` | write | `lists:write` | Save Workbench Column Ai Config |
+| [`saveWorkbenchWaterfall`](#op-saveworkbenchwaterfall) | `POST /api/v1/workbench/tables/{table_id}/waterfall/configs` | write | `lists:write` | Save Workbench Waterfall |
+| [`sendWorkbenchRowsToSequence`](#op-sendworkbenchrowstosequence) | `POST /api/v1/workbench/tables/{table_id}/send-to-sequence` | external | `lists:run` | Send Workbench Rows To Sequence |
+| [`setWorkbenchAutoEnrich`](#op-setworkbenchautoenrich) | `PUT /api/v1/workbench/tables/{table_id}/auto-enrich` | billable | `lists:run` | Set Workbench Auto Enrich |
+| [`setWorkbenchSchedule`](#op-setworkbenchschedule) | `PUT /api/v1/workbench/tables/{table_id}/schedule` | billable | `lists:run` | Set Workbench Schedule |
+| [`skipWorkbenchFindPeopleCandidates`](#op-skipworkbenchfindpeoplecandidates) | `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/skip` | write | `lists:write` | Skip Workbench Find People Candidates |
+| [`suggestWorkbenchMappings`](#op-suggestworkbenchmappings) | `POST /api/v1/workbench/tables/{table_id}/suggest-mappings` | billable | `lists:run` | Suggest Workbench Mappings |
+| [`syncWorkbenchConnection`](#op-syncworkbenchconnection) | `POST /api/v1/workbench/tables/{table_id}/connections/{connection_id}/sync` | write | `lists:write` | Sync Workbench Connection |
+| [`testScraperProviderConnection`](#op-testscraperproviderconnection) | `POST /api/v1/workbench/scraper/providers/{provider}/connection/test` | external | `lists:run` | Test Scraper Provider Connection |
+| [`unlockWorkbenchRows`](#op-unlockworkbenchrows) | `POST /api/v1/workbench/tables/{table_id}/unlock-rows` | billable | `lists:run` | Unlock Workbench Rows |
+| [`updateWorkbenchAiGroup`](#op-updateworkbenchaigroup) | `PUT /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}` | write | `lists:write` | Update Workbench Ai Group |
+| [`updateWorkbenchPipeline`](#op-updateworkbenchpipeline) | `PUT /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}` | billable | `lists:run` | Update Workbench Pipeline |
+| [`updateWorkbenchRow`](#op-updateworkbenchrow) | `PATCH /api/v1/workbench/tables/{table_id}/rows/{row_id}` | write | `lists:write` | Update Workbench Row |
+| [`updateWorkbenchTable`](#op-updateworkbenchtable) | `PUT /api/v1/workbench/tables/{table_id}` | write | `lists:write` | Update Workbench Table |
+| [`updateWorkbenchTrigger`](#op-updateworkbenchtrigger) | `PUT /api/v1/workbench/tables/{table_id}/triggers/{trigger_id}` | billable | `lists:run` | Update Workbench Trigger |
+| [`updateWorkbenchWaterfall`](#op-updateworkbenchwaterfall) | `PUT /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}` | write | `lists:write` | Update Workbench Waterfall |
+
+---
+
+<a id="op-addworkbenchcolumn"></a>
+
+### `g8.api.workbench.addWorkbenchColumn(input)`
+
+**Add Workbench Column**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns`
+- operationId: `add_workbench_column_workbench_tables__table_id__columns_post` (also callable as `g8.api.call("add_workbench_column_workbench_tables__table_id__columns_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Add a column.
+
+`name` is the machine name rows are keyed by and is constrained to
+`^[a-z][a-z0-9_]*$`; `display_name` is free text. Getting those the wrong
+way round produces a column nothing can address.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `body` | `WorkbenchColumnCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchColumnCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.display_name` | `string` | yes | min length 1, max length 255 |
+| `body.name` | `string` | yes | Machine name: lowercase, starting with a letter. This is the key row data is addressed by, which is why it is constrained while `display_name` is not. min length 1, max length 255, pattern `^[a-z][a-z0-9_]*$` |
+| `body.column_type` | `"data" \| "formula" \| "raw_json"` | no | default `"data"` |
+| `body.data_type` | `"text" \| "number" \| "boolean" \| "json"` | no | default `"text"` |
+| `body.field_path` | `string \| null` | no | Path into a raw_json source column. |
+| `body.formula` | `string \| null` | no | Required for a formula column. |
+| `body.source` | `string` | no | default `"manual"` |
+| `body.source_column_id` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.addWorkbenchColumn({
+  path: { table_id: "id" },
+  body: { display_name: "Example", name: "Example" },
+});
+```
+
+---
+
+<a id="op-addworkbenchrow"></a>
+
+### `g8.api.workbench.addWorkbenchRow(input)`
+
+**Add Workbench Row**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/rows`
+- operationId: `add_workbench_row_workbench_tables__table_id__rows_post` (also callable as `g8.api.call("add_workbench_row_workbench_tables__table_id__rows_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Add one row. `data` is keyed by column MACHINE name, not display name.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `body` | `WorkbenchRowCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchRowCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.data` | `Record<string, unknown>` | no | Column machine name -> value. |
+| `body.raw_source_column_id` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.addWorkbenchRow({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-bulkdeleteworkbenchrows"></a>
+
+### `g8.api.workbench.bulkDeleteWorkbenchRows(input)`
+
+**Bulk Delete Workbench Rows**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/rows/bulk-delete`
+- operationId: `bulk_delete_workbench_rows_workbench_tables__table_id__rows_bulk_delete_post` (also callable as `g8.api.call("bulk_delete_workbench_rows_workbench_tables__table_id__rows_bulk_delete_post", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Delete rows by id, or everything EXCEPT a set.
+
+`select_all` must be sent explicitly to delete everything. An empty
+selection is rejected rather than treated as a delete-all - the app's own
+comment records why: "a client bug can never turn 'nothing selected' into
+'delete the whole table'".
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `body` | `WorkbenchRowsDeleteRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchRowsDeleteRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.select_all` | `boolean` | no | default `false` |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.bulkDeleteWorkbenchRows({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-bulkextractworkbenchcolumns"></a>
+
+### `g8.api.workbench.bulkExtractWorkbenchColumns(input)`
+
+**Bulk Extract Workbench Columns**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns/bulk-extract`
+- operationId: `bulk_extract_workbench_columns_workbench_tables__table_id__columns_bulk_extract_post` (also callable as `g8.api.call("bulk_extract_workbench_columns_workbench_tables__table_id__columns_bulk_extract_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Up to 50 extractions in one pass. FREE.
+
+Read the per-extraction result rather than the HTTP status: one bad
+`field_path` is reported, not fatal to the other 49.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `BulkExtractRequest` | yes | Request body; fields below. |
+
+Body fields (`BulkExtractRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.extractions` | `Array<ExtractColumnRequest>` | yes | min items 1, max items 50 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.bulkExtractWorkbenchColumns({
+  path: { table_id: "id" },
+  body: {
+    extractions: [
+      {
+        column_name: "Example",
+        display_name: "Example",
+        field_path: "example",
+        source_column_id: 123,
+      },
+    ],
+  },
+});
+```
+
+---
+
+<a id="op-checkworkbenchscrapertoken"></a>
+
+### `g8.api.workbench.checkWorkbenchScraperToken(input)`
+
+**Check Workbench Scraper Token**
+
+- HTTP: `GET /api/v1/workbench/scraper/providers/{provider}/check-token`
+- operationId: `check_workbench_scraper_token_workbench_scraper_providers__provider__check_token_get` (also callable as `g8.api.call("check_workbench_scraper_token_workbench_scraper_providers__provider__check_token_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Is the organisation's scraper credential present and working? FREE.
+
+A connectivity check against the provider, not a scrape. Call it before a
+run so a missing credential fails here rather than halfway through.
+
+`provider` is a path parameter rather than a literal segment, matching
+`/crm-syncs/{provider}/status`. Today it resolves to the one connected
+provider the app supports; the handler takes no provider argument, so the
+value selects the route rather than being forwarded.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which connected scraper provider. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.checkWorkbenchScraperToken({ path: { provider: "apify" } });
+```
+
+---
+
+<a id="op-computeworkbenchformula"></a>
+
+### `g8.api.workbench.computeWorkbenchFormula(input)`
+
+**Compute Workbench Formula**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/compute`
+- operationId: `compute_workbench_formula_workbench_tables__table_id__columns__col_id__compute_post` (also callable as `g8.api.call("compute_workbench_formula_workbench_tables__table_id__columns__col_id__compute_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Evaluate a formula column across every row. FREE.
+
+The formula runs locally - no model, no provider, no credit - so this is
+safe to re-run as often as the inputs change. Per-row failures come back in
+`errors` rather than failing the call.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | The formula column to evaluate. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.computeWorkbenchFormula({ path: { table_id: "id", col_id: 123 } });
+```
+
+---
+
+<a id="op-configureworkbenchai"></a>
+
+### `g8.api.workbench.configureWorkbenchAi(input)`
+
+**Configure Workbench Ai**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/configure`
+- operationId: `configure_workbench_ai_workbench_tables__table_id__ai_configure_post` (also callable as `g8.api.call("configure_workbench_ai_workbench_tables__table_id__ai_configure_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Set the table-level AI pass. FREE - saving runs nothing.
+
+`output_columns` decides which columns the pass writes into; they are
+created if missing. `multi_row_output` lets one source row produce up to
+`max_rows_per_source` rows, which multiplies what a later run costs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SaveStagingAIConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`SaveStagingAIConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt` | `string` | yes | min length 1 |
+| `body.entity_type` | `"contact" \| "company" \| null` | no |  |
+| `body.max_rows_per_source` | `integer` | no | default `50`, min 1, max 50 |
+| `body.model` | `string` | no | default `"openai/gpt-4o"` |
+| `body.multi_row_output` | `boolean` | no | default `false` |
+| `body.output_columns` | `Array<OutputColumnDef>` | no |  |
+| `body.usecase` | `string` | no | default `"content_generation"` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.configureWorkbenchAi({ path: { table_id: "id" }, body: { prompt: "example" } });
+```
+
+---
+
+<a id="op-configureworkbenchcolumnsource"></a>
+
+### `g8.api.workbench.configureWorkbenchColumnSource(input)`
+
+**Configure Workbench Column Source**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources`
+- operationId: `configure_workbench_column_source_workbench_tables__table_id__columns__col_id__sources_post` (also callable as `g8.api.call("configure_workbench_column_source_workbench_tables__table_id__columns__col_id__sources_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Point an ingest source at a column. Free.
+
+The credential this mints is shown ONCE, in this response. There is no
+second read - `GET /workbench/source-credentials` lists metadata only.
+
+`rotate_existing` is an explicit acknowledgement rather than a default:
+rotating invalidates the current credential IMMEDIATELY, so anything
+already posting with it stops at that instant.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+| `body` | `ConfigureRawSourceRequest` | yes | Request body; fields below. |
+
+Body fields (`ConfigureRawSourceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.config` | `Record<string, unknown> \| null` | no | Source-specific settings. |
+| `body.expires_in_days` | `integer` | no | Credential lifetime, applied when one is first generated. default `90`, min 1, max 365 |
+| `body.label` | `string \| null` | no | max length 255 |
+| `body.rotate_existing` | `boolean` | no | Explicitly acknowledge that an existing credential is invalidated IMMEDIATELY. Anything already posting with the old key stops. default `false` |
+| `body.source_type` | `"webhook" \| "legacy_webhook" \| "scraper_bot"` | no | Which kind of source feeds this column. default `"webhook"` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.configureWorkbenchColumnSource({ path: { table_id: "id", col_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-configureworkbenchfindpeople"></a>
+
+### `g8.api.workbench.configureWorkbenchFindPeople(input)`
+
+**Configure Workbench Find People**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/find-people/configure`
+- operationId: `configure_workbench_find_people_workbench_tables__table_id__find_people_configure_post` (also callable as `g8.api.call("configure_workbench_find_people_workbench_tables__table_id__find_people_configure_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Search for contacts at each company row. SPENDS CREDITS.
+
+This queries the licensed people corpus and writes the matches into a
+contact table. The rows land LOCKED: the search is what this costs, and
+revealing each contact's details then costs a further credit per row
+through `unlock-rows`.
+
+`max_total_people` is the real cost control - it is a hard ceiling across
+every company row, not a per-company hint. `broad_search_acknowledged` must
+be set to run with NO filters, because an unfiltered search returns the
+widest and most expensive possible result.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `ConfigureStagingFindPeopleRequest` | yes | Request body; fields below. |
+
+Body fields (`ConfigureStagingFindPeopleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.domain_column` | `string` | yes | Column holding company domains or LinkedIn URLs. min length 1 |
+| `body.auto_create_columns` | `boolean` | no | default `true` |
+| `body.broad_search_acknowledged` | `boolean` | no | Confirm an EMPTY filter set is intentional. An unfiltered search returns the widest - and most expensive - possible result. default `false` |
+| `body.company_name_column` | `string \| null` | no |  |
+| `body.create_destination_table` | `boolean` | no | default `false` |
+| `body.destination_table_id` | `string \| null` | no |  |
+| `body.destination_table_name` | `string \| null` | no | max length 255 |
+| `body.lookup_field` | `"COMPANY_DOMAIN" \| "COMPANY_LINKEDIN_URL"` | no | default `"COMPANY_DOMAIN"` |
+| `body.max_people_per_company` | `integer` | no | default `5`, min 1, max 100 |
+| `body.max_total_people` | `integer` | no | Hard ceiling across every company row. default `250`, min 1, max 10000 |
+| `body.name` | `string` | no | default `"Find People"`, min length 1, max length 255 |
+| `body.search_filters` | `Array<FindPeopleSearchFilter>` | no |  |
+| `body.skip_existing` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.configureWorkbenchFindPeople({ path: { table_id: "id" }, body: { domain_column: "acme.com" } });
+```
+
+---
+
+<a id="op-createworkbenchaigroup"></a>
+
+### `g8.api.workbench.createWorkbenchAiGroup(input)`
+
+**Create Workbench Ai Group**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/groups/config`
+- operationId: `create_workbench_ai_group_workbench_tables__table_id__ai_groups_config_post` (also callable as `g8.api.call("create_workbench_ai_group_workbench_tables__table_id__ai_groups_config_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Create an AI group on this table. FREE - saving never runs.
+
+`config.run_immediately` is pinned to false by the app, so this cannot
+become a spend by accident. Run the group explicitly afterwards.
+
+Two settings decide most of what a later run costs:
+`config.skip_existing_values` (skip rows that already have a value) and
+`config.skip_recently_enriched` (skip rows touched in the last 30 days).
+Both default to true; turning either off re-buys data you already have.
+
+The path is `/ai/groups/config` rather than a POST to `/ai/groups`, matching
+the app exactly - a different spelling here would be a second way to say the
+same thing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SaveAIConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`SaveAIConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.config` | `AIEnrichmentConfigDto` | yes |  |
+| `body.run_immediately` | `false` | no | Always false. Saving never runs - the app refuses immediate execution so a save can never become an unpriced spend. default `false` |
+| `body.target_records` | `Array<string (uuid)> \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.createWorkbenchAiGroup({
+  path: { table_id: "id" },
+  body: {
+    config: {
+      config: {},
+      input_mapping: ["example"],
+      model: "example",
+      outputs: [{ name: "Example", type: "example" }],
+      prompt: "example",
+      usecase: "example",
+    },
+  },
+});
+```
+
+---
+
+<a id="op-createworkbenchbindings"></a>
+
+### `g8.api.workbench.createWorkbenchBindings(input)`
+
+**Create Workbench Bindings**
+
+- HTTP: `POST /api/v1/workbench-bindings`
+- operationId: `create_workbench_bindings_workbench_bindings_post` (also callable as `g8.api.call("create_workbench_bindings_workbench_bindings_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Show a workflow's outputs as columns on a list. FREE.
+
+Requires WRITE access to the list. The columns appear on the list's next
+column fetch; their values fill in when the workflow runs.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `CreateWorkbenchBindingsRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateWorkbenchBindingsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.bindings` | `Array<WorkbenchBindingItem>` | yes | At least one. The app refuses an empty set; so does this. min items 1 |
+| `body.list_id` | `integer` | yes | The list whose grid gains the columns. |
+| `body.workflow_id` | `string` | yes | The workflow producing the values. |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.createWorkbenchBindings({
+  body: {
+    bindings: [
+      {
+        column_name: "Example",
+        column_type: "computed",
+        node_id: "id",
+        output_path: "example",
+      },
+    ],
+    list_id: 123,
+    workflow_id: "id",
+  },
+});
+```
+
+---
+
+<a id="op-createworkbenchconnection"></a>
+
+### `g8.api.workbench.createWorkbenchConnection(input)`
+
+**Create Workbench Connection**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/connections`
+- operationId: `create_workbench_connection_workbench_tables__table_id__connections_post` (also callable as `g8.api.call("create_workbench_connection_workbench_tables__table_id__connections_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Connect this table to another table in your organisation, so rows are
+copied across. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `TableConnectionRequest` | yes | Request body; fields below. |
+
+Body fields (`TableConnectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.destination_table_id` | `string (uuid)` | yes |  |
+| `body.field_mapping` | `Record<string, string> \| null` | no | Source column -> destination. |
+| `body.filter_conditions` | `Record<string, unknown> \| null` | no |  |
+| `body.sync_mode` | `"append"` | no | default `"append"` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.createWorkbenchConnection({
+  path: { table_id: "id" },
+  body: { destination_table_id: "00000000-0000-0000-0000-000000000000" },
+});
+```
+
+---
+
+<a id="op-createworkbenchformulacolumns"></a>
+
+### `g8.api.workbench.createWorkbenchFormulaColumns(input)`
+
+**Create Workbench Formula Columns**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/formula-columns`
+- operationId: `create_workbench_formula_columns_workbench_tables__table_id__formula_columns_post` (also callable as `g8.api.call("create_workbench_formula_columns_workbench_tables__table_id__formula_columns_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Create a formula column with one child column per output. FREE.
+
+You supply the formula, so nothing authors it and nothing is charged. The
+AI-authoring path is the one that costs, and
+`formula-columns/generate-quote` prices it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `CreateFormulaColumnsRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateFormulaColumnsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.formula` | `string` | yes | The G8X formula expression. min length 1 |
+| `body.output_columns` | `Array<FormulaOutputColumnDef>` | yes | min items 1, max items 20 |
+| `body.description` | `string \| null` | no | max length 4000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.createWorkbenchFormulaColumns({
+  path: { table_id: "id" },
+  body: {
+    formula: "example",
+    output_columns: [{ display_name: "Example", name: "Example" }],
+  },
+});
+```
+
+---
+
+<a id="op-createworkbenchpipeline"></a>
+
+### `g8.api.workbench.createWorkbenchPipeline(input)`
+
+**Create Workbench Pipeline**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/pipelines`
+- operationId: `create_workbench_pipeline_workbench_tables__table_id__pipelines_post` (also callable as `g8.api.call("create_workbench_pipeline_workbench_tables__table_id__pipelines_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Create a pipeline that processes new rows step by step. CAN ARM SPEND.
+
+`enabled` defaults to false. Enabled, it runs its AI and waterfall steps -
+each charged per row - on every row that arrives.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `CreateWorkbenchPipelineRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateWorkbenchPipelineRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes |  |
+| `body.start` | `PipelineStartConfig` | yes |  |
+| `body.enabled` | `boolean` | no | default `false` |
+| `body.steps` | `Array<WorkbenchPipelineStep>` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.createWorkbenchPipeline({
+  path: { table_id: "id" },
+  body: { name: "Example", start: { type: "email_pdf" } },
+});
+```
+
+---
+
+<a id="op-createworkbenchtable"></a>
+
+### `g8.api.workbench.createWorkbenchTable(input)`
+
+**Create Workbench Table**
+
+- HTTP: `POST /api/v1/workbench/tables`
+- operationId: `create_workbench_table_workbench_tables_post` (also callable as `g8.api.call("create_workbench_table_workbench_tables_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Create an empty table.
+
+`entity_type` decides what the rows become on export and is settable here,
+at creation - which is why the update model does not offer it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body` | `WorkbenchTableCreateRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchTableCreateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.name` | `string` | yes | Table name. min length 1 |
+| `body.description` | `string \| null` | no |  |
+| `body.entity_type` | `"contact" \| "company" \| null` | no | What the rows will become on export. Settable once, at creation. |
+
+**Returns** `ApiResponse_WorkbenchTable_`: the envelope `{ data: WorkbenchTable, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`WorkbenchTable` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `created_at` | `string (date-time) \| null` | no |  |
+| `description` | `string \| null` | no |  |
+| `entity_type` | `string \| null` | no | contact or company. |
+| `id` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `row_count` | `integer \| null` | no |  |
+| `updated_at` | `string (date-time) \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.createWorkbenchTable({ body: { name: "Example" } });
+```
+
+---
+
+<a id="op-createworkbenchtrigger"></a>
+
+### `g8.api.workbench.createWorkbenchTrigger(input)`
+
+**Create Workbench Trigger**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/triggers`
+- operationId: `create_workbench_trigger_workbench_tables__table_id__triggers_post` (also callable as `g8.api.call("create_workbench_trigger_workbench_tables__table_id__triggers_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+React to rows as they arrive or change. CAN ARM ONGOING SPEND.
+
+`enabled` DEFAULTS TO TRUE. With `action_type: run_ai`, every matching row
+is enriched, and charged, as it arrives. `webhook_notify` URLs are checked
+and unsafe targets refused.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `CreateTriggerRequest` | yes | Request body; fields below. |
+
+Body fields (`CreateTriggerRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.action_type` | `"run_ai" \| "run_formula" \| "export" \| "webhook_notify"` | yes |  |
+| `body.event_type` | `"ingest" \| "ai_complete" \| "status_change"` | yes |  |
+| `body.name` | `string` | yes | min length 1, max length 255 |
+| `body.action_config` | `Record<string, unknown>` | no |  |
+| `body.conditions` | `Record<string, unknown> \| null` | no |  |
+| `body.enabled` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.createWorkbenchTrigger({
+  path: { table_id: "id" },
+  body: { action_type: "run_ai", event_type: "ingest", name: "Example" },
+});
+```
+
+---
+
+<a id="op-deletescraperproviderconnection"></a>
+
+### `g8.api.workbench.deleteScraperProviderConnection(input)`
+
+**Delete Scraper Provider Connection**
+
+- HTTP: `DELETE /api/v1/workbench/scraper/providers/{provider}/connection`
+- operationId: `delete_scraper_provider_connection_workbench_scraper_providers__provider__connection_delete` (also callable as `g8.api.call("delete_scraper_provider_connection_workbench_scraper_providers__provider__connection_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Disconnect your provider account. Provider scraper runs stop working.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which scraper provider. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteScraperProviderConnection({ path: { provider: "apify" } });
+```
+
+---
+
+<a id="op-deleteworkbenchaigroup"></a>
+
+### `g8.api.workbench.deleteWorkbenchAiGroup(input)`
+
+**Delete Workbench Ai Group**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}`
+- operationId: `delete_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__delete` (also callable as `g8.api.call("delete_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Remove an AI group. Free.
+
+Values the group already wrote into columns stay - you are deleting the
+instruction, not the data you paid for.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | AI group id (starts with `ai_enrich`). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchAiGroup({ path: { table_id: "id", group_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchbinding"></a>
+
+### `g8.api.workbench.deleteWorkbenchBinding(input)`
+
+**Delete Workbench Binding**
+
+- HTTP: `DELETE /api/v1/workbench-bindings/{binding_id}`
+- operationId: `delete_workbench_binding_workbench_bindings__binding_id__delete` (also callable as `g8.api.call("delete_workbench_binding_workbench_bindings__binding_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Remove one binding. FREE.
+
+The column leaves the grid on the next column fetch. Requires WRITE access
+to the list the binding sits on; the app resolves that list from the
+binding itself, so a binding on a list the key cannot write is refused.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.binding_id` | `string` | yes | The binding to remove. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchBinding({ path: { binding_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchcolumn"></a>
+
+### `g8.api.workbench.deleteWorkbenchColumn(input)`
+
+**Delete Workbench Column**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/columns/{column_id}`
+- operationId: `delete_workbench_column_workbench_tables__table_id__columns__column_id__delete` (also callable as `g8.api.call("delete_workbench_column_workbench_tables__table_id__columns__column_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Delete a column and the values in it, on every row.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `path.column_id` | `integer` | yes | Column id. |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchColumn({ path: { table_id: "id", column_id: 123 } });
+```
+
+---
+
+<a id="op-deleteworkbenchconnection"></a>
+
+### `g8.api.workbench.deleteWorkbenchConnection(input)`
+
+**Delete Workbench Connection**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/connections/{connection_id}`
+- operationId: `delete_workbench_connection_workbench_tables__table_id__connections__connection_id__delete` (also callable as `g8.api.call("delete_workbench_connection_workbench_tables__table_id__connections__connection_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Remove a connection. Rows already copied stay where they are.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.connection_id` | `integer` | yes | Connection id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchConnection({ path: { table_id: "id", connection_id: 123 } });
+```
+
+---
+
+<a id="op-deleteworkbenchfindpeopleconfig"></a>
+
+### `g8.api.workbench.deleteWorkbenchFindPeopleConfig(input)`
+
+**Delete Workbench Find People Config**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/find-people/{config_id}`
+- operationId: `delete_workbench_find_people_config_workbench_tables__table_id__find_people__config_id__delete` (also callable as `g8.api.call("delete_workbench_find_people_config_workbench_tables__table_id__find_people__config_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Remove a find-people configuration. Free. Contacts already found stay.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.config_id` | `string` | yes | Find-people configuration id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchFindPeopleConfig({ path: { table_id: "id", config_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchpipeline"></a>
+
+### `g8.api.workbench.deleteWorkbenchPipeline(input)`
+
+**Delete Workbench Pipeline**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}`
+- operationId: `delete_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__delete` (also callable as `g8.api.call("delete_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Delete a pipeline.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.pipeline_id` | `string` | yes | Pipeline id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchPipeline({ path: { table_id: "id", pipeline_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchschedule"></a>
+
+### `g8.api.workbench.deleteWorkbenchSchedule(input)`
+
+**Delete Workbench Schedule**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/schedule`
+- operationId: `delete_workbench_schedule_workbench_tables__table_id__schedule_delete` (also callable as `g8.api.call("delete_workbench_schedule_workbench_tables__table_id__schedule_delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Remove the schedule. Free, and the fastest way to stop recurring spend.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchSchedule({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchtable"></a>
+
+### `g8.api.workbench.deleteWorkbenchTable(input)`
+
+**Delete Workbench Table**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}`
+- operationId: `delete_workbench_table_workbench_tables__table_id__delete` (also callable as `g8.api.call("delete_workbench_table_workbench_tables__table_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Delete the table AND every row in it. Not recoverable through this API.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchTable({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-deleteworkbenchtrigger"></a>
+
+### `g8.api.workbench.deleteWorkbenchTrigger(input)`
+
+**Delete Workbench Trigger**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/triggers/{trigger_id}`
+- operationId: `delete_workbench_trigger_workbench_tables__table_id__triggers__trigger_id__delete` (also callable as `g8.api.call("delete_workbench_trigger_workbench_tables__table_id__triggers__trigger_id__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Delete a trigger. Stops whatever spend it armed.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.trigger_id` | `integer` | yes | Trigger id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.deleteWorkbenchTrigger({ path: { table_id: "id", trigger_id: 123 } });
+```
+
+---
+
+<a id="op-discoverworkbenchfields"></a>
+
+### `g8.api.workbench.discoverWorkbenchFields(input)`
+
+**Discover Workbench Fields**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/discover-fields`
+- operationId: `discover_workbench_fields_workbench_tables__table_id__discover_fields_post` (also callable as `g8.api.call("discover_workbench_fields_workbench_tables__table_id__discover_fields_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+List the JSON paths present inside a raw column. FREE.
+
+Despite the name this calls no provider and spends nothing - it samples
+rows the customer already imported and reports the shapes it found. Call it
+before `columns/extract` to learn what `field_path` values exist.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `DiscoverFieldsRequest` | yes | Request body; fields below. |
+
+Body fields (`DiscoverFieldsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.source_column_id` | `integer` | yes | The raw JSON column to scan. |
+| `body.sample_size` | `integer` | no | Rows to sample. default `100`, min 1, max 1000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.discoverWorkbenchFields({ path: { table_id: "id" }, body: { source_column_id: 123 } });
+```
+
+---
+
+<a id="op-estimateworkbenchproviderscrapercredits"></a>
+
+### `g8.api.workbench.estimateWorkbenchProviderScraperCredits(input)`
+
+**Estimate Workbench Provider Scraper Credits**
+
+- HTTP: `GET /api/v1/workbench/scraper/providers/{provider}/credit-estimate`
+- operationId: `estimate_workbench_provider_scraper_credits_workbench_scraper_providers__provider__credit_estimate_get` (also callable as `g8.api.call("estimate_workbench_provider_scraper_credits_workbench_scraper_providers__provider__credit_estimate_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price a run on a connected scraper provider. CHARGES NOTHING.
+
+Every component broken out: the scraper credits, the per-result rate, the
+post-scrape enrichment, the live balance and what would be left. Nothing is
+scraped.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which connected scraper provider. |
+| `query.table_id` | `string` | yes | The table the results would land in. |
+| `query.max_results` | `integer` | yes | Ceiling on results the run would return. |
+| `query.preset_id` | `string \| null` | no | Preset to price against. Omit for the provider's default rate. |
+| `query.auto_enrich` | `boolean` | no | Price the post-scrape enrichment too. default `false` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.estimateWorkbenchProviderScraperCredits({
+  path: { provider: "apify" },
+  query: { table_id: "id", max_results: 1 },
+});
+```
+
+---
+
+<a id="op-estimateworkbenchscrapercredits"></a>
+
+### `g8.api.workbench.estimateWorkbenchScraperCredits(input)`
+
+**Estimate Workbench Scraper Credits**
+
+- HTTP: `GET /api/v1/workbench/scraper/credit-estimate`
+- operationId: `estimate_workbench_scraper_credits_workbench_scraper_credit_estimate_get` (also callable as `g8.api.call("estimate_workbench_scraper_credits_workbench_scraper_credit_estimate_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price a built-in scraper run. CHARGES NOTHING.
+
+A worst-case quote: what `max_results` rows would cost, plus the
+post-scrape enrichment when `auto_enrich` is set, against the live balance.
+Nothing is scraped and no credit moves.
+
+The estimate and the run share one costing function on purpose, so the
+number quoted here is the number the run's own credit gate enforces.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.table_id` | `string` | yes | The table the results would land in. |
+| `query.max_results` | `integer` | yes | Ceiling on results the run would return. |
+| `query.auto_enrich` | `boolean` | no | Price the post-scrape enrichment too. Leave false and the quote covers the scrape ALONE - which is the number people misread. default `false` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.estimateWorkbenchScraperCredits({ query: { table_id: "id", max_results: 1 } });
+```
+
+---
+
+<a id="op-expandworkbencharray"></a>
+
+### `g8.api.workbench.expandWorkbenchArray(input)`
+
+**Expand Workbench Array**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/expand-array`
+- operationId: `expand_workbench_array_workbench_tables__table_id__expand_array_post` (also callable as `g8.api.call("expand_workbench_array_workbench_tables__table_id__expand_array_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Fan an array field out into one row per element. FREE.
+
+This MULTIPLIES the row count: a table of 1,000 rows whose array averages
+ten elements becomes 10,000 rows. Nothing is charged for the expansion
+itself, but every later per-row operation is then ten times the size.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `ExpandArrayRequest` | yes | Request body; fields below. |
+
+Body fields (`ExpandArrayRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.array_field_path` | `string` | yes | min length 1 |
+| `body.keep_parent_fields` | `boolean` | no | Copy the parent row's other fields onto each new row. default `true` |
+| `body.source_column_id` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.expandWorkbenchArray({ path: { table_id: "id" }, body: { array_field_path: "example" } });
+```
+
+---
+
+<a id="op-exportworkbenchaifindpeople"></a>
+
+### `g8.api.workbench.exportWorkbenchAiFindPeople(input)`
+
+**Export Workbench Ai Find People**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/export`
+- operationId: `export_workbench_ai_find_people_workbench_tables__table_id__ai_groups__group_id__find_people_export_post` (also callable as `g8.api.call("export_workbench_ai_find_people_workbench_tables__table_id__ai_groups__group_id__find_people_export_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Copy chosen candidates into the group's people table. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | The AI group id. |
+| `body` | `UpdateStagingAIFindPeopleCandidatesRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateStagingAIFindPeopleCandidatesRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.candidate_ids` | `Array<string>` | no | min items 1 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.exportWorkbenchAiFindPeople({ path: { table_id: "id", group_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-exportworkbenchtable"></a>
+
+### `g8.api.workbench.exportWorkbenchTable(input)`
+
+**Export Workbench Table**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/export`
+- operationId: `export_workbench_table_workbench_tables__table_id__export_post` (also callable as `g8.api.call("export_workbench_table_workbench_tables__table_id__export_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Export rows into an audience list. THIS CREATES REAL CRM RECORDS.
+
+A destination is REQUIRED - either `list_id`, or `create_new_list` with a
+`new_list_name`. The app would otherwise accept a body naming neither and
+decide for itself where a customer's data lands.
+
+`enrich_after_export` and its enrichment configs are deliberately not
+accepted here: they spend credits, and a spend should not be a side effect
+of an export call.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `body` | `WorkbenchExportRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchExportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.create_new_list` | `boolean` | no | default `false` |
+| `body.entity_type` | `"contact" \| "company"` | no | default `"contact"` |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.export_filter` | `Record<string, unknown> \| null` | no |  |
+| `body.export_verified_only` | `boolean` | no | Only rows whose email passed verification. default `false` |
+| `body.list_id` | `integer \| null` | no | Existing list to export into. |
+| `body.new_list_name` | `string \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | max items 100000 |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.exportWorkbenchTable({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-extractworkbenchcolumn"></a>
+
+### `g8.api.workbench.extractWorkbenchColumn(input)`
+
+**Extract Workbench Column**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns/extract`
+- operationId: `extract_workbench_column_workbench_tables__table_id__columns_extract_post` (also callable as `g8.api.call("extract_workbench_column_workbench_tables__table_id__columns_extract_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Create a column from one JSON path, filled across every row. FREE.
+
+`field_path` comes from `discover-fields`. Pure local extraction: no
+provider, no model, no credit.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `ExtractColumnRequest` | yes | Request body; fields below. |
+
+Body fields (`ExtractColumnRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.column_name` | `string` | yes | min length 1, max length 255, pattern `^[a-z][a-z0-9_]*$` |
+| `body.display_name` | `string` | yes | min length 1, max length 255 |
+| `body.field_path` | `string` | yes | Dot path inside the raw JSON. min length 1 |
+| `body.source_column_id` | `integer` | yes |  |
+| `body.data_type` | `"text" \| "number" \| "boolean" \| "json"` | no | default `"text"` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.extractWorkbenchColumn({
+  path: { table_id: "id" },
+  body: {
+    column_name: "Example",
+    display_name: "Example",
+    field_path: "example",
+    source_column_id: 123,
+  },
+});
+```
+
+---
+
+<a id="op-generateworkbenchprompt"></a>
+
+### `g8.api.workbench.generateWorkbenchPrompt(input)`
+
+**Generate Workbench Prompt**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/generate-prompt`
+- operationId: `generate_workbench_prompt_workbench_tables__table_id__ai_generate_prompt_post` (also callable as `g8.api.call("generate_workbench_prompt_workbench_tables__table_id__ai_generate_prompt_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Draft an AI prompt from this table's columns. COSTS AN AI CALL.
+
+A model reads the column names and five sample rows and writes a prompt for
+you. It does not debit the credit balance, but it is a real model call, so
+it is not free to run in a loop.
+
+The returned prompt is a draft: nothing is configured and nothing is
+enriched until you save it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `StagingPromptGeneratorRequest` | yes | Request body; fields below. |
+
+Body fields (`StagingPromptGeneratorRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.task_description` | `string` | yes | What the AI pass should do, in plain words. min length 1 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.generateWorkbenchPrompt({ path: { table_id: "id" }, body: { task_description: "example" } });
+```
+
+---
+
+<a id="op-getscraperproviderconnection"></a>
+
+### `g8.api.workbench.getScraperProviderConnection(input)`
+
+**Get Scraper Provider Connection**
+
+- HTTP: `GET /api/v1/workbench/scraper/providers/{provider}/connection`
+- operationId: `get_scraper_provider_connection_workbench_scraper_providers__provider__connection_get` (also callable as `g8.api.call("get_scraper_provider_connection_workbench_scraper_providers__provider__connection_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Whether your provider account is connected. Free. The token is never returned.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which scraper provider. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getScraperProviderConnection({ path: { provider: "apify" } });
+```
+
+---
+
+<a id="op-getworkbenchaifindpeoplerow"></a>
+
+### `g8.api.workbench.getWorkbenchAiFindPeopleRow(input)`
+
+**Get Workbench Ai Find People Row**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/rows/{source_row_id}`
+- operationId: `get_workbench_ai_find_people_row_workbench_tables__table_id__ai_groups__group_id__find_people_rows__source_row_id__get` (also callable as `g8.api.call("get_workbench_ai_find_people_row_workbench_tables__table_id__ai_groups__group_id__find_people_rows__source_row_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The people an AI find-people group found for one row. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | The AI group id. |
+| `path.source_row_id` | `integer` | yes | The company row the candidates were found for. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchAiFindPeopleRow({ path: { table_id: "id", group_id: "id", source_row_id: 123 } });
+```
+
+---
+
+<a id="op-getworkbenchaigroup"></a>
+
+### `g8.api.workbench.getWorkbenchAiGroup(input)`
+
+**Get Workbench Ai Group**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}`
+- operationId: `get_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__get` (also callable as `g8.api.call("get_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read one AI group's configuration. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | The AI group id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchAiGroup({ path: { table_id: "id", group_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchanalytics"></a>
+
+### `g8.api.workbench.getWorkbenchAnalytics(input)`
+
+**Get Workbench Analytics**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/analytics`
+- operationId: `get_workbench_analytics_workbench_tables__table_id__analytics_get` (also callable as `g8.api.call("get_workbench_analytics_workbench_tables__table_id__analytics_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Row status distribution, row counts and column fill rates. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchAnalytics({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchcolumnaiconfig"></a>
+
+### `g8.api.workbench.getWorkbenchColumnAiConfig(input)`
+
+**Get Workbench Column Ai Config**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai-config`
+- operationId: `get_workbench_column_ai_config_workbench_tables__table_id__columns__col_id__ai_config_get` (also callable as `g8.api.call("get_workbench_column_ai_config_workbench_tables__table_id__columns__col_id__ai_config_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read one column's AI pass. FREE.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchColumnAiConfig({ path: { table_id: "id", col_id: 123 } });
+```
+
+---
+
+<a id="op-getworkbenchhistory"></a>
+
+### `g8.api.workbench.getWorkbenchHistory(input)`
+
+**Get Workbench History**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/history`
+- operationId: `get_workbench_history_workbench_tables__table_id__history_get` (also callable as `g8.api.call("get_workbench_history_workbench_tables__table_id__history_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+What has run on this table - imports, AI passes, exports - newest first.
+Free. Redacted: no credentials and no row data.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `query.limit` | `integer` | no | default `25` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchHistory({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchlockedrowcount"></a>
+
+### `g8.api.workbench.getWorkbenchLockedRowCount(input)`
+
+**Get Workbench Locked Row Count**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/locked-row-count`
+- operationId: `get_workbench_locked_row_count_workbench_tables__table_id__locked_row_count_get` (also callable as `g8.api.call("get_workbench_locked_row_count_workbench_tables__table_id__locked_row_count_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+How many rows are still locked. FREE.
+
+At one credit per row this number IS the price of unlocking everything.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchLockedRowCount({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchmappingsuggestion"></a>
+
+### `g8.api.workbench.getWorkbenchMappingSuggestion(input)`
+
+**Get Workbench Mapping Suggestion**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/suggest-mappings/{job_id}`
+- operationId: `get_workbench_mapping_suggestion_workbench_tables__table_id__suggest_mappings__job_id__get` (also callable as `g8.api.call("get_workbench_mapping_suggestion_workbench_tables__table_id__suggest_mappings__job_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Collect a mapping suggestion. FREE - polling costs nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.job_id` | `string` | yes | Job id returned by `suggest-mappings`. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchMappingSuggestion({ path: { table_id: "id", job_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchpipeline"></a>
+
+### `g8.api.workbench.getWorkbenchPipeline(input)`
+
+**Get Workbench Pipeline**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}`
+- operationId: `get_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__get` (also callable as `g8.api.call("get_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read one pipeline. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.pipeline_id` | `string` | yes | Pipeline id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchPipeline({ path: { table_id: "id", pipeline_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchrow"></a>
+
+### `g8.api.workbench.getWorkbenchRow(input)`
+
+**Get Workbench Row**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/rows/{row_id}`
+- operationId: `get_workbench_row_workbench_tables__table_id__rows__row_id__get` (also callable as `g8.api.call("get_workbench_row_workbench_tables__table_id__rows__row_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read one row. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.row_id` | `integer` | yes | Row id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchRow({ path: { table_id: "id", row_id: 123 } });
+```
+
+---
+
+<a id="op-getworkbenchschedule"></a>
+
+### `g8.api.workbench.getWorkbenchSchedule(input)`
+
+**Get Workbench Schedule**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/schedule`
+- operationId: `get_workbench_schedule_workbench_tables__table_id__schedule_get` (also callable as `g8.api.call("get_workbench_schedule_workbench_tables__table_id__schedule_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read the table's schedule. FREE.
+
+Worth reading before an audit of where credit is going: a schedule is the
+one spend on this surface that nobody triggers by hand.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchSchedule({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchscraperrun"></a>
+
+### `g8.api.workbench.getWorkbenchScraperRun(input)`
+
+**Get Workbench Scraper Run**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/scraper/runs/{run_id}`
+- operationId: `get_workbench_scraper_run_workbench_tables__table_id__scraper_runs__run_id__get` (also callable as `g8.api.call("get_workbench_scraper_run_workbench_tables__table_id__scraper_runs__run_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+One scraper run, with live progress while it is running. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.run_id` | `string` | yes | Scraper run id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchScraperRun({ path: { table_id: "id", run_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchtable"></a>
+
+### `g8.api.workbench.getWorkbenchTable(input)`
+
+**Get Workbench Table**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}`
+- operationId: `get_workbench_table_workbench_tables__table_id__get` (also callable as `g8.api.call("get_workbench_table_workbench_tables__table_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+One table's definition. Ungated, matching the app.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+
+**Returns** `ApiResponse_WorkbenchTable_`: the envelope `{ data: WorkbenchTable, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`WorkbenchTable` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `created_at` | `string (date-time) \| null` | no |  |
+| `description` | `string \| null` | no |  |
+| `entity_type` | `string \| null` | no | contact or company. |
+| `id` | `string \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `row_count` | `integer \| null` | no |  |
+| `updated_at` | `string (date-time) \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchTable({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-getworkbenchwaterfall"></a>
+
+### `g8.api.workbench.getWorkbenchWaterfall(input)`
+
+**Get Workbench Waterfall**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}`
+- operationId: `get_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__get` (also callable as `g8.api.call("get_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read a waterfall column's steps and settings. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.column_id` | `integer` | yes | The waterfall column id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.getWorkbenchWaterfall({ path: { table_id: "id", column_id: 123 } });
+```
+
+---
+
+<a id="op-importworkbenchdatafile"></a>
+
+### `g8.api.workbench.importWorkbenchDatafile(input)`
+
+**Import Workbench Datafile**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/datafile`
+- operationId: `import_workbench_datafile_workbench_tables__table_id__import_datafile_post` (also callable as `g8.api.call("import_workbench_datafile_workbench_tables__table_id__import_datafile_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Import rows from an ALREADY-UPLOADED datafile. FREE.
+
+This takes a `datafile_id`, never file content, which is why it fits a JSON
+envelope. The upload that produces that id is a multipart operation and is
+not part of this contract.
+
+Same auto-enrichment caveat as the paste import: the rows land free, and an
+auto-enriching table then spends on them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `DatafileImportRequest` | yes | Request body; fields below. |
+
+Body fields (`DatafileImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.datafile_id` | `string` | yes | Id of a previously uploaded datafile. min length 1 |
+| `body.column_mapping` | `Record<string, string> \| null` | no | Source header -> column name. |
+| `body.limit` | `integer \| null` | no | min 1, max 100000 |
+| `body.raw_source_column_id` | `integer \| null` | no |  |
+| `body.skip_duplicates` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.importWorkbenchDatafile({ path: { table_id: "id" }, body: { datafile_id: "id" } });
+```
+
+---
+
+<a id="op-importworkbenchfromcrm"></a>
+
+### `g8.api.workbench.importWorkbenchFromCrm(input)`
+
+**Import Workbench From Crm**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/crm`
+- operationId: `import_workbench_from_crm_workbench_tables__table_id__import_crm_post` (also callable as `g8.api.call("import_workbench_from_crm_workbench_tables__table_id__import_crm_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `lists:run`
+
+Pull records out of a connected CRM into this table. READS THEIR SYSTEM.
+
+No credit is charged for the import itself, but it reaches into the
+customer's own CRM, which is why it needs the same grant as the other
+operations that do - a customer can hand out "read my workbench" without
+handing out "read my Salesforce".
+
+`limit` caps what lands, and it matters twice: once for the CRM's own API
+quota, and again if this table auto-enriches, because every imported row is
+then a row that spends.
+
+`crm_provider` and `object_type` are the app's legacy aliases for
+`provider_type` and `entity_type`. They are mirrored because the app still
+accepts them, not because new code should send them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `CRMImportRequest` | yes | Request body; fields below. |
+
+Body fields (`CRMImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.connection_id` | `string \| null` | no | Which CRM connection to read. |
+| `body.crm_provider` | `string \| null` | no | Legacy alias of `provider_type`. |
+| `body.entity_type` | `"contact" \| "company" \| null` | no |  |
+| `body.filters` | `Record<string, unknown> \| null` | no |  |
+| `body.limit` | `integer` | no | default `1000`, min 1, max 10000 |
+| `body.object_type` | `string \| null` | no | Legacy alias of `entity_type` (plural form). |
+| `body.provider_type` | `string \| null` | no | CRM provider key, e.g. 'hubspot'. |
+| `body.raw_source_column_id` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.workbench.importWorkbenchFromCrm({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-importworkbenchfromsearch"></a>
+
+### `g8.api.workbench.importWorkbenchFromSearch(input)`
+
+**Import Workbench From Search**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/search`
+- operationId: `import_workbench_from_search_workbench_tables__table_id__import_search_post` (also callable as `g8.api.call("import_workbench_from_search_workbench_tables__table_id__import_search_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Import people from a search into the table. CHARGES when revealed.
+
+Up to `limit` rows land LOCKED: each costs a credit to unlock with
+`POST .../unlock-rows`. Sample it first with `.../import/search/preview`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `WorkbenchSearchImportRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchSearchImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.filters` | `Array<Record<string, unknown>>` | yes | min items 1 |
+| `body.limit` | `integer` | no | default `500`, min 1, max 50000 |
+| `body.max_employees_per_company` | `integer \| null` | no | min 1, max 1000 |
+| `body.max_result` | `integer \| null` | no | min 1, max 50000 |
+| `body.raw_source_column_id` | `integer \| null` | no |  |
+| `body.return_inserted_ids` | `boolean` | no | default `false` |
+| `body.skip_duplicates` | `boolean` | no | default `true` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.importWorkbenchFromSearch({ path: { table_id: "id" }, body: { filters: [{}] } });
+```
+
+---
+
+<a id="op-listworkbenchaipresets"></a>
+
+### `g8.api.workbench.listWorkbenchAiPresets(input?)`
+
+**List Workbench Ai Presets**
+
+- HTTP: `GET /api/v1/workbench/ai-presets`
+- operationId: `list_workbench_ai_presets_workbench_ai_presets_get` (also callable as `g8.api.call("list_workbench_ai_presets_workbench_ai_presets_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Every AI preset available to the organisation. FREE.
+
+The catalogue of ready-made passes. `GET /workbench/tables/{id}/ai-presets`
+narrows the same catalogue to the ones that fit a particular table's
+columns.
+
+**Input**: none.
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchAiPresets();
+```
+
+---
+
+<a id="op-listworkbenchbindings"></a>
+
+### `g8.api.workbench.listWorkbenchBindings(input)`
+
+**List Workbench Bindings**
+
+- HTTP: `GET /api/v1/workbench-bindings`
+- operationId: `list_workbench_bindings_workbench_bindings_get` (also callable as `g8.api.call("list_workbench_bindings_workbench_bindings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The workflow bindings on one list. FREE. Requires read access to it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.list_id` | `integer` | yes | The list whose bindings to read. |
+| `query.workflow_id` | `string \| null` | no | Only this workflow's bindings. |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchBindings({ query: { list_id: 123 } });
+```
+
+---
+
+<a id="op-listworkbenchcolumnsources"></a>
+
+### `g8.api.workbench.listWorkbenchColumnSources(input)`
+
+**List Workbench Column Sources**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources`
+- operationId: `list_workbench_column_sources_workbench_tables__table_id__columns__col_id__sources_get` (also callable as `g8.api.call("list_workbench_column_sources_workbench_tables__table_id__columns__col_id__sources_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The ingest sources bound to a raw JSON column, with their webhook paths.
+Free. Credentials are never returned.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchColumnSources({ path: { table_id: "id", col_id: 123 } });
+```
+
+---
+
+<a id="op-listworkbenchcolumns"></a>
+
+### `g8.api.workbench.listWorkbenchColumns(input)`
+
+**List Workbench Columns**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/columns`
+- operationId: `list_workbench_columns_workbench_tables__table_id__columns_get` (also callable as `g8.api.call("list_workbench_columns_workbench_tables__table_id__columns_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The table's columns. Read this before writing rows - `data` keys are
+column MACHINE names.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+
+**Returns** `ApiResponse_WorkbenchPage_`: the envelope `{ data: WorkbenchPage, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`WorkbenchPage` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchColumns({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchconnections"></a>
+
+### `g8.api.workbench.listWorkbenchConnections(input)`
+
+**List Workbench Connections**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/connections`
+- operationId: `list_workbench_connections_workbench_tables__table_id__connections_get` (also callable as `g8.api.call("list_workbench_connections_workbench_tables__table_id__connections_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Connections where this table is the source or the destination. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchConnections({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchenrichmentconfigs"></a>
+
+### `g8.api.workbench.listWorkbenchEnrichmentConfigs(input)`
+
+**List Workbench Enrichment Configs**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/enrichment-configs`
+- operationId: `list_workbench_enrichment_configs_workbench_tables__table_id__enrichment_configs_get` (also callable as `g8.api.call("list_workbench_enrichment_configs_workbench_tables__table_id__enrichment_configs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Every enrichment configuration attached to this table. FREE.
+
+The inventory of what WOULD spend if run - read it before enabling
+auto-enrichment, which runs all of them.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `query.type` | `string \| null` | no | Narrow to one config kind. Omit for all of them. |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchEnrichmentConfigs({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchfindpeopleconfigs"></a>
+
+### `g8.api.workbench.listWorkbenchFindPeopleConfigs(input)`
+
+**List Workbench Find People Configs**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/find-people/configs`
+- operationId: `list_workbench_find_people_configs_workbench_tables__table_id__find_people_configs_get` (also callable as `g8.api.call("list_workbench_find_people_configs_workbench_tables__table_id__find_people_configs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The table's find-people configurations. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchFindPeopleConfigs({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchfindpeoplecontacts"></a>
+
+### `g8.api.workbench.listWorkbenchFindPeopleContacts(input)`
+
+**List Workbench Find People Contacts**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/find-people/{config_id}/contacts`
+- operationId: `list_workbench_find_people_contacts_workbench_tables__table_id__find_people__config_id__contacts_get` (also callable as `g8.api.call("list_workbench_find_people_contacts_workbench_tables__table_id__find_people__config_id__contacts_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The people a find-people run found for one company row. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.config_id` | `string` | yes | Find-people configuration id (UUID). |
+| `query.source_row_id` | `integer` | yes | The company row. |
+| `query.limit` | `integer` | no | default `100` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchFindPeopleContacts({
+  path: { table_id: "id", config_id: "id" },
+  query: { source_row_id: 123 },
+});
+```
+
+---
+
+<a id="op-listworkbenchpipelines"></a>
+
+### `g8.api.workbench.listWorkbenchPipelines(input)`
+
+**List Workbench Pipelines**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/pipelines`
+- operationId: `list_workbench_pipelines_workbench_tables__table_id__pipelines_get` (also callable as `g8.api.call("list_workbench_pipelines_workbench_tables__table_id__pipelines_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The table's pipelines. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchPipelines({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchrows"></a>
+
+### `g8.api.workbench.listWorkbenchRows(input)`
+
+**List Workbench Rows**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/rows`
+- operationId: `list_workbench_rows_workbench_tables__table_id__rows_get` (also callable as `g8.api.call("list_workbench_rows_workbench_tables__table_id__rows_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+A window of rows.
+
+Paged by `start_row`/`end_row`, not page/limit - this is a grid viewport,
+and translating it into pages would lose the ability to fetch an arbitrary
+window as a user scrolls.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `query.start_row` | `integer` | no | default `0` |
+| `query.end_row` | `integer` | no | default `100` |
+
+**Returns** `ApiResponse_WorkbenchPage_`: the envelope `{ data: WorkbenchPage, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`WorkbenchPage` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<Record<string, unknown>>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchRows({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchscraperpresets"></a>
+
+### `g8.api.workbench.listWorkbenchScraperPresets(input?)`
+
+**List Workbench Scraper Presets**
+
+- HTTP: `GET /api/v1/workbench/scraper/presets`
+- operationId: `list_workbench_scraper_presets_workbench_scraper_presets_get` (also callable as `g8.api.call("list_workbench_scraper_presets_workbench_scraper_presets_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The scraper presets available, with their per-result rates. FREE.
+
+Read the rate here, then price a specific run with `credit-estimate`.
+
+**Input**: none.
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchScraperPresets();
+```
+
+---
+
+<a id="op-listworkbenchscraperruns"></a>
+
+### `g8.api.workbench.listWorkbenchScraperRuns(input)`
+
+**List Workbench Scraper Runs**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/scraper/runs`
+- operationId: `list_workbench_scraper_runs_workbench_tables__table_id__scraper_runs_get` (also callable as `g8.api.call("list_workbench_scraper_runs_workbench_tables__table_id__scraper_runs_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The table's scraper runs, newest first, with a total. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `query.limit` | `integer` | no | default `20` |
+| `query.offset` | `integer` | no | default `0` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchScraperRuns({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchsourcecredentials"></a>
+
+### `g8.api.workbench.listWorkbenchSourceCredentials(input?)`
+
+**List Workbench Source Credentials**
+
+- HTTP: `GET /api/v1/workbench/source-credentials`
+- operationId: `list_workbench_source_credentials_workbench_source_credentials_get` (also callable as `g8.api.call("list_workbench_source_credentials_workbench_source_credentials_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Every ingest credential in the organisation - owner, scope, expiry. Free.
+
+Hashes and full secrets are NEVER returned; a credential's value is
+readable only once, at the moment it is minted.
+
+Gated on Workbench WRITE even though it reads, matching the app: the
+org-wide inventory names which person owns each credential, so it is a
+governance view rather than ordinary table data.
+
+**Input**: none.
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchSourceCredentials();
+```
+
+---
+
+<a id="op-listworkbenchtableaipresets"></a>
+
+### `g8.api.workbench.listWorkbenchTableAiPresets(input)`
+
+**List Workbench Table Ai Presets**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/ai-presets`
+- operationId: `list_workbench_table_ai_presets_workbench_tables__table_id__ai_presets_get` (also callable as `g8.api.call("list_workbench_table_ai_presets_workbench_tables__table_id__ai_presets_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The presets that can actually run on THIS table. FREE.
+
+Filtered by the columns the table has, so a preset listed here has its
+inputs satisfied. Selecting one still costs nothing until it is run.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchTableAiPresets({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-listworkbenchtables"></a>
+
+### `g8.api.workbench.listWorkbenchTables(input?)`
+
+**List Workbench Tables**
+
+- HTTP: `GET /api/v1/workbench/tables`
+- operationId: `list_workbench_tables_workbench_tables_get` (also callable as `g8.api.call("list_workbench_tables_workbench_tables_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+This org's tables.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.page` | `integer` | no | default `1` |
+| `query.limit` | `integer` | no | default `20` |
+| `query.sort_field` | `string` | no | default `"created_at"` |
+| `query.sort_order` | `string` | no | default `"desc"` |
+| `query.filter_name` | `string \| null` | no | Substring match on the table name. |
+
+**Returns** `ApiResponse_WorkbenchTableList_`: the envelope `{ data: WorkbenchTableList, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`WorkbenchTableList` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `tables` | `Array<WorkbenchTable>` | no |  |
+| `total` | `integer` | no | default `0` |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchTables();
+```
+
+---
+
+<a id="op-listworkbenchtargetfields"></a>
+
+### `g8.api.workbench.listWorkbenchTargetFields(input?)`
+
+**List Workbench Target Fields**
+
+- HTTP: `GET /api/v1/workbench/target-fields`
+- operationId: `list_workbench_target_fields_workbench_target_fields_get` (also callable as `g8.api.call("list_workbench_target_fields_workbench_target_fields_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The canonical fields a workbench column can be mapped onto. Free.
+
+Closed to `contact` / `company` because the handler indexes a dict with
+this value directly - a free string would raise a KeyError inside and
+escape as a 500 instead of a 422 naming the two kinds.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `query.entity_type` | `"contact" \| "company"` | no | Which record kind the fields are for. default `"contact"` |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchTargetFields();
+```
+
+---
+
+<a id="op-listworkbenchtriggers"></a>
+
+### `g8.api.workbench.listWorkbenchTriggers(input)`
+
+**List Workbench Triggers**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/triggers`
+- operationId: `list_workbench_triggers_workbench_tables__table_id__triggers_get` (also callable as `g8.api.call("list_workbench_triggers_workbench_tables__table_id__triggers_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+The table's triggers. Free.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.listWorkbenchTriggers({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-mapworkbenchcolumn"></a>
+
+### `g8.api.workbench.mapWorkbenchColumn(input)`
+
+**Map Workbench Column**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/columns/{column_id}/mapping`
+- operationId: `map_workbench_column_workbench_tables__table_id__columns__column_id__mapping_put` (also callable as `g8.api.call("map_workbench_column_workbench_tables__table_id__columns__column_id__mapping_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Point a column at a CRM field so export knows where its values go.
+
+Send `mapping_target: null` to clear it - an unmapped column is a real
+state, not a missing argument.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `path.column_id` | `integer` | yes | Column id. |
+| `body` | `WorkbenchColumnMappingRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchColumnMappingRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.mapping_target` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.mapWorkbenchColumn({ path: { table_id: "id", column_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-migrateworkbenchlegacyaiconfig"></a>
+
+### `g8.api.workbench.migrateWorkbenchLegacyAiConfig(input)`
+
+**Migrate Workbench Legacy Ai Config**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/migrate-legacy`
+- operationId: `migrate_workbench_legacy_ai_config_workbench_tables__table_id__ai_migrate_legacy_post` (also callable as `g8.api.call("migrate_workbench_legacy_ai_config_workbench_tables__table_id__ai_migrate_legacy_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Move an old single-prompt config onto the group model. FREE.
+
+A one-off data migration for tables configured before AI groups existed.
+It reshapes stored configuration and runs nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.migrateWorkbenchLegacyAiConfig({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-pasteimportworkbenchrows"></a>
+
+### `g8.api.workbench.pasteImportWorkbenchRows(input)`
+
+**Paste Import Workbench Rows**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/paste`
+- operationId: `paste_import_workbench_rows_workbench_tables__table_id__import_paste_post` (also callable as `g8.api.call("paste_import_workbench_rows_workbench_tables__table_id__import_paste_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Import a rectangle of values directly. FREE.
+
+Up to 50,000 rows and 100 columns in one call. Missing columns are created
+from `headers`.
+
+If the table has auto-enrichment ON, the rows this adds are enriched
+automatically afterwards, and THAT spends credits. The import itself does
+not.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `PasteImportRequest` | yes | Request body; fields below. |
+
+Body fields (`PasteImportRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.headers` | `Array<string>` | yes | min items 1, max items 100 |
+| `body.rows` | `Array<Array<unknown>>` | yes | min items 1, max items 50000 |
+| `body.raw_source_column_id` | `integer \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.pasteImportWorkbenchRows({
+  path: { table_id: "id" },
+  body: { headers: ["example"], rows: [[{}]] },
+});
+```
+
+---
+
+<a id="op-previewworkbenchai"></a>
+
+### `g8.api.workbench.previewWorkbenchAi(input)`
+
+**Preview Workbench Ai**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/preview`
+- operationId: `preview_workbench_ai_workbench_tables__table_id__ai_preview_post` (also callable as `g8.api.call("preview_workbench_ai_workbench_tables__table_id__ai_preview_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run the default AI pass on the first three pending rows. CHARGES.
+
+A preview in scope, not in price: it is the real pass and bills those rows.
+Only `approved_max_credits` and `quote_expires_at` are read from the body.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `RunStagingAIRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.previewWorkbenchAi({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-previewworkbenchresearchimport"></a>
+
+### `g8.api.workbench.previewWorkbenchResearchImport(input)`
+
+**Preview Workbench Research Import**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/search/research/preview`
+- operationId: `preview_workbench_research_import_workbench_tables__table_id__import_search_research_preview_post` (also callable as `g8.api.call("preview_workbench_research_import_workbench_tables__table_id__import_search_research_preview_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Describe your leads in words; a model writes the search and returns a
+sample. CHARGES for the model call. Nothing is imported.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SearchResearchPreviewRequest` | yes | Request body; fields below. |
+
+Body fields (`SearchResearchPreviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.lead_prompt` | `string` | yes | min length 1 |
+| `body.max_employees_per_company` | `integer \| null` | no | min 1, max 1000 |
+| `body.max_result` | `integer \| null` | no | min 1, max 50000 |
+| `body.sample_size` | `integer` | no | default `50`, min 1, max 1000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.previewWorkbenchResearchImport({ path: { table_id: "id" }, body: { lead_prompt: "example" } });
+```
+
+---
+
+<a id="op-previewworkbenchsearchimport"></a>
+
+### `g8.api.workbench.previewWorkbenchSearchImport(input)`
+
+**Preview Workbench Search Import**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/import/search/preview`
+- operationId: `preview_workbench_search_import_workbench_tables__table_id__import_search_preview_post` (also callable as `g8.api.call("preview_workbench_search_import_workbench_tables__table_id__import_search_preview_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Sample what a people search would import, and how many it matches. Free.
+
+Contact details stay masked; nothing is imported.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SearchImportPreviewRequest` | yes | Request body; fields below. |
+
+Body fields (`SearchImportPreviewRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.filters` | `Array<Record<string, unknown>>` | yes | min items 1 |
+| `body.max_employees_per_company` | `integer \| null` | no | min 1, max 1000 |
+| `body.max_result` | `integer \| null` | no | min 1, max 50000 |
+| `body.sample_size` | `integer` | no | default `50`, min 1, max 1000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.previewWorkbenchSearchImport({ path: { table_id: "id" }, body: { filters: [{}] } });
+```
+
+---
+
+<a id="op-queryworkbenchrows"></a>
+
+### `g8.api.workbench.queryWorkbenchRows(input)`
+
+**Query Workbench Rows**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/rows/query`
+- operationId: `query_workbench_rows_workbench_tables__table_id__rows_query_post` (also callable as `g8.api.call("query_workbench_rows_workbench_tables__table_id__rows_query_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Read a window of rows with a filter and a sort. FREE - a read.
+
+POST only because the filter is a structured body; nothing is written,
+enqueued or charged. `GET /workbench/tables/{id}/rows` is the simple form.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `StagingRowsQueryRequest` | no | Request body; fields below. |
+
+Body fields (`StagingRowsQueryRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.end_row` | `integer` | no | default `100`, min 1, max 100000 |
+| `body.filter_model` | `Record<string, unknown> \| null` | no |  |
+| `body.sort_model` | `Array<Record<string, unknown>> \| null` | no |  |
+| `body.start_row` | `integer` | no | default `0`, min 0, max 100000 |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.queryWorkbenchRows({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-quoteworkbenchairun"></a>
+
+### `g8.api.workbench.quoteWorkbenchAiRun(input)`
+
+**Quote Workbench Ai Run**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/validate-credits`
+- operationId: `quote_workbench_ai_run_workbench_tables__table_id__ai_validate_credits_post` (also callable as `g8.api.call("quote_workbench_ai_run_workbench_tables__table_id__ai_validate_credits_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price an AI run before starting it. FREE.
+
+Name the run you are about to start: `group_id`, `column_id`, or
+`all_columns`; none prices the table's default AI pass. Pass the answer's
+`required_credits` to the run as `approved_max_credits`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `WorkbenchCreditValidationRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.all_columns` | `boolean` | no | default `false` |
+| `body.column_id` | `integer \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no |  |
+| `body.group_id` | `string \| null` | no | min length 1, max length 255 |
+| `body.row_ids` | `Array<integer> \| null` | no | OMIT to price EVERY row. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.quoteWorkbenchAiRun({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-quoteworkbenchformulageneration"></a>
+
+### `g8.api.workbench.quoteWorkbenchFormulaGeneration(input)`
+
+**Quote Workbench Formula Generation**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/formula-columns/generate-quote`
+- operationId: `quote_workbench_formula_generation_workbench_tables__table_id__formula_columns_generate_quote_get` (also callable as `g8.api.call("quote_workbench_formula_generation_workbench_tables__table_id__formula_columns_generate_quote_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price AI formula authoring against the live balance. CHARGES NOTHING.
+
+Despite `generate` in the path this generates no formula and spends no
+credit - it reports the fixed authoring charge, the organisation's balance,
+and whether the balance covers it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.quoteWorkbenchFormulaGeneration({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-quoteworkbenchunlock"></a>
+
+### `g8.api.workbench.quoteWorkbenchUnlock(input)`
+
+**Quote Workbench Unlock**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/unlock-quote`
+- operationId: `quote_workbench_unlock_workbench_tables__table_id__unlock_quote_post` (also callable as `g8.api.call("quote_workbench_unlock_workbench_tables__table_id__unlock_quote_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price an unlock. CHARGES NOTHING, and unlocks nothing.
+
+Returns the exact locked-row count for the scope, the organisation's live
+balance, and the shortfall if there is one. It also returns the
+`operation_id` that `unlock-rows` REQUIRES - so this call is not optional
+advice, it is step one of the handshake.
+
+Send this exact body to `unlock-rows` afterwards: the quote prices the
+scope the unlock will charge for, and a different body is a different
+price.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `UnlockStagingRowsRequest` | no | Request body; fields below. |
+
+Body fields (`UnlockStagingRowsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | Rows to leave locked. max items 100000 |
+| `body.operation_id` | `string (uuid) \| null` | no | 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. |
+| `body.quote_expires_at` | `string (date-time) \| null` | no | Expiry of the quote being approved. |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to act on. OMIT to mean EVERY locked row in the table. max items 100000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.quoteWorkbenchUnlock({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-quoteworkbenchwaterfallrun"></a>
+
+### `g8.api.workbench.quoteWorkbenchWaterfallRun(input)`
+
+**Quote Workbench Waterfall Run**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}/validate-credits`
+- operationId: `quote_workbench_waterfall_run_workbench_tables__table_id__waterfall_configs__column_id__validate_credits_post` (also callable as `g8.api.call("quote_workbench_waterfall_run_workbench_tables__table_id__waterfall_configs__column_id__validate_credits_post", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Price a waterfall run. FREE. OMITTING `row_ids` prices EVERY row.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.column_id` | `integer` | yes | The waterfall column id. |
+| `body` | `WorkbenchCreditValidationRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.all_columns` | `boolean` | no | default `false` |
+| `body.column_id` | `integer \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no |  |
+| `body.group_id` | `string \| null` | no | min length 1, max length 255 |
+| `body.row_ids` | `Array<integer> \| null` | no | OMIT to price EVERY row. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.quoteWorkbenchWaterfallRun({ path: { table_id: "id", column_id: 123 } });
+```
+
+---
+
+<a id="op-regenerateworkbenchkey"></a>
+
+### `g8.api.workbench.regenerateWorkbenchKey(input)`
+
+**Regenerate Workbench Key**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/regenerate-key`
+- operationId: `regenerate_workbench_key_workbench_tables__table_id__regenerate_key_post` (also callable as `g8.api.call("regenerate_workbench_key_workbench_tables__table_id__regenerate_key_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Mint the table's ingest credential. Free.
+
+THE ONLY TIME THE KEY IS READABLE. It is returned here and never again -
+store it on receipt. This is the credential the app's `X-Webhook-Key`
+ingest path expects, which is why that path is not published here and does
+not need to be.
+
+`rotate_existing` false mints only when there is none; true replaces the
+current one and breaks anything still using it, immediately.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `RegenerateKeyRequest` | no | Request body; fields below. |
+
+Body fields (`RegenerateKeyRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.rotate_existing` | `boolean` | no | Acknowledge that the existing credential stops working IMMEDIATELY. Leave false to mint only when there is none. default `false` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.regenerateWorkbenchKey({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-reviewworkbenchfindpeoplecandidates"></a>
+
+### `g8.api.workbench.reviewWorkbenchFindPeopleCandidates(input)`
+
+**Review Workbench Find People Candidates**
+
+- HTTP: `GET /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/review`
+- operationId: `review_workbench_find_people_candidates_workbench_tables__table_id__ai_groups__group_id__find_people_review_get` (also callable as `g8.api.call("review_workbench_find_people_candidates_workbench_tables__table_id__ai_groups__group_id__find_people_review_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `lists:read`
+
+Contacts a find-people group turned up and is holding for review. FREE.
+
+Only populated when the group's `export_mode` is `review`. Under `auto`
+there is nothing to review because the contacts were already exported.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | AI group id (starts with `ai_enrich`). |
+
+**Returns** `ApiResponse_EnrichmentListPayload_`: the envelope `{ data: EnrichmentListPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`EnrichmentListPayload` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `items` | `Array<unknown>` | no | The collection, always present. |
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.reviewWorkbenchFindPeopleCandidates({ path: { table_id: "id", group_id: "id" } });
+```
+
+---
+
+<a id="op-revokeworkbenchcolumnsource"></a>
+
+### `g8.api.workbench.revokeWorkbenchColumnSource(input)`
+
+**Revoke Workbench Column Source**
+
+- HTTP: `DELETE /api/v1/workbench/tables/{table_id}/columns/{col_id}/sources/{source_type}`
+- operationId: `revoke_workbench_column_source_workbench_tables__table_id__columns__col_id__sources__source_type__delete` (also callable as `g8.api.call("revoke_workbench_column_source_workbench_tables__table_id__columns__col_id__sources__source_type__delete", input)`)
+- Tier: `destructive`: deletes or archives data; confirm with a human before calling
+- API-key scope: `lists:delete`
+
+Revoke a column's ingest source. Free.
+
+Anything still posting with that credential starts failing immediately.
+Rows already ingested are untouched.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+| `path.source_type` | `string` | yes | Which source binding to revoke. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// destructive: deletes or archives data; confirm with a human before calling.
+const result = await g8.api.workbench.revokeWorkbenchColumnSource({ path: { table_id: "id", col_id: 123, source_type: "example" } });
+```
+
+---
+
+<a id="op-runworkbenchai"></a>
+
+### `g8.api.workbench.runWorkbenchAi(input)`
+
+**Run Workbench Ai**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/run-all`
+- operationId: `run_workbench_ai_workbench_tables__table_id__ai_run_all_post` (also callable as `g8.api.call("run_workbench_ai_workbench_tables__table_id__ai_run_all_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+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.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `RunStagingAIRequest` | no | Request body; fields below. |
+
+Body fields (`RunStagingAIRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchAi({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-runworkbenchaigroup"></a>
+
+### `g8.api.workbench.runWorkbenchAiGroup(input)`
+
+**Run Workbench Ai Group**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/run`
+- operationId: `run_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__run_post` (also callable as `g8.api.call("run_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__run_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run one saved AI group. CHARGES per row.
+
+OMITTING `row_ids` RUNS EVERY PENDING ROW. Quote it with
+`POST .../ai/validate-credits` and `group_id`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | The AI group id. |
+| `body` | `RunStagingAIRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchAiGroup({ path: { table_id: "id", group_id: "id" } });
+```
+
+---
+
+<a id="op-runworkbenchcolumnai"></a>
+
+### `g8.api.workbench.runWorkbenchColumnAi(input)`
+
+**Run Workbench Column Ai**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai/run`
+- operationId: `run_workbench_column_ai_workbench_tables__table_id__columns__col_id__ai_run_post` (also callable as `g8.api.call("run_workbench_column_ai_workbench_tables__table_id__columns__col_id__ai_run_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run one column's AI. CHARGES per row.
+
+OMITTING `row_ids` RUNS EVERY ROW. Quote it with
+`POST .../ai/validate-credits` and `column_id`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+| `body` | `RunStagingAIRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchColumnAi({ path: { table_id: "id", col_id: 123 } });
+```
+
+---
+
+<a id="op-runworkbenchdefaultai"></a>
+
+### `g8.api.workbench.runWorkbenchDefaultAi(input)`
+
+**Run Workbench Default Ai**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/run`
+- operationId: `run_workbench_default_ai_workbench_tables__table_id__ai_run_post` (also callable as `g8.api.call("run_workbench_default_ai_workbench_tables__table_id__ai_run_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run the table's default AI pass. CHARGES per row.
+
+OMITTING `row_ids` RUNS EVERY PENDING ROW. Quote it first with
+`POST .../ai/validate-credits`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `RunStagingAIRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchDefaultAi({ path: { table_id: "id" } });
+```
+
+---
+
+<a id="op-runworkbenchfindpeople"></a>
+
+### `g8.api.workbench.runWorkbenchFindPeople(input)`
+
+**Run Workbench Find People**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/find-people/{config_id}/run`
+- operationId: `run_workbench_find_people_workbench_tables__table_id__find_people__config_id__run_post` (also callable as `g8.api.call("run_workbench_find_people_workbench_tables__table_id__find_people__config_id__run_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Find people at the table's companies. CHARGES per company searched.
+
+`all_rows` (the default) searches EVERY company row; `first_10` is a cheap
+trial; `selected` needs `row_ids` or `exclude_row_ids`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.config_id` | `string` | yes | Find-people configuration id (UUID). |
+| `body` | `RunWorkbenchFindPeopleRequest` | yes | Request body; fields below. |
+
+Body fields (`RunWorkbenchFindPeopleRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.enrichment_mode` | `"first_10" \| "all_rows" \| "selected"` | no | default `"all_rows"` |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.row_ids` | `Array<integer> \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchFindPeople({ path: { table_id: "id", config_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-runworkbenchproviderscraper"></a>
+
+### `g8.api.workbench.runWorkbenchProviderScraper(input)`
+
+**Run Workbench Provider Scraper**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/scraper/providers/{provider}/runs`
+- operationId: `run_workbench_provider_scraper_workbench_tables__table_id__scraper_providers__provider__runs_post` (also callable as `g8.api.call("run_workbench_provider_scraper_workbench_tables__table_id__scraper_providers__provider__runs_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run a scraper on your connected provider account. CHARGES per result.
+
+`auto_enrich` DEFAULTS TO TRUE: every result is also enriched and charged
+unless you turn it off. Quote it with
+`GET /workbench/scraper/providers/{provider}/credit-estimate`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.provider` | `"apify"` | yes | Which scraper provider. |
+| `body` | `RunProviderScraperRequest` | yes | Request body; fields below. |
+
+Body fields (`RunProviderScraperRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | min 0 |
+| `body.auto_enrich` | `boolean` | no | default `true` |
+| `body.custom_actor_id` | `string \| null` | no |  |
+| `body.input_config` | `Record<string, unknown>` | no |  |
+| `body.max_results` | `integer` | no | default `1000`, min 1, max 50000 |
+| `body.preset_id` | `string \| null` | no |  |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchProviderScraper({ path: { table_id: "id", provider: "apify" }, body: {} });
+```
+
+---
+
+<a id="op-runworkbenchscraper"></a>
+
+### `g8.api.workbench.runWorkbenchScraper(input)`
+
+**Run Workbench Scraper**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/scraper/runs`
+- operationId: `run_workbench_scraper_workbench_tables__table_id__scraper_runs_post` (also callable as `g8.api.call("run_workbench_scraper_workbench_tables__table_id__scraper_runs_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Describe what to collect and the scraper fills the table. CHARGES per
+result, plus enrichment of each when `auto_enrich` is true.
+
+Quote it first with `GET /workbench/scraper/credit-estimate` and pass the
+approved amount as `approved_max_credits` with `quote_expires_at`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `RunBuiltinScraperRequest` | yes | Request body; fields below. |
+
+Body fields (`RunBuiltinScraperRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt` | `string` | yes | min length 10, max length 5000 |
+| `body.approved_max_credits` | `integer \| null` | no | min 0 |
+| `body.auto_enrich` | `boolean` | no | Also enrich each scraped row. Charged on top. default `false` |
+| `body.max_results` | `integer` | no | default `200`, min 10, max 2000 |
+| `body.model` | `string \| null` | no |  |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchScraper({ path: { table_id: "id" }, body: { prompt: "xxxxxxxxxx" } });
+```
+
+---
+
+<a id="op-runworkbenchwaterfall"></a>
+
+### `g8.api.workbench.runWorkbenchWaterfall(input)`
+
+**Run Workbench Waterfall**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}/run`
+- operationId: `run_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__run_post` (also callable as `g8.api.call("run_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__run_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run a waterfall column. CHARGES per provider call.
+
+OMITTING `row_ids` RUNS EVERY ELIGIBLE ROW. Refused (402) without enough
+credit; quote it first with `.../validate-credits`.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.column_id` | `integer` | yes | The waterfall column id. |
+| `body` | `RunStagingAIRequest \| null` | no | Request body; fields below. |
+
+Body fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.conditions` | `Array<Record<string, string>> \| null` | no |  |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | max items 100000 |
+| `body.max_rows_per_source` | `integer \| null` | no | min 1, max 50 |
+| `body.model` | `string \| null` | no | Override the configured model. |
+| `body.multi_row_output` | `boolean \| null` | no |  |
+| `body.prompt` | `string \| null` | no | Override the configured prompt. |
+| `body.qualification_mode` | `boolean` | no | default `false` |
+| `body.quote_expires_at` | `string (date-time) \| null` | no |  |
+| `body.quote_id` | `string (uuid) \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to run. OMIT to run EVERY row in the table. |
+| `body.status_filter` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.runWorkbenchWaterfall({ path: { table_id: "id", column_id: 123 } });
+```
+
+---
+
+<a id="op-savescraperproviderconnection"></a>
+
+### `g8.api.workbench.saveScraperProviderConnection(input)`
+
+**Save Scraper Provider Connection**
+
+- HTTP: `PUT /api/v1/workbench/scraper/providers/{provider}/connection`
+- operationId: `save_scraper_provider_connection_workbench_scraper_providers__provider__connection_put` (also callable as `g8.api.call("save_scraper_provider_connection_workbench_scraper_providers__provider__connection_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Connect, or replace, your provider account token. Free.
+
+The token is sealed at rest and never returned. Check it first with
+`POST .../connection/test`; saving does not.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which scraper provider. |
+| `body` | `ScraperConnectionRequest` | yes | Request body; fields below. |
+
+Body fields (`ScraperConnectionRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.api_key` | `string` | yes | Your provider API token. Never returned. min length 1 |
+| `body.configuration` | `Record<string, unknown>` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.saveScraperProviderConnection({ path: { provider: "apify" }, body: { api_key: "example" } });
+```
+
+---
+
+<a id="op-saveworkbenchcolumnaiconfig"></a>
+
+### `g8.api.workbench.saveWorkbenchColumnAiConfig(input)`
+
+**Save Workbench Column Ai Config**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/columns/{col_id}/ai-config`
+- operationId: `save_workbench_column_ai_config_workbench_tables__table_id__columns__col_id__ai_config_put` (also callable as `g8.api.call("save_workbench_column_ai_config_workbench_tables__table_id__columns__col_id__ai_config_put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Set ONE column's AI pass. FREE - saving runs nothing.
+
+`conditions` is the per-row gate: rows that do not match are skipped by a
+later run and cost nothing, which is the cheapest way to narrow a pass.
+
+`usecase` is closed to the two the app accepts, because the value reaches a
+pattern check and a pricing table inside - an invented usecase would either
+422 opaquely or price against the wrong tariff.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.col_id` | `integer` | yes | Column id. |
+| `body` | `SaveColumnAIConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`SaveColumnAIConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.prompt` | `string` | yes | min length 1 |
+| `body.conditions` | `Record<string, unknown> \| null` | no | Only run the pass on rows matching these conditions. |
+| `body.model` | `string` | no | default `"openai/gpt-4o"` |
+| `body.usecase` | `"content_generation" \| "web-research"` | no | default `"content_generation"` |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.saveWorkbenchColumnAiConfig({ path: { table_id: "id", col_id: 123 }, body: { prompt: "example" } });
+```
+
+---
+
+<a id="op-saveworkbenchwaterfall"></a>
+
+### `g8.api.workbench.saveWorkbenchWaterfall(input)`
+
+**Save Workbench Waterfall**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/waterfall/configs`
+- operationId: `save_workbench_waterfall_workbench_tables__table_id__waterfall_configs_post` (also callable as `g8.api.call("save_workbench_waterfall_workbench_tables__table_id__waterfall_configs_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Create a waterfall column, or overwrite one when `config.column_id` names
+an existing column. Free: saving never runs it.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SaveWaterfallRequest` | yes | Request body; fields below. |
+
+Body fields (`SaveWaterfallRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.config` | `WaterfallConfig` | yes |  |
+| `body.run_immediately` | `boolean` | no | Ignored on a workbench table. default `false` |
+| `body.target_records` | `Array<string (uuid)> \| null` | no | Ignored on a workbench table. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.saveWorkbenchWaterfall({
+  path: { table_id: "id" },
+  body: {
+    config: {
+      column_id: "id",
+      field_to_enrich: "example",
+      name: "Example",
+      steps: [
+        {
+          action: "example",
+          action_display_name: "Example",
+          id: "id",
+          order: 1,
+          provider: "example",
+        },
+      ],
+    },
+  },
+});
+```
+
+---
+
+<a id="op-sendworkbenchrowstosequence"></a>
+
+### `g8.api.workbench.sendWorkbenchRowsToSequence(input)`
+
+**Send Workbench Rows To Sequence**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/send-to-sequence`
+- operationId: `send_workbench_rows_to_sequence_workbench_tables__table_id__send_to_sequence_post` (also callable as `g8.api.call("send_workbench_rows_to_sequence_workbench_tables__table_id__send_to_sequence_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `lists:run`
+
+Enrol workbench rows into a sequence. THIS EMAILS REAL PEOPLE.
+
+The rows stop being scratch data at this point: a sequence sends on its own
+schedule, to the addresses in these rows, from the organisation's mailboxes.
+There is no preview step here, and nothing to undo once a message is out.
+
+OMITTING `row_ids` SENDS EVERY ROW IN THE TABLE, including rows that are
+still locked or half-enriched. Name the rows.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SendToSequenceRequest` | yes | Request body; fields below. |
+
+Body fields (`SendToSequenceRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.sequence_id` | `integer` | yes |  |
+| `body.create_new_list` | `boolean` | no | default `false` |
+| `body.list_id` | `integer \| null` | no |  |
+| `body.new_list_name` | `string \| null` | no |  |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to send. OMIT to send EVERY row in the table. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.workbench.sendWorkbenchRowsToSequence({ path: { table_id: "id" }, body: { sequence_id: 123 } });
+```
+
+---
+
+<a id="op-setworkbenchautoenrich"></a>
+
+### `g8.api.workbench.setWorkbenchAutoEnrich(input)`
+
+**Set Workbench Auto Enrich**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/auto-enrich`
+- operationId: `set_workbench_auto_enrich_workbench_tables__table_id__auto_enrich_put` (also callable as `g8.api.call("set_workbench_auto_enrich_workbench_tables__table_id__auto_enrich_put", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Enrich every row that arrives, automatically. STARTS ONGOING SPEND.
+
+The PUT itself charges nothing. What it does is remove the human from the
+loop: from the moment this is on, every row that lands in the table - from
+an import, a webhook, a scraper or a routing rule - is enriched by the
+configured AI passes WITHOUT a further API call, and each one costs.
+
+That is why this is graded as a spend rather than an ordinary setting. It
+is the single switch on this surface most likely to produce a bill nobody
+asked for, so `enabled` is explicit rather than a toggle: a retried request
+cannot silently turn it back on.
+
+Read `GET /workbench/tables/{id}/enrichment-configs` first - that is the
+list of passes this will start running.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `ToggleAutoEnrichRequest` | yes | Request body; fields below. |
+
+Body fields (`ToggleAutoEnrichRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.enabled` | `boolean` | yes |  |
+| `body.batch_size` | `integer` | no | Rows per automatic batch. default `10`, min 1, max 1000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.setWorkbenchAutoEnrich({ path: { table_id: "id" }, body: { enabled: true } });
+```
+
+---
+
+<a id="op-setworkbenchschedule"></a>
+
+### `g8.api.workbench.setWorkbenchSchedule(input)`
+
+**Set Workbench Schedule**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/schedule`
+- operationId: `set_workbench_schedule_workbench_tables__table_id__schedule_put` (also callable as `g8.api.call("set_workbench_schedule_workbench_tables__table_id__schedule_put", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Run something on this table on a schedule. CAN ARM ONGOING SPEND.
+
+`action_type: run_ai` means every firing runs the table's AI passes and
+charges for them - nightly, forever, with nobody in the loop. `run_formula`
+is local and free; `crm_import` reaches the customer's CRM.
+
+`enabled` defaults to FALSE, so writing a schedule and starting it are two
+separate acts. That is deliberate: it lets a caller define the cadence,
+read it back, and only then turn it on.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `ScheduleConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`ScheduleConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.action_type` | `"run_ai" \| "run_formula" \| "crm_import"` | yes |  |
+| `body.action_config` | `Record<string, unknown> \| null` | no |  |
+| `body.cron_expression` | `string \| null` | no | min length 5, max length 100 |
+| `body.enabled` | `boolean` | no | default `false` |
+| `body.frequency` | `"hourly" \| "daily" \| "weekly" \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.setWorkbenchSchedule({ path: { table_id: "id" }, body: { action_type: "run_ai" } });
+```
+
+---
+
+<a id="op-skipworkbenchfindpeoplecandidates"></a>
+
+### `g8.api.workbench.skipWorkbenchFindPeopleCandidates(input)`
+
+**Skip Workbench Find People Candidates**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}/find-people/skip`
+- operationId: `skip_workbench_find_people_candidates_workbench_tables__table_id__ai_groups__group_id__find_people_skip_post` (also callable as `g8.api.call("skip_workbench_find_people_candidates_workbench_tables__table_id__ai_groups__group_id__find_people_skip_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Reject candidates from the review queue. FREE.
+
+Marks them skipped so they are not exported. The search that found them has
+already been paid for; skipping does not refund it, it just stops them
+reaching a list.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | AI group id (starts with `ai_enrich`). |
+| `body` | `UpdateStagingAIFindPeopleCandidatesRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateStagingAIFindPeopleCandidatesRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.candidate_ids` | `Array<string>` | no | min items 1 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.skipWorkbenchFindPeopleCandidates({ path: { table_id: "id", group_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-suggestworkbenchmappings"></a>
+
+### `g8.api.workbench.suggestWorkbenchMappings(input)`
+
+**Suggest Workbench Mappings**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/suggest-mappings`
+- operationId: `suggest_workbench_mappings_workbench_tables__table_id__suggest_mappings_post` (also callable as `g8.api.call("suggest_workbench_mappings_workbench_tables__table_id__suggest_mappings_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Ask the model which source column maps to which target field. COSTS AN AI CALL.
+
+Returns a `job_id` immediately - the model call happens in the background.
+Poll `GET /workbench/tables/{id}/suggest-mappings/{job_id}` for the answer.
+
+The suggestion is advisory: nothing is mapped until you write the mapping
+yourself.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `SuggestMappingsRequest` | yes | Request body; fields below. |
+
+Body fields (`SuggestMappingsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.source_columns` | `Array<string>` | yes | min items 1, max items 100 |
+| `body.target_fields` | `Array<string>` | yes | min items 1, max items 100 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.suggestWorkbenchMappings({
+  path: { table_id: "id" },
+  body: { source_columns: ["example"], target_fields: ["example"] },
+});
+```
+
+---
+
+<a id="op-syncworkbenchconnection"></a>
+
+### `g8.api.workbench.syncWorkbenchConnection(input)`
+
+**Sync Workbench Connection**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/connections/{connection_id}/sync`
+- operationId: `sync_workbench_connection_workbench_tables__table_id__connections__connection_id__sync_post` (also callable as `g8.api.call("sync_workbench_connection_workbench_tables__table_id__connections__connection_id__sync_post", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Copy rows across a connection now. Free; stays inside your organisation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.connection_id` | `integer` | yes | Connection id. |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.syncWorkbenchConnection({ path: { table_id: "id", connection_id: 123 } });
+```
+
+---
+
+<a id="op-testscraperproviderconnection"></a>
+
+### `g8.api.workbench.testScraperProviderConnection(input)`
+
+**Test Scraper Provider Connection**
+
+- HTTP: `POST /api/v1/workbench/scraper/providers/{provider}/connection/test`
+- operationId: `test_scraper_provider_connection_workbench_scraper_providers__provider__connection_test_post` (also callable as `g8.api.call("test_scraper_provider_connection_workbench_scraper_providers__provider__connection_test_post", input)`)
+- Tier: `external`: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first
+- API-key scope: `lists:run`
+
+Check a token against the provider without saving it. Contacts the
+provider; free. Answers `success: false` with a reason rather than an error.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.provider` | `"apify"` | yes | Which scraper provider. |
+| `body` | `ScraperConnectionTestRequest` | yes | Request body; fields below. |
+
+Body fields (`ScraperConnectionTestRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.api_key` | `string` | yes | min length 1 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// external: reaches real people (sends email/SMS, places a call, launches a send); the SDK never blindly retries it; confirm with a human first.
+const result = await g8.api.workbench.testScraperProviderConnection({ path: { provider: "apify" }, body: { api_key: "example" } });
+```
+
+---
+
+<a id="op-unlockworkbenchrows"></a>
+
+### `g8.api.workbench.unlockWorkbenchRows(input)`
+
+**Unlock Workbench Rows**
+
+- HTTP: `POST /api/v1/workbench/tables/{table_id}/unlock-rows`
+- operationId: `unlock_workbench_rows_workbench_tables__table_id__unlock_rows_post` (also callable as `g8.api.call("unlock_workbench_rows_workbench_tables__table_id__unlock_rows_post", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+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.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `body` | `UnlockStagingRowsRequest` | yes | Request body; fields below. |
+
+Body fields (`UnlockStagingRowsRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.approved_max_credits` | `integer \| null` | no | Ceiling the caller approves. The run refuses to exceed it. min 0 |
+| `body.exclude_row_ids` | `Array<integer> \| null` | no | Rows to leave locked. max items 100000 |
+| `body.operation_id` | `string (uuid) \| null` | no | 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. |
+| `body.quote_expires_at` | `string (date-time) \| null` | no | Expiry of the quote being approved. |
+| `body.row_ids` | `Array<integer> \| null` | no | Rows to act on. OMIT to mean EVERY locked row in the table. max items 100000 |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.unlockWorkbenchRows({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateworkbenchaigroup"></a>
+
+### `g8.api.workbench.updateWorkbenchAiGroup(input)`
+
+**Update Workbench Ai Group**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/ai/groups/{group_id}`
+- operationId: `update_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__put` (also callable as `g8.api.call("update_workbench_ai_group_workbench_tables__table_id__ai_groups__group_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Replace a group's definition. FREE - editing runs nothing.
+
+A full replacement, not a patch: `config` is written as given, so read the
+group first and send it back changed rather than sending only the field you
+meant to move.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.group_id` | `string` | yes | AI group id (starts with `ai_enrich`). |
+| `body` | `UpdateAIConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateAIConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.config` | `AIEnrichmentConfigDto` | yes |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.updateWorkbenchAiGroup({
+  path: { table_id: "id", group_id: "id" },
+  body: {
+    config: {
+      config: {},
+      input_mapping: ["example"],
+      model: "example",
+      outputs: [{ name: "Example", type: "example" }],
+      prompt: "example",
+      usecase: "example",
+    },
+  },
+});
+```
+
+---
+
+<a id="op-updateworkbenchpipeline"></a>
+
+### `g8.api.workbench.updateWorkbenchPipeline(input)`
+
+**Update Workbench Pipeline**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/pipelines/{pipeline_id}`
+- operationId: `update_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__put` (also callable as `g8.api.call("update_workbench_pipeline_workbench_tables__table_id__pipelines__pipeline_id__put", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Edit a pipeline; omitted fields are left alone. CAN ARM SPEND when
+`enabled` is true.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.pipeline_id` | `string` | yes | Pipeline id (UUID). |
+| `body` | `UpdateWorkbenchPipelineRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateWorkbenchPipelineRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.enabled` | `boolean \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+| `body.start` | `PipelineStartConfig \| null` | no |  |
+| `body.steps` | `Array<WorkbenchPipelineStep> \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.updateWorkbenchPipeline({ path: { table_id: "id", pipeline_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateworkbenchrow"></a>
+
+### `g8.api.workbench.updateWorkbenchRow(input)`
+
+**Update Workbench Row**
+
+- HTTP: `PATCH /api/v1/workbench/tables/{table_id}/rows/{row_id}`
+- operationId: `update_workbench_row_workbench_tables__table_id__rows__row_id__patch` (also callable as `g8.api.call("update_workbench_row_workbench_tables__table_id__rows__row_id__patch", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Set ONE field on one row - the grid's cell edit.
+
+One field per call, matching the app. A whole-row PUT would make a
+concurrent edit to a different cell silently lose.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `path.row_id` | `integer` | yes | Row id. |
+| `body` | `WorkbenchRowUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchRowUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.field` | `string` | yes | min length 1, max length 255 |
+| `body.value` | `unknown` | yes |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.updateWorkbenchRow({
+  path: { table_id: "id", row_id: 123 },
+  body: { field: "example", value: {} },
+});
+```
+
+---
+
+<a id="op-updateworkbenchtable"></a>
+
+### `g8.api.workbench.updateWorkbenchTable(input)`
+
+**Update Workbench Table**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}`
+- operationId: `update_workbench_table_workbench_tables__table_id__put` (also callable as `g8.api.call("update_workbench_table_workbench_tables__table_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Rename or re-describe. `entity_type` is fixed at creation.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Table id (UUID). |
+| `body` | `WorkbenchTableUpdateRequest` | yes | Request body; fields below. |
+
+Body fields (`WorkbenchTableUpdateRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.description` | `string \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.updateWorkbenchTable({ path: { table_id: "id" }, body: {} });
+```
+
+---
+
+<a id="op-updateworkbenchtrigger"></a>
+
+### `g8.api.workbench.updateWorkbenchTrigger(input)`
+
+**Update Workbench Trigger**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/triggers/{trigger_id}`
+- operationId: `update_workbench_trigger_workbench_tables__table_id__triggers__trigger_id__put` (also callable as `g8.api.call("update_workbench_trigger_workbench_tables__table_id__triggers__trigger_id__put", input)`)
+- Tier: `billable`: spends credits; the SDK never blindly retries it; confirm cost before bulk use
+- API-key scope: `lists:run`
+
+Edit an automation trigger. CAN ARM ONGOING SPEND.
+
+A PATCH in spirit: omitted fields are left alone. `enabled` true on a
+trigger whose action is an AI pass means each matching row is enriched -
+and charged - as it arrives.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.trigger_id` | `integer` | yes | Trigger id. |
+| `body` | `UpdateTriggerRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateTriggerRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.action_config` | `Record<string, unknown> \| null` | no |  |
+| `body.conditions` | `Record<string, unknown> \| null` | no |  |
+| `body.enabled` | `boolean \| null` | no |  |
+| `body.name` | `string \| null` | no |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+// billable: spends credits; the SDK never blindly retries it; confirm cost before bulk use.
+const result = await g8.api.workbench.updateWorkbenchTrigger({ path: { table_id: "id", trigger_id: 123 }, body: {} });
+```
+
+---
+
+<a id="op-updateworkbenchwaterfall"></a>
+
+### `g8.api.workbench.updateWorkbenchWaterfall(input)`
+
+**Update Workbench Waterfall**
+
+- HTTP: `PUT /api/v1/workbench/tables/{table_id}/waterfall/configs/{column_id}`
+- operationId: `update_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__put` (also callable as `g8.api.call("update_workbench_waterfall_workbench_tables__table_id__waterfall_configs__column_id__put", input)`)
+- Tier: `write`: creates or changes records; the SDK sends an Idempotency-Key and retries transient failures
+- API-key scope: `lists:write`
+
+Replace a waterfall column's steps and settings. Free: editing runs nothing.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.table_id` | `string` | yes | Workbench table id (UUID). |
+| `path.column_id` | `integer` | yes | The waterfall column id. |
+| `body` | `UpdateWaterfallConfigRequest` | yes | Request body; fields below. |
+
+Body fields (`UpdateWaterfallConfigRequest`):
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `body.config` | `WaterfallConfig` | yes |  |
+
+**Returns** `ApiResponse_EnrichmentPayload_`: the envelope `{ data: EnrichmentPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.workbench.updateWorkbenchWaterfall({
+  path: { table_id: "id", column_id: 123 },
+  body: {
+    config: {
+      column_id: "id",
+      field_to_enrich: "example",
+      name: "Example",
+      steps: [
+        {
+          action: "example",
+          action_display_name: "Example",
+          id: "id",
+          order: 1,
+          provider: "example",
+        },
+      ],
+    },
+  },
+});
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-aienrichmentconfigdto"></a>
+
+### `AIEnrichmentConfigDto`
+
+A full AI enrichment group definition.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `config` | `AIConfigDto` | yes |  |
+| `input_mapping` | `Array<string>` | yes | min items 1, max items 100 |
+| `model` | `string` | yes |  |
+| `outputs` | `Array<AIOutputFieldDto>` | yes | min items 1, max items 50 |
+| `prompt` | `string` | yes | min length 1, max length 20000 |
+| `usecase` | `string` | yes |  |
+| `column_mappings` | `Array<AIColumnMappingDto>` | no |  |
+| `created_at` | `string \| null` | no |  |
+| `created_by` | `string \| null` | no |  |
+| `description` | `string \| null` | no |  |
+| `group_id` | `string \| null` | no |  |
+| `id` | `string (uuid) \| null` | no |  |
+| `is_global` | `boolean` | no | default `true` |
+| `json_schema` | `Record<string, "string" \| "number" \| "boolean"> \| null` | no |  |
+| `list_id` | `integer \| null` | no |  |
+| `name` | `string \| null` | no |  |
+| `org_id` | `string \| null` | no |  |
+| `output_format` | `string` | no | default `"fields"` |
+| `updated_at` | `string \| null` | no |  |
+
+<a id="type-findpeoplesearchfilter"></a>
+
+### `FindPeopleSearchFilter`
+
+One condition narrowing the people search.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `field` | `string` | yes | min length 1, max length 255 |
+| `operator` | `"any_of" \| "any_of_with_simular" \| "any_off" \| "any_off_with_simular" \| "all_of" \| "none_of" \| "empty" \| "not_empty" \| …` | yes |  |
+| `value` | `Array<string>` | no |  |
+
+<a id="type-formulaoutputcolumndef"></a>
+
+### `FormulaOutputColumnDef`
+
+One output of a multi-output formula.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `display_name` | `string` | yes | min length 1, max length 255 |
+| `name` | `string` | yes | min length 1, max length 255, pattern `^[a-z][a-z0-9_]*$` |
+
+<a id="type-outputcolumndef"></a>
+
+### `OutputColumnDef`
+
+One column an AI pass writes into.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `name` | `string` | yes | min length 1, max length 255 |
+| `display_name` | `string \| null` | no |  |
+| `mapping_target` | `string \| null` | no |  |
+| `type` | `string` | no | default `"text"` |
+
+<a id="type-pipelinestartconfig"></a>
+
+### `PipelineStartConfig`
+
+What starts the pipeline.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `type` | `"email_pdf" \| "webhook" \| "scraper_bot" \| "ingest"` | yes |  |
+| `expected_fields` | `Array<PipelineExpectedField>` | no |  |
+| `source_types` | `Array<string>` | no |  |
+
+<a id="type-waterfallconfig"></a>
+
+### `WaterfallConfig`
+
+A complete waterfall definition. `org_id` and `created_by` are accepted for shape parity with the app and IGNORED: the organisation always comes from the API key.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `column_id` | `string` | yes |  |
+| `field_to_enrich` | `string` | yes |  |
+| `name` | `string` | yes |  |
+| `steps` | `Array<WaterfallStep>` | yes |  |
+| `auto_update` | `boolean` | no | default `true` |
+| `created_by` | `string \| null` | no | Ignored. |
+| `data_type` | `string` | no | default `"text"` |
+| `email_verification` | `EmailVerificationConfig \| null` | no |  |
+| `hide_provider_columns` | `boolean` | no | default `true` |
+| `id` | `string (uuid) \| null` | no |  |
+| `is_existing_column` | `boolean` | no | default `false` |
+| `is_global` | `boolean` | no | default `true` |
+| `list_id` | `integer \| null` | no |  |
+| `list_routing` | `WaterfallListRouting \| null` | no |  |
+| `only_run_if` | `string \| null` | no | Run condition formula. |
+| `org_id` | `string \| null` | no | Ignored: the key's organisation is used. |
+| `output_successful_provider` | `boolean` | no | default `false` |
+| `skip_existing_values` | `boolean` | no | default `true` |
+| `skip_recently_enriched` | `boolean` | no | default `true` |
+| `target_column_name` | `string \| null` | no |  |
+| `validate_emails` | `boolean` | no | Deprecated: use `email_verification`. default `false` |
+
+<a id="type-workbenchbindingitem"></a>
+
+### `WorkbenchBindingItem`
+
+One workflow output rendered as one grid column.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `column_name` | `string` | yes | Display name of the column. |
+| `column_type` | `"computed" \| "ai" \| "enrichment" \| "state" \| "action" \| "review"` | yes | How the grid treats the column. |
+| `node_id` | `string` | yes | The workflow node whose output feeds the column. |
+| `output_path` | `string` | yes | Dot path into that node's output. |
+| `config` | `Record<string, unknown> \| null` | no | Column-type settings. |
+| `display_mode` | `string` | no | How the cell renders. default `"text"` |
+| `sort_order` | `integer` | no | Position among the bound columns. default `0` |
+
+<a id="type-workbenchpipelinestep"></a>
+
+### `WorkbenchPipelineStep`
+
+One step. A `branch` step runs `if_steps` or `else_steps`.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `id` | `string` | yes | min length 1, max length 255 |
+| `name` | `string` | yes | min length 1, max length 255 |
+| `type` | `"ai_group" \| "waterfall" \| "formula" \| "branch" \| "export_to_list"` | yes |  |
+| `column_id` | `integer \| null` | no |  |
+| `conditions` | `Array<Record<string, unknown>> \| null` | no |  |
+| `else_steps` | `Array<WorkbenchPipelineBranchStep>` | no |  |
+| `enabled` | `boolean` | no | default `true` |
+| `group_id` | `string \| null` | no |  |
+| `if_steps` | `Array<WorkbenchPipelineBranchStep>` | no |  |
+| `inline_config` | `Record<string, unknown> \| null` | no |  |
+| `template` | `string \| null` | no |  |