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: update documentation for new changelog entries
github-actions[bot]36f23a01b223
diff --git a/.codex b/.codexnew file mode 100644index 000000000..e69de29bbdiff --git a/docs/content/docs/cli.mdx b/docs/content/docs/cli.mdxindex 782ec6433..f61953305 100644--- a/docs/content/docs/cli.mdx+++ b/docs/content/docs/cli.mdx@@ -164,13 +164,17 @@ Use `run` when you want loops, conditionals, `Promise.all`, `search()` inside a## Call raw APIs with proxy-Use `composio proxy` when you want authenticated access to a toolkit API endpoint directly rather than going through a dedicated Composio tool.+Use `composio proxy` when you want authenticated access to a toolkit API endpoint directly rather than going through a dedicated Composio tool. The command uses your linked account for the toolkit you pass with `--toolkit`.```bash-composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile --toolkit gmail-composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts --toolkit gmail -X POST -H 'content-type: application/json' -d '{"message":{"raw":"..."}}'+composio proxy /gmail/v1/users/me/profile --toolkit gmail+composio proxy /gmail/v1/users/me/drafts --toolkit gmail -X POST -H 'content-type: application/json' -d '{"message":{"raw":"..."}}'```+<Callout type="warn">+Prefer relative endpoints. If you pass an absolute URL, it must stay on the same scheme and registrable domain as the toolkit account's base URL.+</Callout>+Use `proxy` when:- there is no dedicated tool for the endpoint you needdiff --git a/docs/content/docs/toolkits/custom-tools-and-toolkits.mdx b/docs/content/docs/toolkits/custom-tools-and-toolkits.mdxindex fbe055f82..7f89d7983 100644--- a/docs/content/docs/toolkits/custom-tools-and-toolkits.mdx+++ b/docs/content/docs/toolkits/custom-tools-and-toolkits.mdx@@ -214,6 +214,8 @@ composio = Composio(api_key="your_api_key")An extension tool wraps a Composio toolkit's API with custom business logic. It inherits auth via `extendsToolkit` / `extends_toolkit`, so `ctx.proxyExecute()` / `ctx.proxy_execute()` handles credentials automatically.+Prefer relative `endpoint` values in proxy calls. They resolve against the toolkit base URL. Absolute URLs are only accepted when they stay on the same scheme and registrable domain as that base URL.+<Tabs groupId="language" items={['TypeScript', 'Python']} persist><Tab value="TypeScript">```typescript@@ -235,7 +237,7 @@ const sendPromoEmail = experimental_createTool("SEND_PROMO_EMAIL", {const res = await ctx.proxyExecute({toolkit: "gmail",- endpoint: "https://gmail.googleapis.com/gmail/v1/users/me/messages/send",+ endpoint: "/gmail/v1/users/me/messages/send",method: "POST",body: { raw },});@@ -278,7 +280,7 @@ def send_promo_email(input: PromoEmailInput, ctx):res = ctx.proxy_execute(toolkit="gmail",- endpoint="https://gmail.googleapis.com/gmail/v1/users/me/messages/send",+ endpoint="/gmail/v1/users/me/messages/send",method="POST",body={"raw": raw},)diff --git a/docs/content/docs/tools-direct/executing-tools.mdx b/docs/content/docs/tools-direct/executing-tools.mdxindex f3f99fcfc..380b0fa06 100644--- a/docs/content/docs/tools-direct/executing-tools.mdx+++ b/docs/content/docs/tools-direct/executing-tools.mdx@@ -254,7 +254,13 @@ The examples above configure toolkit versions at SDK initialization. You can alsYou can proxy requests to any supported toolkit API and let Composio inject the authentication state. This is useful when you need an API endpoint that isn't available as a predefined tool.-The `endpoint` can be a relative path or absolute URL. Composio uses the `connected_account_id` to determine the toolkit and resolve relative paths against the appropriate base URL.+Proxy execute requires auth context. Pass `connected_account_id` / `connectedAccountId`, or provide `custom_connection_data` if you're supplying auth manually.++The `endpoint` can be a relative path or absolute URL. Relative paths are resolved against the connected account's base URL. Absolute URLs are only accepted when they use the same scheme and registrable domain as that base URL. Cross-subdomain requests on the same registrable domain still work.++<Callout type="warn">+Prefer relative endpoints when possible. They resolve against the connected account's base URL and avoid same-domain validation issues.+</Callout><Tabs groupId="language" items={['Python', 'TypeScript']} persist><Tab value="Python">