Data Retention

Control how long execution logs, deleted resources, and copilot data are kept before permanent deletion

Data Retention lets workspace admins on Enterprise plans configure how long three categories of data are kept before they are permanently deleted. Each workspace in your organization can have its own independent configuration.

Setup

Go to Settings → Enterprise → Data Retention in your workspace.

Data Retention settings showing three dropdowns — Log retention, Soft deletion cleanup, and Task cleanup — each set to Forever

You will see three independent settings, each with the same set of options: 1 day, 3 days, 7 days, 14 days, 30 days, 60 days, 90 days, 180 days, 1 year, 5 years, or Forever.

Setting a period to Forever means that category of data is never automatically deleted.

Settings

Log retention

Controls how long workflow execution logs are kept.

When the retention period expires, execution log records are permanently deleted, along with any files associated with those executions stored in cloud storage.

Soft deletion cleanup

Controls how long soft-deleted resources remain recoverable before permanent removal.

When you delete a workflow, folder, knowledge base, table, or file, it is initially soft-deleted and can be recovered from Recently Deleted. Once the soft deletion cleanup period expires, those resources are permanently removed and cannot be recovered.

Resources covered:

  • Workflows
  • Workflow folders
  • Knowledge bases
  • Tables
  • Files
  • MCP server configurations
  • Agent memory

Task cleanup

Controls how long Mothership data is kept, including:

  • Copilot chats and run history
  • Run checkpoints and async tool calls
  • Inbox tasks (Sim Mailer)

Each setting is independent. You can configure a short log retention period alongside a long soft deletion cleanup period, or any combination that fits your compliance requirements.

Per-workspace configuration

Retention is configured at the workspace level, not organization-wide. Each workspace in your organization can have a different configuration. Changes to one workspace's settings do not affect other workspaces.

Defaults

By default, all three settings are unconfigured — no data is automatically deleted in any category until you configure it. Setting a period to Forever has the same effect as leaving it unconfigured, but makes the intent explicit and allows you to change it later without saving from scratch.

Common Questions

Only workspace admins can configure data retention settings. On Sim Cloud, the workspace must be on an Enterprise plan.
No. Deletion runs on a scheduled cleanup job. Data is deleted when the job next runs after the retention period has elapsed — not at the exact moment it expires.
No. Once the soft deletion cleanup period expires and the cleanup job runs, resources are permanently deleted and cannot be recovered.
No. Retention is configured per workspace. Each workspace in your organization can have a different configuration.
The next cleanup job will delete any data that is older than the new, shorter period — including data that would have been kept under the previous setting. Shortening the period is irreversible for data that falls outside the new window.
1 day (24 hours).
5 years.

Self-hosted setup

Environment variables

NEXT_PUBLIC_DATA_RETENTION_ENABLED=true

Once enabled, data retention settings are configurable through Settings → Enterprise → Data Retention the same way as Sim Cloud.

PreviousAudit Logs
NextKeyboard Shortcuts

On this page

Setup
Settings
Log retention
Soft deletion cleanup
Task cleanup
Per-workspace configuration
Defaults
Self-hosted setup
Environment variables