@devries-cameron20 / composio-1 / commits / 3781b26a8
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.

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