You can now access workflow automation run data through the Tape API.
A workflow automation run is a single execution of one of your workflow automations. The API lets you list these runs, filter them by app, workflow automation, workspace, or status, and retrieve an individual run together with its logs.
With 5 million workflow automation actions included each month in Tape Premium, the new API endpoint gives you even more visibility into workflow automation runs across your organization.
You can analyze runs at scale, inspect individual runs in more detail, and use the data to monitor and improve your workflow automations.
Get an overview of your workflow automation runs
The first endpoints return workflow automation runs from the last 30 days.
You can filter the results by:
- Workspace
- App
- Date range
- Run status
Each run includes information such as:
- Workflow automation name, ID, revision
- Creation and completion time
- Run status
- Number of workflow automation actions used
- Record and app info this run executed on
Results are returned in pages of up to 500 runs.
This lets you answer questions such as:
- Which workflow automations run most often?
- Which workflow automations use the most actions?
- Which apps generate the most runs?
- Which records trigger the most runs?
- Are there any loops in my automation design?
- How many runs succeeded or failed during a specific period?
Inspect individual runs
The single run endpoint returns the details of a specific workflow automation run.
It includes the individual logs generated during the run, helping you understand what happened at each step and investigate failed runs.
Why use the API instead of the existing CSV export?
The existing CSV export is great for one-time reports and manual or AI-assisted analysis.
For continuous analysis across millions of workflow automation runs, the API offers a more direct way to work with the data. For example, you can:
- Build your own monitoring dashboards
- Create recurring reports
- Detect failed runs automatically
- Combine workflow automation run data with information from other systems
- Store and analyze run data in your own tools
In short:
CSV export ➔ one-time manual or AI-assisted analysis via file upload
API ➔ continuous monitoring, reporting, integrations, and AI-assisted analysis via direct connection
Available to everyone
The API is:
- Available on all Tape plans
- Part of the standard Tape API
The API provides read-only access, allowing you to safely retrieve and analyze runs without modifying, cancelling, or restarting them.
You can find the full documentation here:
New to APIs?
We created a simple step-by-step guide to make the Tape API easier to understand, with examples you can try yourself. It was originally written to help our own non-developer teams understand API concepts more clearly. Start with the API guide ➔