Data retention

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

Rate limits

The data retention resource has the following rate limit:

Type	Resource	Limit
All	All Data retention endpoints	60 requests per minute

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 capability 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 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":[]
}