Skip to main content

Executions

The Executions page shows the history of every workflow run — what triggered it, which nodes ran, how long each took, what they produced, and whether they succeeded or failed.


Execution List

Navigate to Executions in the left sidebar. The list shows all executions across all workflows in your project, sorted newest-first.

Each row shows:

ColumnDescription
Status✅ Completed / ❌ Failed / 🟡 Paused (HiL) / ⏳ Running
WorkflowName of the workflow that ran
TriggerHow it was triggered (Manual / Webhook / Schedule)
StartedTimestamp when execution began
DurationTotal time from start to completion
Initiated byUser who triggered (or "Scheduled" for cron runs)

Filtering

Filter by:

  • Workflow — Show executions for a specific workflow
  • Status — Show only completed / failed / paused
  • Date range — Executions from a specific period

Execution Detail View

Click any execution row to open the detail view. This shows:

Overview Panel

  • Execution ID — Unique identifier
  • Status — Current status
  • Workflow — Which workflow ran
  • Trigger input — What {{trigger.output}} contained
  • Start/end time — Full timestamps
  • Total duration — End-to-end time

Node Results

Expandable list of all nodes in the workflow, in execution order:

▶ [Trigger] — Completed in 0.01s
▶ [Agent: researcher] — Completed in 8.4s
▼ [Agent: writer] — Completed in 3.2s
Input:
Research findings:
[Quantum computing is the use of...]

Please format as a blog post.

Output:
## Quantum Computing: A Beginner's Guide

Quantum computing represents one of the most...

Tool Calls: none

▶ [Output] — Completed in 0.01s

Node Expansion Details

Expanding a node shows:

SectionContent
InputThe fully-resolved input text sent to the node (expressions already substituted)
OutputThe node's output text
DurationTime taken for this node
Tool CallsList of capability/MCP tool calls made (for agent nodes)
ErrorError message and stack trace (if failed)

Execution States

StateIndicatorDescription
RunningBlue pulsing dotActively executing
CompletedGreen checkmarkAll nodes finished successfully
FailedRed XOne or more nodes failed
PausedYellow clockWaiting for Human-in-Loop approval
RejectedRed stopHiL decision was "reject"
CancelledGray dashManually cancelled

Re-Running an Execution

You can re-run any completed or failed execution:

  1. Open the execution detail.
  2. Click Re-run (top right).
  3. A modal appears — the original input is pre-filled.
  4. Optionally modify the input.
  5. Click Execute.

A new execution starts. The original execution record is not modified.

Re-run with the same input

If you re-run without changing the input, you'll get a fresh execution with the same trigger input. For non-deterministic agents (temperature > 0), the output will likely differ slightly each time.


Cancelling a Running Execution

If an execution is taking too long or you need to stop it:

  1. Open the Executions list (or the workflow detail page).
  2. Find the running execution (blue indicator).
  3. Click Cancel.

Cancellation is immediate — TARX stops the execution as soon as the signal is received, interrupting the node that's mid-flight (including an in-progress LLM call), so you stop spending tokens right away. Already-completed nodes' outputs are preserved in the record, and the run is marked Cancelled.


Deleting a Run

You can permanently remove a finished execution — handy for clearing out cancelled runs or early errors, similar to deleting a pipeline run in a CI system.

  1. Open the workflow detail page and hover over a finished run.
  2. Click the trash icon on the right.
  3. Confirm in the dialog.

The execution record is deleted from the database and its stored logs are removed from blob storage. This is permanent and cannot be undone.

Canvas data

Workflows are a data source for Canvas charts. Deleting a run removes its data from any Canvas that aggregates this workflow — charts will have one fewer data point on their next refresh.

Active runs can't be deleted

A run that is Running, Pending, or Paused (awaiting approval) cannot be deleted. Cancel it first, then delete.


Human-in-Loop Approvals

Paused executions (waiting for HiL approval) appear with a 🟡 yellow indicator. To approve or reject:

  1. Click the paused execution.
  2. Find the Human-in-Loop node in the node list.
  3. See the display content shown for review.
  4. Enter an optional comment in the Comment field.
  5. Click Approve (green) or Reject (red).

After your decision, the execution status updates and the workflow resumes (if approved) or ends (if rejected).

See Human-in-Loop for full details.


Execution Logs

For each execution, detailed logs are stored securely in the cloud. These include:

  • Full LLM prompts and responses (for debugging)
  • Tool call details (arguments and results)
  • Timing information for each step
  • Error tracebacks

Detailed logs are retained for 30 days. After that, the execution summary (status, duration, per-node statuses) remains available, but the full input/output text is no longer retained.


Execution Statistics

The Dashboard (home page of your project) shows aggregate execution stats:

MetricDescription
Total executionsAll-time execution count
Success rate% of executions that completed without error
Average durationMean execution time
Executions todayCount for the current day
Failures todayCount of failed executions today

These stats help you monitor workflow health and identify problematic workflows.


Debugging Failed Executions

When a workflow fails, the Executions page is your primary debugging tool.

Step 1: Identify the failing node

  • In the node list, the failed node shows a ❌ indicator
  • The error message appears at the top of the execution detail

Step 2: Check the failed node's details

  • Expand the failing node
  • Read the Error section — it shows the exception type and message
  • Check the Input — was the node receiving the right data?

Step 3: Common failure causes

ErrorLikely CauseFix
AgentNotFoundThe agent referenced in the node was deletedRe-select the agent in the canvas node inspector
APIKeyNotFoundThe agent's API key was deletedAdd a new key in Settings → Keys & Secrets, update the agent
ProviderAuthErrorAPI key is invalid or expiredCheck your API key in the provider's dashboard
ProviderRateLimitErrorHit provider rate limitsReduce execution frequency or upgrade your provider plan
ToolCallMaxRoundsExceededAgent used more than 10 tool roundsSimplify the agent's task or increase the limit (contact support)
ExpressionErrorExpression references non-existent variableCheck the expression — does the variable name match the agent name exactly?
HiLTimeoutErrorHiL timed out waiting for approvalIncrease timeout or approve within the window

Step 4: Fix and re-run

  • Make the necessary fix (update agent, fix expression, etc.)
  • Click Re-run from the execution detail
  • Verify the re-run succeeds

Execution Retention

Execution records are stored indefinitely. However:

  • Detailed logs are retained for 30 days
  • After 30 days, only the summary (status, duration, node statuses) is available — not the full input/output text

For compliance-sensitive workflows, consider exporting execution records before the 30-day log retention window.