# Data Retention Policies
- Workato's data retention policy determines the lifespan of data like job histories, trigger events, and custom reports, deleting them after the specified time.
- Default retention varies from 30 to 90 days depending on workspace type and purchased add-ons, and can be customized in certain cases.
- You can set data retention at the workspace level or opt not to store data for specific recipes.
- Store data beyond the default period by using audit log streaming to send data to supported applications.
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:
- The basics of data retention policies in Workato
- The default retention periods in Workato
- What types of data are subject to the retention policy
- How to customize your workspace's retention period
- How to selectively retain data at the recipe level
- What is a data retention policy?
- What is Workato's data retention policy?
- Can I customize the retention period for my workspace?
- Can I customize retention at the recipe level?
- Can I store data for longer than the retention period?
- What types of data are subject to the data retention policy?
# 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:
|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
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
- 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:
DATA IN ADD-ON FEATURES
The following types of data are not subjected to your account's data retention policy:
- Table Storage data, including data entered in Workflow Apps: Workato does not delete this data automatically. If you want to delete this data you must do so manually using the data tables UI or programmatically.
- FileStorage data: Workato does not delete this data automatically. If you want to delete this data you must do so manually using the FileStorage delete action. Data that is deleted by user will be purged from all backup drives within 4 days.
- SQL Transformations data: Temporary contents received from different sources other than FileStorage, and the transformed output data are all automatically purged from primary and backup drives within 4 days.
# 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
- Starting time
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 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 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 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 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 after the retention period has passed
# Customizing Data Retention
WHO CAN USE THIS FEATURE?
To perform the tasks in this section, you'll need the following:
- An Enterprise Workspace or the Advanced Security and Compliance add-on
- The Account owner or Admin system role
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
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
45 is entered as the period, the data retention period will be
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.
Last updated: 8/8/2023, 3:35:50 PM