# Data retention

This API allows you to manage data retention periods in customer workspaces that have the Configurable Data Retention add-on enabled.

# Quick reference

Type Resource Description
PUT /api/managed_users/:managed_user_id/update_data_retention Update a customer workspace's data retention period.

# Update customer workspace's data retention period

Updates the data retention period for customer workspaces where the Configurable Data Retention add-on is enabled. Refer to the Data retention policies documentation for more information.

PUT /api/managed_users/:managed_user_id/update_data_retention

# URL parameters

Name Type Description
managed_user_id string
required
Embedded customer workspace ID/external ID.
The external ID must be URL encoded and prefixed with an E (for example, EA2300).

# Payload

Name Type Description
data_retention_ttl_hours integer
required
The length of time to retain data for the specified customer workspace, in hours. The minimum data retention period is 1 hour and the maximum is determined by the Embedded customer's plan.

# Sample request

curl  -X PUT 'https://www.workato.com/api/managed_users/12345/update_data_retention' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d  '{
            "data_retention_ttl_hours": 720
          }'

# Response

{
    "data":[]
}


Last updated: 1/31/2024, 5:56:18 PM