RowCell

One cell of a row (a single action × a single row). Branch on `status` to decide which of `outputs` / `outputs_ref` / `error` to read.

Properties

statusstringrequired

Lifecycle state of this cell. Progresses `queued → running → (complete | failed | error | condition_not_met)`. `failed` and `error` are terminal failure states — `failed` is a known failure path (e.g. provider 404, validation failed); `error` is an unexpected runtime error. Treat them the same when polling for completion. `condition_not_met` is also terminal — the action's `run_if` (or an upstream `filter`) evaluated false for this row, so the cell never ran; downstream cells stay `queued` unless `continue_workflow_if_run_condition_not_met: true` was set on the gating action.

"queued""running""complete""failed""error""condition_not_met"

outputsobject

Inline outputs for a `complete` cell when the payload is small. Keys are the action's output field names. Absent on non-`complete` cells; absent on `complete` cells with `outputs_ref`.

outputs_refobject

URL pointer to the outputs of a `complete` cell when the payload is too large to inline (e.g. LinkedIn profile scrapes, enrichment blobs). Fetch the URL with the caller's API key to read the data.

urlstring <uri>required

Signed URL to fetch the outputs JSON.

size_bytesintegerrequired

Size of the outputs JSON at `url`, in bytes.

errorstring

Human-readable failure message. Present only on `status: "failed"` cells.

Example

RowCell example

{
  "status": "queued",
  "outputs": {},
  "outputs_ref": {
    "url": "https://example.com",
    "size_bytes": 0
  },
  "error": "string"
}