Skip to content

Daily work

Flow detail

One Flow's full picture: configuration, recent runs, throughput, and the Run-now button.

Who uses this
Every authenticated team member.

What it is

The detail screen for a single Flow. Tells you when it last ran, when it runs next, what it's configured to do, and how recent runs went.

What you can do here

  • Read the configuration — Slate Query — In Progress URL, Slate Query — Positive Outcomes URL, Slate Source Format — Writeback URL, cadence, use case.
  • Test Connection (sky-blue, Plug icon) — exercises every leg of the round-trip with live credentials. Fails fast with MISSING_IDENTIFIER_COLUMN if your In Progress Query lacks a person identifier — see the In Progress Query requirements doc for the fix.
  • Refresh fields (indigo, RefreshCw icon) — re-probes both queries and adds any newly-introduced columns to the data dictionary as pending. Use after you change a Slate query to see new fields without waiting for the next scheduled run.
  • Run now (amber, Play icon) — pushes next_run_at to the past so the scheduler picks the Flow up on its next sweep (≤15 min). Bypasses the cadence schedule for ad-hoc testing. Disabled when the Flow is paused.
  • Activate / Deactivate (green or red, Power icon) — flips the Flow on/off. A deactivated Flow is skipped by the scheduler.
  • Pause schedule (amber, Pause icon, only visible while active) — one-click escape that disables the Flow so you can edit configuration safely or delete the Flow.
  • Delete (red, Trash icon) — only available when the Flow is paused. Deletion is permanent (run history is preserved in the audit log).
  • Resume Flow (emerald, RotateCw icon, only visible when auto-paused) — restarts a Flow that auto-paused after consecutive failures. Click after you've fixed the underlying config issue (usually a Slate-side query change).
  • Open recent runs — each run has its own forensics page at /flow-runs/[runId].
  • Edit cadence — jump to /flows/[id]/schedule.

Common workflows

Verify a brand-new Flow

  1. Open the Flow detail.
  2. Click Run now.
  3. Wait for the run to complete (usually under a minute for small batches).
  4. Open the run from the Recent runs list to inspect what was scored and what was written back.

Investigate a failure

  1. Open the failed run from Recent runs.
  2. Read the Errors section. Most failures point at a Slate-side config problem.
  3. Fix it in Slate, then click Run now to retry.

Common gotchas

Run now is disabled

The Flow is paused or another run is in flight. Wait for the current run to complete or unpause.

Configuration is locked

A run is currently in flight. Wait for it to finish — config edits during a run can corrupt the Writeback target.