← Tools Reference

Grist

Grist integration (Productivity, Data). Imported from open-connector.

API key8 toolshttps://api.getgrist.com/api
GET
grist_list_workspaces
List the Grist workspaces and documents that the authenticated API key can access on the current Grist site.

/workspaces

GET
grist_get_document
Fetch metadata for a Grist document by document ID or short URL alias.

/docs/{docId}

1 parameter
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
GET
grist_list_tables
List the tables defined in a Grist document.

/docs/{docId}/tables

1 parameter
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
GET
grist_list_columns
List the columns defined in a Grist table.

/docs/{docId}/tables/{tableId}/columns

3 parameters
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
tableIdstringrequiredThe Grist table identifier.
hiddenbooleanoptionalWhether hidden metadata columns should be included.
GET
grist_list_records
List records from a Grist table with optional filtering, sorting, limits, and hidden-column inclusion.

/docs/{docId}/tables/{tableId}/records

6 parameters
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
tableIdstringrequiredThe Grist table identifier.
hiddenbooleanoptionalWhether hidden metadata columns should be included.
sortstringoptionalComma-separated columns to sort by. Prefix with '-' for descending.
filterstringoptionalJSON string that maps column IDs to allowed values arrays, such as '{"pet":["ca…
limitintegeroptionalMaximum number of records to return. Use 0 for no limit.
POST
grist_add_records
Add one or more records to a Grist table.

/docs/{docId}/tables/{tableId}/records

4 parameters
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
tableIdstringrequiredThe Grist table identifier.
noparsebooleanoptionalWhether Grist should store values without automatic parsing.
recordsarrayrequiredRecords to add to the target table.
PATCH
grist_update_records
Update one or more existing Grist records by row ID.

/docs/{docId}/tables/{tableId}/records

4 parameters
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
tableIdstringrequiredThe Grist table identifier.
noparsebooleanoptionalWhether Grist should store values without automatic parsing.
recordsarrayrequiredRecords to update in the target table.
POST
grist_delete_records
Delete one or more records from a Grist table by row ID.

/docs/{docId}/tables/{tableId}/records/delete

3 parameters
ParamTypeRequiredDescription
docIdstringrequiredThe Grist document identifier.
tableIdstringrequiredThe Grist table identifier.
rowIdsarrayrequiredRow IDs to delete from the target table.