update_webhook
Update Webhook
Update an existing webhook's configuration such as URL, event types, enabled state, or ready column.
update_webhook
Update an existing webhook's configuration such as URL, event types, enabled state, or ready column.
update_document
Update a document's properties such as name and pinned status. Can also move the document to a different workspace.
delete_document
Soft-delete a document (move to trash) or permanently delete it. Soft-deleted documents can be restored.
list_orgs
List all accessible organizations (team sites and personal spaces). Returns org IDs, names, and domains that the authenticated user can access.
add_records
Add one or more records (rows) to a table. Each record is an object of column ID to value mappings.
delete_webhook
Delete a webhook from a document. Optionally clear the pending delivery queue for a specific webhook or all webhooks.
list_webhooks
List all webhooks configured for a document, including their URLs, target tables, event types, and delivery status.
delete_records
Delete records from a table by their record IDs.
list_tables
List all tables in a Grist document. Returns table IDs and metadata.
create_table
Create one or more tables in a Grist document. Each table can be initialized with columns.
add_or_update_records
Upsert records: for each record, check if a matching record exists using the "require" fields. If found, update it with the "fields" values. If not found, create a new record combining "require" and "fields".
fetch_records
Fetch records (rows) from a table with optional filtering, sorting, and limiting. Supports filtering by column values and sorting in ascending/descending order.
create_document
Create a new empty document in a workspace.
list_columns
List all columns in a table. Returns column IDs, types, labels, and other metadata.
delete_workspace
Soft-delete a workspace (move to trash) or permanently delete it. Soft-deleted workspaces can be restored.
get_document
Retrieve details about a specific Grist document, including its name, workspace, and access information.
list_workspaces
List all workspaces in an organization, including their documents. Use the org ID from the List Organizations tool.
run_sql
Execute a read-only SQL SELECT query against a document's SQLite database. Supports parameterized queries to prevent SQL injection. Only SELECT statements are allowed.
update_records
Update existing records in a table by their record IDs. Only specified fields will be modified.
create_workspace
Create a new workspace in an organization.
modify_columns
Create, update, or delete columns in a table. Supports adding new columns with types and formulas, updating existing column properties, or removing columns.
list_attachments
List attachment metadata for a document. Returns file names, sizes, and upload times. Can also clean up unused attachments to free storage.
create_webhook
Create a webhook that sends POST requests to a URL when data changes in a document table. Supports filtering by event types (add, update) and gating with a ready column.
Manage organizations, workspaces, documents, tables, columns, and records in Grist's relational spreadsheet-database. Create and modify tables and columns with typed fields (Text, Numeric, Date, Choice, Ref, etc.). Fetch, add, update, and delete records with filtering, sorting, and upsert support. Upload and manage file attachments. Execute read-only SQL queries against document data. Apply batch operations via user actions. Create and manage webhooks for row-added and row-updated events. Download documents as .grist or .sqlite files. Manage workspace and document access, pinning, and organization.
Common questions about connecting Grist to AI agents with Metorial.