Run retention and exports

Run history retention

What this page covers

This page explains:

• How run history retention works

• How to export a list of past runs as CSV

• How to export an individual historic run as JSON

Run data retention

Relay.app automatically removes old run history based on your workspace's retention setting.

Retention periods per plan type

Plan type	Run history saved for
Free	30 days
Professional or Team	Customizable: 30 days, 90 days, or 1 year
Enterprise	Custom

Which runs gets deleted after the retention periood

Relay.app automatically deletes completed runs and runs with errors that have been stale for longer than the retention period.

Runs that are waiting (because of a Wait step or a Human-in-the-Loop action) are not automatically deleted.

Changing the retention period

Admins of workfspaces on a Professional or Team plan can update the retention period in their workspace's General settings.

Run history exports

Relay.app lets you generate two types of exports:

1. A list of past runs for a workflow as CSV

2. Detailed step execution history of a single run as JSON

Export a list of past runs (CSV)

To export all runs for a workflow:

1. Open the workflow's Runs tab

2. Open the overflow menu for a run list section

3. Click Export all runs

This downloads a CSV file with run metadata. For workflows with thousands of runs, this might take a while (up to 2 minutes)

What's included in the CSV

The CSV includes:

• Name

• Status

• Steps Completed

• AI Credits

• Created At

• Last Updated

• Test Run

Export size limit

CSV export includes up to 100,000 rows per export. If your workflow has more runs than that, the file is truncated.

Export one historic run (JSON)

To export a single run:

1. Open a specific run

2. Open the run actions menu

3. Click Export run

This downloads a JSON file for that run.

What's included in the JSON

The export includes:

• Run metadata (run/workflow IDs, title, status, timestamps, test-run flag)

• Summary metrics (steps completed, AI credits consumed)

• Trigger output (when available)

• Execution history (actions, selected inputs/outputs, errors)

• AI chat history for AI steps (when available)

Common questions

Are retention deletion and manual deletion the same?

No. Retention deletion removes older terminal runs based on age. Manual deletion removes selected runs immediately.