Product UpdatesStatus PageAutomation Institute
English
Data & security

# Data Retention Policies

SUMMARY

  • 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:

# Basics

# What is a data retention policy?

Workato's data retention policy specifies how long specific types of data are stored for your account. The data retention period is 30 or 90 days, depending on your account type. Workato retains this data to support error recovery, duplicate detection, custom reports, and job re-runs.

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.

# Retention policy duration

The default data retention policy for your Workato account varies based on the type of workspace you use and any additional features you select.

Purchased? Maximum Retention Customizable?
None 30 days No
Enterprise Workspace 90 days Yes (1 hour minimum)
Data Monitoring add-on 90 days Yes (1 hour minimum)

MAXIMUM RETENTION AND CUSTOMIZATION OPTIONS

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 (CSM) to learn more.

# Can I customize the retention period for my workspace?

Yes, if you have an Enterprise Workspace or have purchased the Data Monitoring/Advanced Security & 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: Audit log streaming only includes data created after you configure the streaming. It does not apply to data created prior to the configuration.

# 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
  • 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

WHO CAN USE THIS FEATURE?

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

1

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

2

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

3

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.

4

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.

← Security FAQs
Recipe-level Retention →


Last updated: 4/9/2024, 6:28:16 PM

On this page