WAKATODOCS

Tables

List tables (record types)

GET
/tables

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Response Body

application/json

{}

Create a table (optionally with initial columns)

POST
/tables

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Get a table's full definition (meta + columns + views + row count)

GET
/tables/{tableId}

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Response Body

application/json

{}

Update table metadata (labels/icon/description; archived true/false)

PATCH
/tables/{tableId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Archive a table (default) or permanently delete with ?hard=true

DELETE
/tables/{tableId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Query Parameters

hard?boolean

Response Body

application/json

{}

List/query rows of a table

GET
/tables/{tableId}/rows

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Query Parameters

limit?integer
offset?integer
filters?string

JSON array: [{"column_key","op","value"}] — ops: eq|neq|contains|gt|lt|is_empty|is_not_empty

sort?string

JSON array: [{"column_key","direction"}]

search?string

Substring match on the title column

search_column?string

Response Body

application/json

{}

Create a row

POST
/tables/{tableId}/rows

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Bulk-insert up to 100 rows

POST
/tables/{tableId}/rows/bulk

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Bulk-update up to 100 rows (merge per row)

PATCH
/tables/{tableId}/rows/bulk

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Bulk-delete up to 100 rows by id

POST
/tables/{tableId}/rows/bulk-delete

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Update a row (merge)

PATCH
/tables/{tableId}/rows/{rowId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
rowId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Delete a row

DELETE
/tables/{tableId}/rows/{rowId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
rowId*string

Response Body

application/json

{}

List a table's columns (schema)

GET
/tables/{tableId}/columns

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Response Body

application/json

{}

Add a column (all field types incl. formula/lookup/rollup via field_config)

POST
/tables/{tableId}/columns

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Update a column

PATCH
/tables/{tableId}/columns/{columnId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
columnId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Delete a column (drops its data from all rows)

DELETE
/tables/{tableId}/columns/{columnId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
columnId*string

Response Body

application/json

{}

List a table's views

GET
/tables/{tableId}/views

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Response Body

application/json

{}

Create a view (grid|kanban|gallery|calendar|dashboard)

POST
/tables/{tableId}/views

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Get one view (full config)

GET
/tables/{tableId}/views/{viewId}

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
viewId*string

Response Body

application/json

{}

Update a view

PATCH
/tables/{tableId}/views/{viewId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
viewId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Delete a view

DELETE
/tables/{tableId}/views/{viewId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
viewId*string

Response Body

application/json

{}
GET
/tables/{tableId}/share-links

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Response Body

application/json

{}
POST
/tables/{tableId}/share-links

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}
DELETE
/tables/{tableId}/share-links/{linkId}

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
linkId*string

Response Body

application/json

{}

List a row's comment thread (oldest first)

GET
/tables/{tableId}/rows/{rowId}/comments

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
rowId*string

Query Parameters

limit?integer

Response Body

application/json

{}

Add a comment to a row (posted as the agent)

POST
/tables/{tableId}/rows/{rowId}/comments

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
rowId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

List Time Machine snapshots

GET
/tables/{tableId}/snapshots

Required scope: tables:read

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Query Parameters

limit?integer

Response Body

application/json

{}

Capture a named save point (schema + rows + views)

POST
/tables/{tableId}/snapshots

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

{}

Restore the table to a snapshot (atomic, reversible)

POST
/tables/{tableId}/snapshots/{snapshotId}/restore

Required scope: tables:write

Authorization

bearerAuth
AuthorizationBearer <token>

A Space API key, e.g. wks_live_….

In: header

Path Parameters

tableId*string
snapshotId*string

Response Body

application/json

{}

Audiences

Previous Page

Automations

Next Page