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: add lookahead changelog for polling interval changes
Announce transition from 1-minute to 15-minute default polling intervals. During the transition period, sub-minimum intervals are silently clamped. Hard enforcement via API errors will follow in ~2 weeks. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Jayesh Sharma committed
Mar 3, 2026 at 15:50 UTC
5331a896924b5817329dcd72c98299944a78f299
1 file changed
+83
docs/content/changelog/03-03-26-polling-interval-changes.mdx
new
+83
@@ -0,0 +1,83 @@
1
+---
2
+title: "Polling Trigger Interval Changes - Lookahead Announcement"
3
+description: "Default polling interval increasing from 1 minute to 15 minutes, with silent clamping during transition"
4
+date: "2026-03-03"
5
+---
6
+
7
+We're updating **polling trigger intervals** to improve platform reliability and reduce unnecessary API load. This change affects how frequently polling triggers execute.
8
+
9
+## What's Changing?
10
+
11
+### Default Polling Interval
12
+
13
+The default polling interval for triggers is increasing from **1 minute** to **15 minutes**.
14
+
15
+If you don't specify an `interval` in your trigger configuration, your triggers will now poll every 15 minutes instead of every 1 minute.
16
+
17
+### Minimum Polling Interval
18
+
19
+A new **minimum polling interval of 15 minutes** is being introduced. Triggers configured with intervals shorter than 15 minutes will be automatically clamped to 15 minutes.
20
+
21
+**Example:**
22
+
23
+```python
24
+# Before: this would poll every 5 minutes
25
+composio.triggers.enable(
26
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
27
+ connected_account_id="ca_xxx",
28
+ config={"interval": 5}
29
+)
30
+
31
+# After: interval is silently clamped to 15 minutes
32
+composio.triggers.enable(
33
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
34
+ connected_account_id="ca_xxx",
35
+ config={"interval": 5} # Effective interval: 15 minutes
36
+)
37
+```
38
+
39
+### Current Behavior (Transition Period)
40
+
41
+During the transition period, intervals below the minimum are **silently clamped** — your triggers will continue to work without errors, but they will run at the minimum interval instead of your requested interval. A warning is logged when clamping occurs.
42
+
43
+### Upcoming Enforcement (~2 Weeks)
44
+
45
+After the transition period, requesting an interval below the minimum will return an **API error** instead of silently clamping. You will need to update your trigger configurations to use an interval of 15 minutes or higher.
46
+
47
+```python
48
+# This will return an error after enforcement begins
49
+composio.triggers.enable(
50
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
51
+ connected_account_id="ca_xxx",
52
+ config={"interval": 5} # Error: interval must be >= 15 minutes
53
+)
54
+```
55
+
56
+## Why This Change?
57
+
58
+1. **Platform Reliability**: Reducing polling frequency decreases load on both Composio infrastructure and third-party APIs
59
+2. **Rate Limit Protection**: Many third-party APIs have rate limits that are easily hit with 1-minute polling across many triggers
60
+3. **Cost Efficiency**: Less frequent polling reduces infrastructure costs, keeping the platform sustainable
61
+
62
+## What You Need to Do
63
+
64
+1. **Review your trigger configurations** — check if any triggers use intervals shorter than 15 minutes
65
+2. **Update intervals** to 15 minutes or higher before enforcement begins
66
+3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers where available
67
+
68
+## Rollout Timeline
69
+
70
+- **March 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes
71
+- **Mid-March 2026**: API enforcement — intervals below 15 minutes will return an error
72
+- **Frontend enforcement**: The dashboard will prevent setting intervals below 15 minutes
73
+
74
+<Callout type="info">
75
+Existing triggers with intervals below 15 minutes will continue to function during the transition period, but at the clamped 15-minute interval. We recommend updating your configurations proactively.
76
+</Callout>
77
+
78
+## Need Help?
79
+
80
+If you have questions about this change or need assistance:
81
+- Join our [Discord community](https://discord.gg/composio)
82
+- Check our [documentation](https://docs.composio.dev)
83
+- Contact support at support@composio.dev