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(changelog): add Before/After migration block for proxy same-domain

Zen Agent8bd3044fb1a3
diff --git a/docs/content/changelog/04-24-26-proxy-execute-same-domain.mdx b/docs/content/changelog/04-24-26-proxy-execute-same-domain.mdx
index 1077d51e7..06d22a927 100644
--- a/docs/content/changelog/04-24-26-proxy-execute-same-domain.mdx
+++ b/docs/content/changelog/04-24-26-proxy-execute-same-domain.mdx
@@ -14,6 +14,42 @@ Cross-subdomain requests on the same registrable domain continue to work — for
Existing proxy calls that pass an absolute `endpoint` URL whose registrable domain does not match the connection's `base_url` will now fail with `400 OriginMismatch` instead of being forwarded. Calls that omit both `connected_account_id` and `custom_connection_data` will fail with `400 MissingAuthContext` instead of being forwarded without auth.
</Callout>
+### Migration
+
+If you currently pass an absolute URL that points at a different domain than your connection's `base_url`, switch to a relative endpoint (resolved against `base_url`) or an absolute URL under the same registrable domain.
+
+**Before** — absolute URL on a different domain (will be rejected):
+
+```json
+{
+ "endpoint": "https://api.someservice.com/v1/items",
+ "method": "GET",
+ "connected_account_id": "ca_..."
+}
+```
+
+**After** — relative endpoint (recommended):
+
+```json
+{
+ "endpoint": "/v1/items",
+ "method": "GET",
+ "connected_account_id": "ca_..."
+}
+```
+
+**Or** — absolute URL on the same registrable domain as the connection's `base_url`:
+
+```json
+{
+ "endpoint": "https://uploads.someservice.com/v1/items",
+ "method": "GET",
+ "connected_account_id": "ca_..."
+}
+```
+
+If your integration legitimately needs to call a different registrable domain for the same connection, reach out so we can add the additional host to the toolkit allowlist.
+
### What changed
- Absolute `endpoint` URLs on a different registrable domain than the connection's `base_url` are rejected with HTTP `400 OriginMismatch`. The upstream request is never made.