# Data Retention Policies

Workato retains specific recipe and usage data to power the Dashboard, display custom reports, repeat jobs, and troubleshoot errors. After a certain amount of time has passed, this data is automatically and permanently deleted from the Workato platform.

The time data is retained is determined by a data retention policy. In this guide, we'll cover:

# Basics

# What is a data retention policy?

In Workato, a data retention policy specifies how long specific types of data can be stored. Workato retains this data to support error recovery, duplicate detection, custom reports, job re-runs, and so on.

Data subject to the retention policy is automatically and permanently deleted when the retention period has passed. If, for example, the retention period is 90 days, applicable data more than 90 days old is deleted.

# What is Workato's data retention policy?

The default data retention policy for your account depends on your workspace type and whether you've purchased specific add-ons:

Purchased? Maximum Retention Customizable?
None 30 days No
Enterprise Workspace 90 days Yes (1 hour minimum)
Advanced Security and Compliance add-on 90 days Yes (1 hour minimum)

Note: The maximum retention period and the ability to customize it depends on your pricing plan and purchased add-ons. Reach out to your Customer Success Manager to learn more.

# Can I customize the retention period for my workspace?

Yes, if you have an Enterprise Workspace or have purchased the Advanced Security and Compliance add-on.

Refer to the Customization at the workspace level section for more info.

# Can I customize retention at the recipe level?

Yes. The Jobs data retention recipe setting allows you to define whether job data is stored for the recipe:

Recipe-level data retention policy Recipe-level data retention policy

Refer to the Defining data retention for recipes guide for more info.

# Can I store data for longer than the retention period?

To store data longer than the retention period, use Audit log streaming. Using this feature, you can send job and activity log data from Workato to your event management application of choice.

Currently, Workato supports the following applications:

  • Amazon S3
  • Data Dog
  • Splunk
  • Sumo Logic
  • Any other application or service accessible over an HTTP endpoint

Note: Only data created after streaming is configured will be available. Audit log streaming doesn't apply to previously created data.

# What types of data are subject to the data retention policy?

The following types of data are subject to your account's data retention policy:

# Job History Summary

Job history summary data provides job metadata on the Job details page. This includes info about the job such as:

  • The job ID
  • Status
  • Description
  • Starting time
  • Duration

Job history summary Job history summary with successful job completion

If the job resulted in an error, the summary would also contain details about the error:

Job history summary Job history summary with error details

# Job History Details

Job history detail data provides information about inputs and outputs for each action in the recipe:

Action input and output Action input and output on the Job history details page

After the data retention period has passed, only job history summary data is retained. Action input and output data will be deleted.

# Trigger Events

Trigger event data is found on the Job details page in the Output tab of the trigger step:

Trigger event data Trigger event data for a new issue in GitHub

Trigger event data can be used to repeat a job without creating a new trigger event. After the retention period has passed and the trigger event data is deleted, the Repeat this job option on this page will be disabled.

# Customized Job Reports

Customized job reports are located in the Jobs tab of the recipe. If a job report isn't customized, only the job's ID, status, and timestamp will display in the table.

A customized report is a quick, easy way to see data from a job without opening the Job details page. In the image below, for example, the job report has been customized to include the GH issue, Team, Status, Priority, and Issue Type columns:

Custom job report Custom job report showing data from the job execution

After the retention period, only the job's ID, status, and timestamp will display in the job report. Data in customized columns will be deleted.

Custom job report deleted Custom job report after the retention period has passed

# Customizing Data Retention


To perform the tasks in this section, you'll need the following:

Retention periods can be configured in two ways:

# Customization At The Workspace Level


In your Workato account, navigate to Settings > Data retention.


In the Data retention period unit field, select Hours or Days.


In the Data retention period field, enter an integer. This value indicates how many instances of the period unit the retention period should be.

For example: If the period unit is Days and 45 is entered as the period, the data retention period will be 45 days:

Workspace-level data retention policy Customized data retention policy of 45 days

Note: The retention period must be between one (1) hour and 90 days. If set to a value outside this range, Workato will reset it to the maximum for your workspace's plan type.


When finished, click Save.

# Customization At The Recipe Level

Data retention can be configured on a recipe-by-recipe basis to use the workspace retention policy or to not store data at all.

Refer to the Defining data retention for recipes guide for more info.