Reference · 15 operations

Tables, columns and views

Data tables in the workspace, their typed columns and rows.

Last updated from API version 2026-10-06 at 2026-10-23 19:43 UTC (live spec, refreshed hourly). openapi.json

Tables

tables.list

List data tables, newest first.

get/api/v1/tables

Scope: read
Credits: Free
Idempotency-Key: Not used

Cursor-paginated (meta.page). Archived tables are left out unless includeArchived=true.

Parameters

limitqueryinteger
Page size.

default 50min 1max 200
cursorquerystring
Opaque cursor from meta.page.nextCursor. Reusing it with other filters is 400 CURSOR_MISMATCH.
includeArchivedqueryboolean
Include archived tables.

default false

Responses

200

OK.

Show schema

TableListResponse

dataarray of TableSummaryrequired
0
metaPagedResponseMetarequired
Metadata on a paginated success response.

0

Errors

curl "https://app.owlbound.ai/api/v1/tables" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06"

tables.create

Create a table, optionally with typed columns.

post/api/v1/tables

Scope: write
Credits: Free
Idempotency-Key: optional

Column keys are derived from names unless given; an explicit key that is taken is 409 COLUMN_KEY_CONFLICT. Types not available yet for this workspace (e.g. formula on some workspaces) are 400 VALIDATION_ERROR on columns[i].type. An action column runs one read or spend action operation per row (see TableColumn config); its config is checked against the operation's input schema (400 VALIDATION_ERROR), and write, external_write and send operations are 422 ACTION_NOT_ALLOWED until approvals ship.

Parameters

Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

TableCreateRequest

namestringrequired
max length 120
descriptionstring | null
max length 500
settingsobject
Table settings (some workspaces ignore them).

0
columnsarray of TableColumnInput
max items 500

Responses

200

OK.

Show schema

TableResponse

dataTablerequired
One data table with its columns (by position) and views.

0
metaResponseMetarequired
Metadata on every success response.

0

Errors

400 The request is invalid (VALIDATION_ERROR, CURSOR_MISMATCH, UNSUPPORTED_FILTER) · 401 Missing, invalid, expired or revoked key · 403 Missing scope, suspended workspace or unavailable identity · 404 Unknown resource or route. A resource in another workspace is also 404 · 409 IDEMPOTENCY_IN_PROGRESS (the first request with this key is still running; `Retry-After` is the lease left, at most 60 s) or IDEMPOTENCY_RESULT_UNAVAILABLE (the original result was too large to store; `details.originalRequestId`). · 422 IDEMPOTENCY_KEY_REUSED (the key was used with another body or operation), or an action that cannot run · 429 Rate limit reached · 500 Unexpected error · 503 The backend is unreachable; retry after `Retry-After`. Every error is {error: {type, code, message, requestId, docUrl}}; see error codes.

curl -X POST "https://app.owlbound.ai/api/v1/tables" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table"
}'

tables.get

Get one table with its typed columns and views.

get/api/v1/tables/{id}

Scope: read
Credits: Free
Idempotency-Key: Not used

Column config is returned without credential-looking keys. A table in another workspace, or an archived table without includeArchived=true, is 404 NOT_FOUND.

Parameters

idpathstringrequired
The table id.
includeArchivedqueryboolean
Include archived tables.

default false

Responses

200

OK.

Show schema

TableResponse

dataTablerequired
One data table with its columns (by position) and views.

0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl "https://app.owlbound.ai/api/v1/tables/$ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06"

tables.update

Rename a table or change its description.

patch/api/v1/tables/{id}

Scope: write
Credits: Free
Idempotency-Key: optional

Parameters

idpathstringrequired
The table id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

TableUpdateRequest

namestring
max length 120
descriptionstring | null
max length 500

Responses

200

OK.

Show schema

TableSummaryResponse

dataTableSummaryrequired
A data table as listed.

0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X PATCH "https://app.owlbound.ai/api/v1/tables/$ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table",
  "description": "Created from the API"
}'

tables.archive

Archive a table.

delete/api/v1/tables/{id}

Scope: write
Credits: Free
Idempotency-Key: optional

The table and its rows are kept; it reads as 404 unless includeArchived=true.

Parameters

idpathstringrequired
The table id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Responses

200

OK.

Show schema

TableArchiveResponse

dataobjectrequired
0
+ Show child fields− Hide child fields
- idstringrequired
  0
- archivedbooleanrequired
  0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X DELETE "https://app.owlbound.ai/api/v1/tables/$ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)"

Columns

tables.columns.list

List a table's columns by position.

get/api/v1/tables/{id}/columns

Scope: read
Credits: Free
Idempotency-Key: Not used

Parameters

idpathstringrequired
The table id.

Responses

200

OK.

Show schema

TableColumnListResponse

dataarray of TableColumnrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl "https://app.owlbound.ai/api/v1/tables/$ID/columns" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06"

tables.columns.create

Add a column.

post/api/v1/tables/{id}/columns

Scope: write
Credits: Free
Idempotency-Key: optional

An explicit key that is taken is 409 COLUMN_KEY_CONFLICT. width is clamped to 60..800.

Parameters

idpathstringrequired
The table id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

any

Responses

200

OK.

Show schema

TableColumnResponse

dataTableColumnrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X POST "https://app.owlbound.ai/api/v1/tables/$ID/columns" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table",
  "type": "text"
}'

tables.columns.reorder

Set the column order.

post/api/v1/tables/{id}/columns/reorder

Scope: write
Credits: Free
Idempotency-Key: optional

columnIds must list every column of the table exactly once.

Parameters

idpathstringrequired
The table id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

TableColumnReorderRequest

columnIdsarray of stringrequired
0

Responses

200

OK.

Show schema

TableColumnListResponse

dataarray of TableColumnrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X POST "https://app.owlbound.ai/api/v1/tables/$ID/columns/reorder" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "columnIds": [
    "<columnIds>"
  ]
}'

tables.columns.update

Rename, reconfigure, hide, resize or move a column.

patch/api/v1/tables/{id}/columns/{columnId}

Scope: write
Credits: Free
Idempotency-Key: optional

The column type cannot be changed here yet (type is not accepted).

Parameters

idpathstringrequired
The table id.
columnIdpathstringrequired
The column id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

TableColumnUpdateRequest

namestring
max length 80
configobject | null
0
hiddenboolean
0
widthnumber | null
0
positionnumber
0

Responses

200

OK.

Show schema

TableColumnResponse

dataTableColumnrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X PATCH "https://app.owlbound.ai/api/v1/tables/$ID/columns/$COLUMN_ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table",
  "config": {},
  "hidden": false
}'

tables.columns.delete

Delete a column and its values.

delete/api/v1/tables/{id}/columns/{columnId}

Scope: write
Credits: Free
Idempotency-Key: optional

Parameters

idpathstringrequired
The table id.
columnIdpathstringrequired
The column id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Responses

200

OK.

Show schema

TableDeletedResponse

dataobjectrequired
0
+ Show child fields− Hide child fields
- idstringrequired
  0
- deletedbooleanrequired
  0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X DELETE "https://app.owlbound.ai/api/v1/tables/$ID/columns/$COLUMN_ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)"

Views

tables.views.list

List a table's views.

get/api/v1/tables/{id}/views

Scope: read
Credits: Free
Idempotency-Key: Not used

Parameters

idpathstringrequired
The table id.

Responses

200

OK.

Show schema

TableViewListResponse

dataarray of TableViewrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl "https://app.owlbound.ai/api/v1/tables/$ID/views" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06"

tables.views.create

Save a view: a filter, sorts, hidden columns and a column order.

post/api/v1/tables/{id}/views

Scope: write
Credits: Free
Idempotency-Key: optional

filter and sorts are validated against the table's columns (400 INVALID_FILTER).

Parameters

idpathstringrequired
The table id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

TableViewCreateRequest

namestringrequired
max length 120
filterany
A filter tree (the filter language), or null for none.

0
sortsarray of object
max items 3
+ Show child fields− Hide child fields
- columnstringrequired
  0
- directionstring
  ascdesc
hiddenColumnKeysarray of string
0
columnOrderarray of string | null
0
isDefaultboolean
0

Responses

200

OK.

Show schema

TableViewResponse

dataTableViewrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X POST "https://app.owlbound.ai/api/v1/tables/$ID/views" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table"
}'

tables.views.update

Change a view.

patch/api/v1/tables/{id}/views/{viewId}

Scope: write
Credits: Free
Idempotency-Key: optional

Parameters

idpathstringrequired
The table id.
viewIdpathstringrequired
The view id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Request body (required) · application/json

any

Responses

200

OK.

Show schema

TableViewResponse

dataTableViewrequired
0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X PATCH "https://app.owlbound.ai/api/v1/tables/$ID/views/$VIEW_ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My first table"
}'

tables.views.delete

Delete a view.

delete/api/v1/tables/{id}/views/{viewId}

Scope: write
Credits: Free
Idempotency-Key: optional

Parameters

idpathstringrequired
The table id.
viewIdpathstringrequired
The view id.
Idempotency-Keyheaderstring
1 to 255 printable ASCII characters, scoped to the API key (a rotated key shares its predecessor's keys) and kept 24 h. Accepted on every POST, PATCH and DELETE (ignored on GET); required from v1 keys where the operation says x-owlbound-idempotent: required (missing: 400 VALIDATION_ERROR, param: Idempotency-Key). Same key and body after completion: the stored response is replayed with Idempotent-Replayed: true. Results over 64 KB are not stored; their replay is 409 IDEMPOTENCY_RESULT_UNAVAILABLE with details.originalRequestId (check state with a GET). Same key while the first request runs: 409 IDEMPOTENCY_IN_PROGRESS with Retry-After. Same key, other body or operation: 422 IDEMPOTENCY_KEY_REUSED. A request that ended 5xx may be retried with the same key. 4xx results are stored and replayed too: a 402 INSUFFICIENT_CREDITS replays even after a top-up, so use a new Idempotency-Key after adding credits.

min length 1max length 255

Responses

200

OK.

Show schema

TableDeletedResponse

dataobjectrequired
0
+ Show child fields− Hide child fields
- idstringrequired
  0
- deletedbooleanrequired
  0
metaResponseMetarequired
Metadata on every success response.

0

Errors

curl -X DELETE "https://app.owlbound.ai/api/v1/tables/$ID/views/$VIEW_ID" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06" \
  -H "Idempotency-Key: $(uuidgen)"

Actions

tables.actions.list

The table's action log, newest first.

get/api/v1/tables/{id}/action-log

Scope: read
Credits: Free
Idempotency-Key: Not used

Every write through the API: what, who (actor and API key), request id and a summary.

Parameters

idpathstringrequired
The table id.
limitqueryinteger
Page size.

default 50min 1max 200
cursorquerystring
Opaque cursor from meta.page.nextCursor. Reusing it with other filters is 400 CURSOR_MISMATCH.

Responses

200

OK.

Show schema

TableActionListResponse

dataarray of TableActionEntryrequired
0
metaPagedResponseMetarequired
Metadata on a paginated success response.

0

Errors

curl "https://app.owlbound.ai/api/v1/tables/$ID/action-log" \
  -H "Authorization: Bearer $OWLBOUND_API_KEY" \
  -H "Owlbound-Version: 2026-10-06"

Models on this page

Shared objects the operations above link to. Clients must ignore fields they do not know.

TableSummaryobject

A data table as listed.

idstringrequired
0
namestringrequired
0
descriptionstring | nullrequired
0
rowCountintegerrequired
min 0
versionnumberrequired
Grows on every change (opaque; compare, never compute).

0
createdAtnumberrequired
0
updatedAtnumberrequired
0
archivedAtnumber | nullrequired
0

PagedResponseMetaobject

Metadata on a paginated success response.

requestIdstringrequired
0
creditsCreditsMetarequired
0
pagePageMetarequired
Cursor pagination. hasMore is the only end signal; pages may be short.

0

CreditsMetaobject

usednumberrequired
Credits charged by this request. Reads are free.

0
balancenumber
0
estimatednumber
Dry run only (action operations).

0
availablenumber
Dry run only (action operations).

0
reservationIdstring | null
Async operations only; the job settles this reservation.

0

PageMetaobject

Cursor pagination. hasMore is the only end signal; pages may be short.

nextCursorstring | nullrequired
0
hasMorebooleanrequired
0
limitintegerrequired
min 1max 200

TableColumnInputobject

namestringrequired
max length 80
typestringrequired
Column type (store-neutral). Cells hold JSON numbers for number, booleans for boolean, ISO 8601 strings for date, an option string for select, arrays for multi_select, and any JSON for computed types (ai, enrichment, json, ...). Clients must accept unknown values.

textnumberbooleanselectmulti_selectdateurlemailphonejsonlinked_contactlinked_companyformulaaienrichmentwaterfalllookupaction
keystring
Stable cell key (letters, digits, _; not starting with _). Derived from the name when absent.

0
configobject
Column configuration (select options, AI prompt, ...).

0
hiddenboolean
0
widthnumber | null
0
positionnumber
0

Tableobject

One data table with its columns (by position) and views.

idstringrequired
0
namestringrequired
0
descriptionstring | nullrequired
0
rowCountintegerrequired
min 0
versionnumberrequired
0
createdAtnumberrequired
0
updatedAtnumberrequired
0
archivedAtnumber | nullrequired
0
columnsarray of TableColumnrequired
0
viewsarray of TableViewrequired
0

TableColumnobject

idstringrequired
0
keystringrequired
Stable cell key; row cells are keyed by it.

0
namestringrequired
0
typestringrequired
Column type (store-neutral). Cells hold JSON numbers for number, booleans for boolean, ISO 8601 strings for date, an option string for select, arrays for multi_select, and any JSON for computed types (ai, enrichment, json, ...). Clients must accept unknown values.

textnumberbooleanselectmulti_selectdateurlemailphonejsonlinked_contactlinked_companyformulaaienrichmentwaterfalllookupaction
positionnumberrequired
0
configanyrequired
Column configuration (options, prompts, ...), without credential-looking keys. action columns: {operationId, inputs, input, resultPath}: operationId a read or spend action (GET /action-types; operations that need a LinkedIn identity and list operations are not available as columns), inputs maps the operation's record fields to column keys (operations that only take contacts run on the row's linked contact), input is the operation's input (text values may reference columns as {{Column}}), resultPath the result field written to the cell (default per operation).

0
hiddenbooleanrequired
0
widthnumber | nullrequired
0

TableViewobject

idstringrequired
0
namestringrequired
0
filteranyrequired
The view's filter (the filter language; null when none).

0
sortsarray of anyrequired
0
hiddenColumnKeysarray of stringrequired
0
columnOrderarray of string | nullrequired
0
isDefaultbooleanrequired
0
createdAtnumberrequired
0
updatedAtnumberrequired
0

ResponseMetaobject

Metadata on every success response.

requestIdstringrequired
0
creditsCreditsMetarequired
0
pagePageMeta
Cursor pagination. hasMore is the only end signal; pages may be short.

0
dryRunboolean
True only on a dry-run response (action operations).

0

TableActionEntryobject

idstringrequired
0
actionstringrequired
0
statusstringrequired
0
actorTypestringrequired
0
actorIdstringrequired
0
apiKeyIdstring | nullrequired
0
requestIdstring | nullrequired
0
targetanyrequired
0
summaryanyrequired
0
atnumberrequired
0

← All operations