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 | out_of_credits | condition_not_met)`. Everything after `running` is terminal — stop polling the cell once it lands on one. `failed` is a known failure path (provider 404, validation failed, duplicate row, missing required input, run stopped); `error` is an unexpected runtime error; `out_of_credits` means the org's credit balance couldn't cover the action, so it never ran — top up and re-run the row. All three carry an `error` message. `condition_not_met` is terminal too — 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""out_of_credits""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 — it returns the same `outputs` shape this cell would have carried inline.

urlstring <uri>required

Absolute URL of the Get Cell Outputs endpoint for this cell. Authorized by the caller's API key like any other endpoint — it never expires and carries no credential of its own, so revoking the key revokes access. Payload fetches are metered in their own quota rather than against the general API rate limit.

size_bytesinteger

Size of the outputs JSON at `url`, in bytes. Only present when the size is known without reading the payload; read `Content-Length` on the fetch otherwise.

errorstring

Human-readable failure message. Present on `failed`, `error` and `out_of_credits` cells.

Example

RowCell example

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