ExportSheetBody

Body for Export Sheet. All fields optional — omit the body entirely to export every row on the sheet. **Choosing rows** — either name them explicitly with `row_ids`, or narrow with `filters` / `status_filters` / `created_at` (the same shapes List Rows takes). The two cannot combine; the server returns 400 if you mix them. `exclude_row_ids` subtracts from the filtered set. The file is always CSV.

Properties

row_idsarray of

Export exactly these rows. Omit to export every row matching the filters (or the whole sheet). Mutually exclusive with `filters` / `status_filters` / `created_at`. Ids that are not on the sheet are dropped, so `row_count` can be lower than the number sent; a selection that matches nothing is a 400.

string <uuid>
exclude_row_idsarray of

Rows to leave out of the exported set. Applied after the filters; ignored when `row_ids` is given, since that is already an explicit list.

string <uuid>
filtersarray of

Value filters on sheet input columns. Each entry has `variable` (an `{{input.<column>}}` reference), `operator` (one of `is equal to`, `not equal to`, `is empty`, `not empty`, `contains`, `does not contain`, `contains any of`, `not contains any of`, `greater than`, `less than`), and `values` (array of strings — single value for most operators; multiple for `contains any of` / `not contains any of`; empty for `is empty` / `not empty`).

variablestringrequired

Public reference token for the input column to filter on. Must match `{{input.<column>}}`.

operatorstringrequired

Comparison operator. See the description above for the full list.

valuesarray of

Values to compare against. Single-value operators take one item; `contains any of` / `not contains any of` take one or more; `is empty` / `not empty` ignore values.

string
status_filtersarray of

Per-action cell-status filters. Each entry specifies an `action_instance_id` and exactly one of `is` (status matches one of) or `is_not` (status matches none of). Status values use the public vocabulary (`queued | running | complete | failed | error | out_of_credits | condition_not_met`).

action_instance_idstringrequired

Action instance ID (public form) whose per-row cell status to filter on.

isarray of

Match rows whose cell on this action is in one of these statuses.

string
is_notarray of

Match rows whose cell on this action is NOT in any of these statuses.

string
created_atobject

Filter rows by creation timestamp. `operator` is one of `equals to`, `greater than`, `greater than or equals to`, `less than`, `less than or equals to`, `is between`. `values` is `[ISO timestamp]` for single-value operators or `[start, end]` for `is between`.

operatorstringrequired
valuesarray ofrequired
string
file_namestring

Base name for the downloaded file, without extension. Defaults to `export`. Non-alphanumeric characters are replaced and the name is capped at 100 characters.

Example

ExportSheetBody example
{
  "row_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "exclude_row_ids": [
    "00000000-0000-0000-0000-000000000000"
  ],
  "filters": [
    {
      "variable": "{{input.email}}",
      "operator": "contains",
      "values": [
        ".com"
      ]
    }
  ],
  "status_filters": [
    {
      "action_instance_id": "enrich_company_linkedin_profile_1",
      "is": [
        "complete"
      ],
      "is_not": [
        "failed",
        "error"
      ]
    }
  ],
  "created_at": {
    "operator": "greater than",
    "values": [
      "2026-05-07T22:14:00Z"
    ]
  },
  "file_name": "qualified-leads"
}