Run

Runs

A run is one execution of a workflow. Every run keeps what it did, step by step, so you can see where it stopped and why.

StateWhat happens next
`queued`A worker claims it and it becomes `running`.Waiting for a worker.
`running``completed`, `failed`, `waiting` or `paused`.A worker holds a lease of 300 seconds.
`waiting`Back to `queued` when its wake-up time passes (checked every minute).A wait step, or a retry backoff.
`paused`Back to `queued` only when someone presses «Resume» and the credit check passes.Stopped by the platform: no credit or a payment problem.
`completed`Nothing. Final.The last step finished.
`failed`Back to `queued` if someone presses «Retry».A step failed, or the engine gave up after three attempts.
`cancelled`Nothing. Final.Someone cancelled it while it was queued, waiting or paused.
Run states
State (as shown)Meaning
«Queued» (queued)Created and waiting for a worker.
«Running» (running)A worker holds it. A run that stays here with nobody working on it is taken over after five minutes.
«Waiting» (waiting)Parked until a moment, either by a wait step or on a retry after an engine error.
«Paused» (paused)The platform stopped it before a step: no credit left, or a payment problem. Only Resume brings it back.
«Completed» (completed)Finished. Final. A run whose failed steps were all caught by a Try also ends here.
«Failed» (failed)Ended with an error. Final, unless someone presses Retry.
«Cancelled» (cancelled)Cancelled by someone. Final.
Note:

A paused run and a paused workflow are different things. A workflow that is ‘paused’ is not live: its automatic triggers do nothing. A paused run is one execution the platform stopped for lack of credit.

Open the «Runs» tab of a workflow. The right panel, «Run history», lists the runs, newest first, each with its state, "Run #n", its credits and how long ago it was queued. Click one to see it.

  • The canvas draws the version that ran, not the draft, so an old run is shown as it really ran even if the workflow has changed since. A card is coloured by its step state: «Not reached», running, waiting, completed, failed or «Caught error» (muted red and dashed: a step that failed inside a Try, which caught it and let the run go on). A card shows its credits when it used any.
  • A card at the top right shows the state, when the run resumes (if waiting), its duration, when it was triggered and when it ended, «Steps run» and «Credits». When it has failed, it shows the error message in red.
  • Click a step to see what went into it («Input») and what came out («Output»), or, for a step that failed, «Error». The viewer refreshes by itself every few seconds while the run is queued, running or waiting.
  • The counters at the top of the editor's side panel («Completed», «Failed», «In progress», «Average time») count all the runs of the workflow that still exist.
  • There is no filter, search or pagination: it shows the 100 newest runs. "Run #n" is the position in that list, so the numbers shift once there are more than 100 runs and older runs cannot be reached.
  • When a step ran several times (in a loop, or after a jump), the step panel shows the first execution's input and output. The card's colour and credits cover all of them.
  • «Triggered» is the moment a worker first picked the run up, not when it was queued.
  • The version number of a run is not shown.
  • Attempts are not shown. A run that is retrying is just waiting, and the reason for the retry is not displayed at run level.
ButtonShown whenWhat it does
«Cancel»The run is queued, waiting or paused.Ends the run as cancelled. The credits already spent stay spent, and no failure notice is sent. A run that a worker is executing right now cannot be cancelled.
«Retry»The run failed.Puts the same run back in the queue with its attempts reset. The steps that completed are replayed from the record and are neither run nor charged again; the step that failed runs again. It uses the same published version, never a newer one.
«Resume»The run is paused.Checks the credit again. If there is credit, the run continues at the step that was blocked. If not, it stays paused and the card says there is still no credit.
  • Only administrators can use these buttons. The interface does not show an error if you press one and cannot (a non-administrator gets nothing, and a run that changed state meanwhile just does not move).
  • A paused run is never woken by the platform, even after you add credit or turn on «Turn on pay-as-you-go». Press Resume.
  • Retrying cannot fix an error that comes from the workflow itself, such as an invalid definition, a loop limit or more than 500 items: it fails the same way. Fix the workflow, then run again; a retry keeps using the old version.
  • Only a failed run can be retried. A cancelled run cannot, and neither can a failed run once it has been deleted after 90 days.

Every run is created by a trigger, by Retry or by Resume (which reuse the run). What decides whether two requests make one run or two:

SourceRepeated delivery
Manual button, from a record, from another workflowAlways a new run. Two clicks are two runs.
REST API or MCPThe Idempotency-Key you send decides: the same key returns the same run for 24 hours.
ScheduleAt most one run per occurrence.
EventAt most one run per workflow for the same change.
SignalOne run per listener per firing; a retry of the firing step does not double it.
WebhookThe Idempotency-Key you send decides; without one, every delivery is a run.

Filmo does not serialize the runs of one workflow: two runs of the same workflow can run in parallel.

A completed, failed or cancelled run is deleted 90 days after it ended, together with its steps, inputs, outputs and errors. Runs that are queued, running, waiting or paused are never deleted. Deleting a workflow deletes its runs at once. Run data can contain your customers' data, so this is also the time it stays in the run history.

Any member can see a workflow's runs unless the workflow is private; then only its creator and administrators can. Failure notices go to the creator or the administrators; see Errors and retries.

  • Run

    Errors and retries

    Two different things go wrong in a run: a step reports a problem, or the engine itself breaks. They are treated differently, and the difference is the most important thing on this page.

  • Run

    Limits and credits

    Each limit below is enforced by the engine. The last column says what happens when you reach it, because that is usually the question.

  • Run

    Troubleshooting

    Start with what you see: the workflow did not run, a run failed, or a run is not moving. Each section lists the likely causes in the order worth checking.