Sheet

A sheet in a workflow. Pass `sheet_id` as the `{sheet_id}` path parameter on every sheet-scoped endpoint.

Properties

sheet_idstring <uuid>required

UUID of the sheet. Pass as `{sheet_id}` on every sheet-scoped endpoint, and as `target_sheet_id` when another sheet routes data here via `send_to_sheet`.

workflow_idstring <uuid>required

UUID of the parent workflow this sheet belongs to.

namestringrequired

Sheet name as set at creation. Not required to be unique within a workflow.

is_main_sheetbooleanrequired

`true` for the workflow's main sheet — auto-created with the workflow, always present, cannot be deleted separately, and has `sheet_id === workflow_id`. `false` for additional sheets added via Create Sheet.

auto_runbooleanrequired

When `true` (default), the sheet's action chain runs automatically whenever new data rows arrive (via Add Data Rows or via a `send_to_sheet` action on another sheet). When `false`, runs must be triggered explicitly with Run Rows.

cache_enabledbooleanrequired

When `true` (default), a row with input column values identical to a previously-run row reuses the previous row's outputs instead of re-running the action chain. Matching compares every input column value on the row as a string, after variable references are resolved.

cache_sincenull | string <date>required

Earliest date (`YYYY-MM-DD`, UTC) from which cached runs are considered fresh. Runs performed on or after this date are reusable; runs performed before are ignored even when inputs match. Ignored when `cache_enabled` is `false`. `null` means all cached runs are considered fresh regardless of age.

Example

Sheet example
{
  "sheet_id": "e5f6a7b8-c9d0-1e2f-3a4b-5c6d7e8f9a0b",
  "workflow_id": "531952c2-3d07-4be2-8c4b-733acba3187b",
  "name": "Employees",
  "is_main_sheet": false,
  "auto_run": false,
  "cache_enabled": false,
  "cache_since": "2026-03-17"
}