Where to look: Workflow → Flight
Flight is the ledger of every agent run for the pinned client — successful, in progress, and failed.
Make sure the right client is pinned in the client picker.
Switch to Workflow using the product toggle.
Open Flight in the left rail.
Find the run in the list and select it to see its details.
Each run shows its full lifecycle: what it was asked to do, its current status, and — for failed runs — the reason it didn't complete.
Understanding the status and reason
A failed run isn't a mystery box. The run's detail view tells you:
Status — where the run ended up (for example, failed rather than completed).
Reason — a plain explanation of why it stopped.
Output — anything the run produced before it stopped, which can still be useful.
The reason is the key piece. It usually falls into one of a few buckets:
A data problem — the run needed data that isn't connected or available for this client. Check Workflow → Coverage to confirm the source is connected; if it isn't, that gets fixed in nova.
A one-off hiccup — something temporary got in the way. These often succeed on a second attempt.
Something about the request — the task needs adjusting before it can succeed.
Trying again
If the reason looks like a one-off, simply run the agent again — kick it off the same way you did the first time, whether that was from a signal, the Workflow board, or an agent chat. Many failures don't repeat.
Tip: If the reason points at missing data, fix the data connection first — re-running before the source is connected will just fail the same way.
When to ask for help
The failure reason mentions access or permissions — contact the IT team.
The failure keeps repeating with the same reason and it isn't a data gap you can close in nova — reach out to the IT team with the run's details from Flight, including the status and reason you see there.
You're not sure what the reason means — ask Iris in Chat; it can help you interpret it.
Note: Failed runs don't harm anything — nothing is published or changed by a run that didn't complete. It's always safe to investigate at your own pace.
