@devries-cameron20 / composio Mirror · read-only / commits / ab94fcae0
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 22, 05:45 UTC

docs: address PR review comments on polling interval changelog

- Change enforcement date to April 1, 2026 - Replace "reduce unnecessary API load" with "avoid rate limiting" - Add specific dates to rollout timeline - Remove "Need Help?" section - Streamline content and remove redundancy Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Jayesh Sharma committed Mar 4, 2026 at 12:04 UTC ab94fcae07edd96a047c7d4a81b636ac87cf4ae8
1 file changed +12 -27
docs/content/changelog/03-03-26-polling-interval-changes.mdx
+12 -27
@@ -1,10 +1,10 @@
1 ---
2 -title: "Polling Trigger Interval Changes - Lookahead Announcement"
2 +title: "Polling Trigger Interval Changes"
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.
7 +We're updating **polling trigger intervals** to improve platform reliability and avoid rate limiting. This change affects how frequently polling triggers execute.
8
9 ## What's Changing?
10
@@ -18,8 +18,6 @@ If you don't specify an `interval` in your trigger configuration, your triggers
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 -
21 ```python
22 # Before: this would poll every 5 minutes
23 composio.triggers.enable(
@@ -28,7 +26,7 @@ composio.triggers.enable(
26 config={"interval": 5}
27 )
28
31 -# After: interval is silently clamped to 15 minutes
29 +# Now: interval is silently clamped to 15 minutes
30 composio.triggers.enable(
31 trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
32 connected_account_id="ca_xxx",
@@ -38,14 +36,14 @@ composio.triggers.enable(
36
37 ### Current Behavior (Transition Period)
38
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.
39 +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.
40
43 -### Upcoming Enforcement (~2 Weeks)
41 +### Enforcement (April 1, 2026)
42
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.
43 +Starting **April 1, 2026**, requesting an interval below the minimum will return an **API error** instead of silently clamping. Update your trigger configurations to use an interval of 15 minutes or higher before this date.
44
45 ```python
48 -# This will return an error after enforcement begins
46 +# This will return an error after April 1, 2026
47 composio.triggers.enable(
48 trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
49 connected_account_id="ca_xxx",
@@ -53,31 +51,18 @@ composio.triggers.enable(
51 )
52 ```
53
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 -
54 ## What You Need to Do
55
56 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
57 +2. **Update intervals** to 15 minutes or higher before **April 1, 2026**
58 3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers where available
59
60 ## Rollout Timeline
61
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
62 +- **March 3, 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes
63 +- **April 1, 2026**: API enforcement — intervals below 15 minutes will return an error
64 +- **April 1, 2026**: Dashboard enforcement — the UI will prevent setting intervals below 15 minutes
65
66 <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.
67 +Existing triggers with intervals below 15 minutes will continue to function during the transition period, but at the clamped 15-minute interval. Update your configurations before April 1 to avoid errors.
68 </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