Skip to content

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

Anshu Garg2d42f2e112ac
diff --git a/docs/content/changelog/02-06-26-webhook-subscriptions-api.mdx b/docs/content/changelog/02-06-26-webhook-subscriptions-api.mdx
index fa52efb11..3a0d0c25b 100644
--- a/docs/content/changelog/02-06-26-webhook-subscriptions-api.mdx
+++ b/docs/content/changelog/02-06-26-webhook-subscriptions-api.mdx
@@ -235,44 +235,10 @@ While not required, we recommend migrating to benefit from:
---
-## Migration Guide
-
-Your existing webhook configuration has been automatically migrated. No action is required for your webhooks to continue working.
-
-### Using the New API
-
-Start using the new endpoints instead of the legacy ones:
-
-```bash
-# List your webhook subscriptions
-curl "https://backend.composio.dev/api/v3/webhook_subscriptions" \
- -H "x-api-key: YOUR_API_KEY"
-```
-
-### (Optional) Enable New Events
-
-Add `composio.connected_account.expired` to receive connection expiry notifications:
-
-```bash
-curl -X PATCH "https://backend.composio.dev/api/v3/webhook_subscriptions/{id}" \
- -H "x-api-key: YOUR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{
- "enabled_events": [
- "composio.trigger.message",
- "composio.connected_account.expired"
- ]
- }'
-```
-
----
-
## Payload Version Comparison
| Version | Format | Recommendation |
|---------|--------|----------------|
| V1 | Legacy flat structure | For backward compatibility only |
| V2 | Nested with metadata | For existing integrations |
-| **V3** | Modern envelope format | **Recommended for all new integrations** |
-
-V3 follows industry standards with a consistent envelope containing `id`, `timestamp`, `type`, `metadata`, and `data`.
+| **V3** | Structured envelope with `id`, `timestamp`, `type`, `metadata`, `data` | **Recommended for all new integrations** |