Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: add lookahead changelog for polling interval changes
Jayesh Sharma5331a896924b
diff --git a/docs/content/changelog/03-03-26-polling-interval-changes.mdx b/docs/content/changelog/03-03-26-polling-interval-changes.mdxnew file mode 100644index 000000000..9b9903a38--- /dev/null+++ b/docs/content/changelog/03-03-26-polling-interval-changes.mdx@@ -0,0 +1,83 @@+---+title: "Polling Trigger Interval Changes - Lookahead Announcement"+description: "Default polling interval increasing from 1 minute to 15 minutes, with silent clamping during transition"+date: "2026-03-03"+---++We're updating **polling trigger intervals** to improve platform reliability and reduce unnecessary API load. This change affects how frequently polling triggers execute.++## What's Changing?++### Default Polling Interval++The default polling interval for triggers is increasing from **1 minute** to **15 minutes**.++If you don't specify an `interval` in your trigger configuration, your triggers will now poll every 15 minutes instead of every 1 minute.++### Minimum Polling Interval++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.++**Example:**++```python+# Before: this would poll every 5 minutes+composio.triggers.enable(+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",+ connected_account_id="ca_xxx",+ config={"interval": 5}+)++# After: interval is silently clamped to 15 minutes+composio.triggers.enable(+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",+ connected_account_id="ca_xxx",+ config={"interval": 5} # Effective interval: 15 minutes+)+```++### Current Behavior (Transition Period)++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.++### Upcoming Enforcement (~2 Weeks)++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.++```python+# This will return an error after enforcement begins+composio.triggers.enable(+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",+ connected_account_id="ca_xxx",+ config={"interval": 5} # Error: interval must be >= 15 minutes+)+```++## Why This Change?++1. **Platform Reliability**: Reducing polling frequency decreases load on both Composio infrastructure and third-party APIs+2. **Rate Limit Protection**: Many third-party APIs have rate limits that are easily hit with 1-minute polling across many triggers+3. **Cost Efficiency**: Less frequent polling reduces infrastructure costs, keeping the platform sustainable++## What You Need to Do++1. **Review your trigger configurations** — check if any triggers use intervals shorter than 15 minutes+2. **Update intervals** to 15 minutes or higher before enforcement begins+3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers where available++## Rollout Timeline++- **March 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes+- **Mid-March 2026**: API enforcement — intervals below 15 minutes will return an error+- **Frontend enforcement**: The dashboard will prevent setting intervals below 15 minutes++<Callout type="info">+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.+</Callout>++## Need Help?++If you have questions about this change or need assistance:+- Join our [Discord community](https://discord.gg/composio)+- Check our [documentation](https://docs.composio.dev)+- Contact support at [email protected]