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: remove duplicate migration guide and simplify version comparison
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Anshu Garg committed
Feb 6, 2026 at 13:59 UTC
2d42f2e112ace29b41bf52f0d1a6a243ce6122a3
1 file changed
+1
-35
docs/content/changelog/02-06-26-webhook-subscriptions-api.mdx
+1
-35
@@ -235,44 +235,10 @@ While not required, we recommend migrating to benefit from:
235
236
---
237
238
-## Migration Guide
239
-
240
-Your existing webhook configuration has been automatically migrated. No action is required for your webhooks to continue working.
241
-
242
-### Using the New API
243
-
244
-Start using the new endpoints instead of the legacy ones:
245
-
246
-```bash
247
-# List your webhook subscriptions
248
-curl "https://backend.composio.dev/api/v3/webhook_subscriptions" \
249
- -H "x-api-key: YOUR_API_KEY"
250
-```
251
-
252
-### (Optional) Enable New Events
253
-
254
-Add `composio.connected_account.expired` to receive connection expiry notifications:
255
-
256
-```bash
257
-curl -X PATCH "https://backend.composio.dev/api/v3/webhook_subscriptions/{id}" \
258
- -H "x-api-key: YOUR_API_KEY" \
259
- -H "Content-Type: application/json" \
260
- -d '{
261
- "enabled_events": [
262
- "composio.trigger.message",
263
- "composio.connected_account.expired"
264
- ]
265
- }'
266
-```
267
-
268
----
269
-
238
## Payload Version Comparison
239
240
| Version | Format | Recommendation |
241
|---------|--------|----------------|
242
| V1 | Legacy flat structure | For backward compatibility only |
243
| V2 | Nested with metadata | For existing integrations |
276
-| **V3** | Modern envelope format | **Recommended for all new integrations** |
277
-
278
-V3 follows industry standards with a consistent envelope containing `id`, `timestamp`, `type`, `metadata`, and `data`.
244
+| **V3** | Structured envelope with `id`, `timestamp`, `type`, `metadata`, `data` | **Recommended for all new integrations** |