Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs(changelog): add file TTL configuration changelog
Add changelog entry for presigned URL file handling with configurable TTL in tool execution. Files now expire after a default 1 hour TTL, which can be customized via project settings or API. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Composio committed
Jan 20, 2026 at 15:10 UTC
3781b26a8763d5c7e20365487d23806c89d28622
1 file changed
+56
fern/pages/src/changelog/01-20-26-file-ttl.md
new
+56
@@ -0,0 +1,56 @@
1
+# File handling in tool execution now uses presigned URLs
2
+
3
+## Summary
4
+
5
+Files involved in tool execution are now shared via presigned URLs with a default TTL (time-to-live) of 1 hour. You can customize the file TTL through your project configuration.
6
+
7
+## What changed
8
+
9
+When tools return files (images, documents, exports, etc.), these files are now delivered as presigned URLs with a configurable TTL instead of non-expiring URLs. This provides:
10
+
11
+- **Automatic cleanup** - Files expire after the configured TTL
12
+- **Configurable retention** - Adjust file availability based on your application's needs
13
+
14
+## Default behavior
15
+
16
+All files returned from tool execution now have a **1 hour TTL** by default. After this period, the presigned URLs expire and files are no longer accessible.
17
+
18
+## Configuring file TTL
19
+
20
+You can adjust the file TTL to match your application's needs.
21
+
22
+### Via Dashboard
23
+
24
+1. Navigate to **Project Settings** in your Composio dashboard
25
+2. Find the **File TTL** configuration option
26
+3. Set your desired TTL value
27
+
28
+### Via API
29
+
30
+Use the [Update Project Config API](https://docs.composio.dev/rest-api/projects/patch-org-project-config) to programmatically configure the file TTL:
31
+
32
+```bash
33
+curl -X PATCH "https://backend.composio.dev/api/v3/org/projects/config" \
34
+ -H "x-api-key: YOUR_API_KEY" \
35
+ -H "Content-Type: application/json" \
36
+ -d '{
37
+ "fileTtl": 3600
38
+ }'
39
+```
40
+
41
+## Impact
42
+
43
+| Aspect | Before | After |
44
+|--------|--------|-------|
45
+| File delivery | Non-expiring URLs | Presigned URLs with TTL |
46
+| Default expiry | None | 1 hour |
47
+| TTL customization | Not available | Configurable via project settings |
48
+
49
+## Migration
50
+
51
+No code changes are required. Your existing integrations will continue to receive file URLs as before, but these URLs will now expire after the configured TTL.
52
+
53
+If your application stores or caches file URLs for later use, ensure you handle URL expiration appropriately by either:
54
+- Downloading files before the TTL expires
55
+- Re-executing the tool to obtain fresh URLs when needed
56
+- Increasing the TTL via project settings to match your retention requirements