# Recipe-level data retention

Workato enables you to configure job data storage at the recipe level. This feature is useful for organizations with strict requirements for external data storage or API performance. Workato provides enhanced control over compliance, performance, and operational efficiency with this feature.

You can do the following with the Jobs data retention recipe setting:

  • Comply with your organization's data protection and security standards.
  • Ensure that sensitive data isn't stored outside your firewall.
  • Decrease the latency of an API recipe.

In this guide, we'll cover how:


# Basics

# How does the Jobs data retention setting work?

The Jobs data retention recipe setting defines if Workato stores job data for the recipe.

This setting, located in a recipe's Settings > Data retention tab, has two options:

  • Default retention policy. Your workspace's data retention policy applies when this option is selected. For example, if the retention policy is 30 days, the recipe's data is retained for 30 days from the job's completion date.

  • Do not store. Workato won't store any data for the recipe when this option is selected. You might select this option to:

    • Manage risk associated with storing sensitive or personally-identifying data.
    • Decrease the latency of an API recipe by skipping log creation.

    Before selecting this option, make sure the recipe doesn't require job logs. See the How is data affected? section for more information.

# How is data affected?

When you select Do not store, certain types of data or features in Workato may be modified or entirely unavailable. This changes jobs in the following ways:

  • Job history summary: No change. Job ID, history, and duration remain visible in the recipe's Jobs tab.

  • Job history details: Step inputs and outputs are unavailable, including for recipe triggers:

    Job History Details page with retention disabledd Job History Details page with retention disabled

    This is also true when a job fails:

    Job History Details page with retention disabled job failure Failed job on Job History Details page with retention disabled

    Error information for failed jobs is only available for test jobs.

  • Customized job reports: Customized job report data is unavailable. This applies to jobs completed after you deactivate recipe-level data retention.

    Consider the following example. Non-test jobs completed after retention was deactivated are highlighted. Notice that the custom job report data isn't present for these jobs:

    Customized job reports with retention disabled Customized job reports with retention disabled

# How are test jobs affected?

Deactivating recipe-level data retention doesn't affect test jobs, as test job data is stored to support testing and troubleshooting while building. Instead, your workspace's data retention policy applies to the retained test job data.

For example, consider the job history in the following image. Retention was deactivated for this recipe beginning with the 4:58:23 PM job. Highlighted is a test job that was completed after retention was deactivated:

Test job with retained data Test job with data retained

And the Job history details page for the job:

Job history details page for test job Job history details page for test job

If a test job fails, details about the failure, including error messages, and IDs are visible on the Job history details page:

Job history details page for failed test job Job history details page for failed test job

# How are repeated jobs affected?

You can't repeat a failed job if recipe-level data retention is deactivated, as no data will be available to perform the rerun:

Disabled Repeat this job button in Job Details page Disabled Repeat this job button on the Job Details page

# How can I troubleshoot job failures?

When retention is deactivated, error information is available only for test jobs, not for actual recipe runs. To avoid issues while your recipe is running, we recommend the following:

  • Thoroughly test each recipe step during development.
  • Add error handling steps into your recipe to account for potential issues during recipe execution.

Additionally, note that failed jobs can't be repeated when you deactivate retention.

# Will changing a recipe's retention setting affect existing data?

No. Updating the Jobs data retention setting affects recipe data created after the setting has been updated.

For example, if you select the Do not store option for a recipe's data retention setting, the recipe's existing data will be retained until your workspace's data retention period has passed. New data created after the setting is updated won't be stored.

This is demonstrated in the following screenshot. Retention was deactivated for this recipe beginning with the 4:58:23 PM job. Jobs completed before this retain their data:

Jobs before retention was disabled with data retained Jobs before retention was disabled with data retained


# Configure recipe data retention

Complete the following steps to configure data retention at the recipe level:

1

Select a recipe in your Workato workspace.

2

If the recipe is currently running, click Stop recipe before proceeding.

3

On the recipe's details page, click Settings > Data retention:

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

4

In the Jobs data retention field, select one of the following options:

  • Default retention policy: Data for the recipe is retained according to the workspace's data retention policy if this option is selected. For example, if the workspace's retention policy is 45 days, data for the recipe is retained for 45 days from the job's completion date.

  • Do not store: Recipe data created after saving won't be stored if this option is selected.

5

Click Save.


Last updated: 2/4/2025, 10:38:48 PM