@devries-cameron20 / composio Mirror · read-only / commits / 63e575550
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 19:45 UTC

docs(security): clarify Log storage toggle semantics + file TTL

Per the data-storage/privacy review: - Document that the Log storage setting is forward-looking (pause/resume): switching to "Don't store data" stops storing new payloads but does NOT delete logs already stored, and switching back does not backfill the gap. - Add file availability: tool-execution files are presigned URLs with a default 1-hour TTL, configurable 1-24h per project in Settings. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Palash Kala committed Jun 25, 2026 at 19:14 UTC 63e5755507b8fba448ea8f8cc1834bbea133137a
1 file changed +14 -1
docs/content/docs/security/data-retention.mdx
+14 -1
@@ -1,7 +1,7 @@
1 ---
2 title: Data retention
3 description: What Composio stores from your tool calls, how long it is kept, how to stop storing payloads, and where your data flows.
4 -keywords: [data retention, log storage, privacy, dont store data, sub-processors, data flow]
4 +keywords: [data retention, log storage, privacy, dont store data, sub-processors, data flow, file ttl]
5 ---
6
7 Composio stores an audit log of tool executions so you can observe and debug your agents. You control how much of each call is stored, and you can choose not to store the payloads at all.
@@ -23,6 +23,10 @@ Trigger events are logged similarly.
23
24 Tool execution logs and trigger event logs are retained for up to **one year**, after which they are automatically deleted.
25
26 +## How long files are available
27 +
28 +When a tool returns a file (an image, document, export, and so on), Composio shares it as a presigned URL with a time-to-live (TTL) rather than storing the file indefinitely. The default TTL is **1 hour**, and once it expires the URL stops resolving. You can change the file TTL per project — from **1 hour up to 24 hours** — in **Settings → General → File TTL**. This is separate from the Log storage setting and from the one-year log retention above.
29 +
30 ## Choose what we store: the Log storage setting
31
32 You control how much of each call is stored, per project, in **Settings → General → Log storage**:
@@ -38,6 +42,15 @@ With **Don't store data**, Composio keeps an audit trail but does not retain you
42 To enable: open the Dashboard, choose your project, go to **Settings → General → Log storage**, and select **Don't store data**.
43 </Callout>
44
45 +### Changing the setting takes effect going forward
46 +
47 +Log storage behaves like a pause/resume switch — it only affects calls made **after** you change it:
48 +
49 +- Selecting **Don't store data** stops Composio from storing payloads for new calls. It does **not** delete payloads that were already stored: existing logs stay available until they age out under the one-year retention window.
50 +- Selecting **Store all logs** again resumes storing payloads for new calls. It does **not** backfill the period while storage was off.
51 +
52 +Toggling off and back on therefore leaves a gap — payloads for the calls made while it was off were never stored, and turning storage back on does not recover them.
53 +
54 ## Where your data goes
55
56 Choosing **Don't store data** stops Composio from persisting your payloads, but running a tool still moves data through a few places while the call executes: