@devries-cameron20 / composio Mirror · read-only
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 21, 03:37 UTC

next
mdx 80 lines 3.74 KB
Raw
1 ---
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-11"
5 ---
6
7 <Callout type="warn">
8 **Update (March 13, 2026):** Existing customers have a transition period until May 1, 2026. See [updated changelog](/docs/changelog/2026/03/13).
9 </Callout>
10
11 We're updating **polling trigger intervals** to improve platform reliability and avoid rate limiting. This change affects how frequently polling triggers execute.
12
13 ## What's Changing?
14
15 ### Default Polling Interval
16
17 The default polling interval for triggers is increasing from **1 minute** to **15 minutes**.
18
19 If you don't specify an `interval` in your trigger configuration, your triggers will now poll every 15 minutes instead of every 1 minute.
20
21 ### Minimum Polling Interval
22
23 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.
24
25 ```python
26 # Before: this would poll every 5 minutes
27 composio.triggers.enable(
28 trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
29 connected_account_id="ca_xxx",
30 config={"interval": 5}
31 )
32
33 # Now: interval is silently clamped to 15 minutes
34 composio.triggers.enable(
35 trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
36 connected_account_id="ca_xxx",
37 config={"interval": 5} # Effective interval: 15 minutes
38 )
39 ```
40
41 ### Current Behavior (Transition Period)
42
43 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.
44
45 ### Enforcement (April 15, 2026)
46
47 Starting **April 15, 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.
48
49 ```python
50 # This will return an error after April 15, 2026
51 composio.triggers.enable(
52 trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
53 connected_account_id="ca_xxx",
54 config={"interval": 5} # Error: interval must be >= 15 minutes
55 )
56 ```
57
58 ### App-Level Interval Overrides
59
60 We will also be introducing **app-specific default polling intervals**. Each app will have its own default interval based on the rate limits that app allows and whether the rate limit is per-user or per-app. These app-level defaults may be lower or higher than 15 minutes depending on the app. When you don't specify an `interval`, the app-level default will be used instead of the global 15-minute default.
61
62 ### Need Intervals Below 15 Minutes?
63
64 If you require polling intervals shorter than 15 minutes, you should **use your own OAuth app** (custom auth). With custom auth, the 15-minute minimum does not apply — you can set polling intervals as low as **1 minute**.
65
66 ## What You Need to Do
67
68 1. **Review your trigger configurations** — check if any triggers use intervals shorter than 15 minutes
69 2. **Update intervals** to 15 minutes or higher before **April 15, 2026**
70 3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers, or use **custom auth** for intervals as low as 1 minute
71
72 ## Rollout Timeline
73
74 - **March 11, 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes
75 - **April 15, 2026**: API enforcement — intervals below 15 minutes will return an error
76 - **April 15, 2026**: Dashboard enforcement — the UI will prevent setting intervals below 15 minutes
77
78 <Callout type="info">
79 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 15 to avoid errors.
80 </Callout>