Workflows version history

Version history in Okta Workflows provides a record of changes that were made to a flow over time. Each time you save a flow, a new version is created. Use version history to audit changes, view execution history for specific iterations, and restore a flow to a previous state.

How it works

Okta Workflows tracks versions at the flow level. When you open the Version History tab within a flow, you see a chronological list of versions.

Version creation
A version is created only when a change is saved.
Change information
Each version has a time stamp and the details of what was changed.
User attribution
Each version identifies the user who saved the changes.

Versioning and execution history

When you select a specific version from the list, you can view the execution history that's associated with only that version. This helps you troubleshoot errors between versions such as identifying what specific change caused a flow to fail.

Flow restoration

When you revert to a previous version, Okta Workflows restores it as the active version while preserving your full version history.

Named versions

You can add a name and an optional description to a version to make it easier to find in the Version History panel. A named version displays its name as the primary label instead of only a time stamp and version number. This helps you scan for meaningful milestones, such as a stable release or a checkpoint before a major change, without counting back through save events. See Name a flow version.

Considerations

Here are some important things to consider when using Workflows version history:

Flow export
Version history is local to the flow within its specific org. If you export or copy a flow, the version history isn't included. If you move a flow to a different folder in the same org, the version history is retained.
Connections
Reverting a flow restores the logic and card configurations, but it doesn't change the account connections that it used. Ensure that the required connections are active and authorized.
Retention
All version history is available for up to 90 days from the date each version was created. Named versions are available for preview and revert for the full 90 days. Unnamed versions are available for 30 days. After that, the change summary remains visible in the history panel until 90 days, at which point the version is fully deleted. After 90 days, all data for a version, named or unnamed, is permanently removed.

Next steps