@devries-cameron20 / composio Mirror · read-only / commits / 5331a8969
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: 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