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 legacy custom tools references and retarget redirects (#3510)

Alberto Schiabel80448048a80f
diff --git a/.agents/skills/building-agents/SKILL.md b/.agents/skills/building-agents/SKILL.md
index 46836c464..e6db8f89e 100644
--- a/.agents/skills/building-agents/SKILL.md
+++ b/.agents/skills/building-agents/SKILL.md
@@ -384,14 +384,20 @@ const account = await composio.connectedAccounts.initiate({
### 3. Custom Tools
```typescript
-// Create custom tools
-const customTool = await composio.tools.createCustomTool({
+import { experimental_createTool } from '@composio/core';
+import { z } from 'zod';
+
+// Custom tools are session-scoped: define a local tool, then attach it
+// when creating a Tool Router session.
+const myTool = experimental_createTool('MY_TOOL', {
name: 'My Tool',
description: 'Tool description',
- execute: async (input) => {
- // Implementation
- return { data: 'result' };
- },
+ inputParams: z.object({ param: z.string() }),
+ execute: async input => ({ result: input.param }),
+});
+
+const session = await composio.create('user-id', {
+ experimental: { customTools: [myTool] },
});
```
diff --git a/.claude/skills/building-agents/SKILL.md b/.claude/skills/building-agents/SKILL.md
index f5bb7c8dc..142e0830b 100644
--- a/.claude/skills/building-agents/SKILL.md
+++ b/.claude/skills/building-agents/SKILL.md
@@ -384,14 +384,20 @@ const account = await composio.connectedAccounts.initiate({
### 3. Custom Tools
```typescript
-// Create custom tools
-const customTool = await composio.tools.createCustomTool({
+import { experimental_createTool } from '@composio/core';
+import { z } from 'zod';
+
+// Custom tools are session-scoped: define a local tool, then attach it
+// when creating a Tool Router session.
+const myTool = experimental_createTool('MY_TOOL', {
name: 'My Tool',
description: 'Tool description',
- execute: async (input) => {
- // Implementation
- return { data: 'result' };
- },
+ inputParams: z.object({ param: z.string() }),
+ execute: async input => ({ result: input.param }),
+});
+
+const session = await composio.create('user-id', {
+ experimental: { customTools: [myTool] },
});
```
diff --git a/AGENTS.md b/AGENTS.md
index 4b95658a5..c0ea63750 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -149,23 +149,28 @@ const wrappedTools = provider.wrapTools(tools);
### Custom Tool Creation
```typescript
+import { Composio, experimental_createTool } from '@composio/core';
import { z } from 'zod';
-const customTool = await composio.tools.createCustomTool({
+const composio = new Composio();
+
+// Custom tools are session-scoped: define a local tool, then attach it when
+// creating a Tool Router session. Use `extendsToolkit` + `ctx.proxyExecute`
+// to inherit a toolkit's managed auth and call its API.
+const myTool = experimental_createTool('MY_TOOL', {
name: 'My Tool',
description: 'Tool description',
- slug: 'MY_TOOL',
inputParams: z.object({
param: z.string().describe('Parameter description')
}),
- execute: async (input) => {
- return {
- data: { result: input.param },
- error: null,
- successful: true
- };
+ execute: async input => {
+ return { result: input.param };
}
});
+
+const session = await composio.create('user-id', {
+ experimental: { customTools: [myTool] }
+});
```
## Python SDK Development
diff --git a/docs/content/docs/glossary.mdx b/docs/content/docs/glossary.mdx
index f863ccaa5..11bf3864d 100644
--- a/docs/content/docs/glossary.mdx
+++ b/docs/content/docs/glossary.mdx
@@ -40,7 +40,7 @@ The object returned when you initiate authentication. Contains the Connect Link
</GlossaryTerm>
<GlossaryTerm name="Custom Tool">
-A user-defined tool used alongside Composio's built-in tools. For sessions, use local experimental custom tools and custom toolkits via [Custom tools and toolkits](/docs/toolkits/custom-tools-and-toolkits). For direct execution, see [Creating custom tools](/docs/tools-direct/custom-tools).
+A user-defined tool used alongside Composio's built-in tools. Use local experimental custom tools and custom toolkits via [Custom tools and toolkits](/docs/toolkits/custom-tools-and-toolkits).
</GlossaryTerm>
<GlossaryTerm name="In-Chat Authentication">
diff --git a/docs/content/docs/migration-guide/new-sdk.mdx b/docs/content/docs/migration-guide/new-sdk.mdx
index 84ca39a58..6e518bc18 100644
--- a/docs/content/docs/migration-guide/new-sdk.mdx
+++ b/docs/content/docs/migration-guide/new-sdk.mdx
@@ -561,155 +561,67 @@ const result_2 = await composio.tools.execute(
### Custom Tools
-The SDK continues to support custom tools. [Creating tools from your methods](/docs/tools-direct/custom-tools#creating-a-custom-tool) remains possible. We recommend reviewing the [detailed custom tools documentation](/docs/tools-direct/custom-tools#creating-a-custom-tool) for more information.
+Custom tools are now session-scoped. Define local tools with the experimental custom-tools API and attach them when creating or reusing a session.
-Due to changes in the SDK architecture, creating custom tools that use Composio's managed authentication has been modified. In the previous SDK, you could create a custom tool as follows:
-
-<Tabs groupId="language" items={['Python (previous)', 'TypeScript (previous)']} persist>
- <Tab value="Python (previous)">
-```python
-# Python Example using execute_request
-from composio import action, ComposioToolSet
-import typing as t
-
-toolset = ComposioToolSet()
-
-@action(toolname="github") # Associate with GitHub app for auth
-def get_github_repo_topics(
- owner: t.Annotated[str, "Repository owner username"],
- repo: t.Annotated[str, "Repository name"],
- execute_request: t.Callable # Injected by Composio
-) -> dict:
- """Gets the topics associated with a specific GitHub repository."""
- response_data = execute_request(
- endpoint=f"/repos/{owner}/{repo}/topics", # API path relative to base URL
- method="GET"
- )
- if isinstance(response_data, dict):
- return {"topics": response_data.get("names", [])}
-```
- </Tab>
- <Tab value="TypeScript (previous)">
-```typescript
-// @noErrors
-import { OpenAIToolSet, type ActionExecutionResDto } from "composio-core";
-import { z } from "zod";
-
-const toolset = new OpenAIToolSet();
-
-await toolset.createAction({
- actionName: "get_github_repo_topics",
- toolName: "github",
- description: "Gets the topics associated with a specific GitHub repository.",
- inputParams: z.object({
- owner: z.string().describe("Repository owner username"),
- repo: z.string().describe("Repository name"),
- }),
- callback: async (inputParams, _authCredentials, executeRequest): Promise<ActionExecutionResDto> => {
- const { owner, repo } = inputParams as { owner: string, repo: string };
- const response = await executeRequest({
- endpoint: `/repos/${owner}/${repo}/topics`,
- method: "GET",
- parameters: [],
- });
-
- const topics = (response as any)?.names ?? [];
- return { successful: true, data: { topics: topics } };
- }
-});
-```
- </Tab>
-</Tabs>
-
-The *execute tool request* method handles injection of the appropriate base URL and authentication credentials for the tool:
-
-<Tabs groupId="language" items={['Python (current)', 'TypeScript (current)']} persist>
- <Tab value="Python (current)">
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
```python
-from pydantic import BaseModel, Field
from composio import Composio
-from composio.core.models.custom_tools import ExecuteRequestFn
-
+from pydantic import BaseModel, Field
composio = Composio()
class GetIssueInfoInput(BaseModel):
- issue_number: int = Field(
- ...,
- description="The number of the issue to get information about",
- )
+ issue_number: int = Field(..., description="The issue number")
-# function name will be used as slug
[email protected]_tool(toolkit="github")
-def get_issue_info(
- request: GetIssueInfoInput,
- execute_request: ExecuteRequestFn,
- auth_credentials: dict,
-) -> dict:
[email protected](extends_toolkit="github")
+def get_issue_info(input: GetIssueInfoInput, ctx) -> dict:
"""Get information about a GitHub issue."""
- response = execute_request(
- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",
+ result = ctx.proxy_execute(
+ toolkit="github",
+ endpoint=f"/repos/composiohq/composio/issues/{input.issue_number}",
method="GET",
- parameters=[
- {
- "name": "Accept",
- "value": "application/vnd.github.v3+json",
- "type": "header",
- },
- {
- "name": "Authorization",
- "value": f"Bearer {auth_credentials['access_token']}",
- "type": "header",
- },
- ],
)
- return {"data": response.data}
+ return {"data": result.data}
+
+session = composio.create(
+ user_id="default",
+ experimental={"custom_tools": [get_issue_info]},
+)
```
</Tab>
- <Tab value="TypeScript (current)">
+ <Tab value="TypeScript">
```typescript
-// @noErrors
-import { Composio } from "@composio/core";
-import z from "zod";
+import { Composio, experimental_createTool } from "@composio/core";
+import { z } from "zod";
const composio = new Composio();
-const tool = await composio.tools.createCustomTool({
- slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',
- name: 'Github star composio repositories',
- toolkitSlug: 'github',
- description: 'Star any specificied repo of `composiohq` user',
- inputParams: z.object({
- repository: z.string().describe('The repository to star'),
- page: z.number().optional().describe('Pagination page number'),
- customHeader: z.string().optional().describe('Custom header'),
- }),
- execute: async (input, connectionConfig, executeToolRequest) => {
- const result = await executeToolRequest({
- endpoint: `/user/starred/composiohq/${input.repository}`,
- method: 'PUT',
- body: {},
- parameters: [
- {
- name: 'page',
- value: input.page?.toString() || '1',
- in: 'query',
- },
- {
- name: 'x-custom-header',
- value: input.customHeader || 'default-value',
- in: 'header',
- },
- ],
- });
- return result;
- },
- });
+const getIssueInfo = experimental_createTool("GET_ISSUE_INFO", {
+ name: "Get issue info",
+ description: "Get information about a GitHub issue.",
+ extendsToolkit: "github",
+ inputParams: z.object({
+ issueNumber: z.number().describe("The issue number"),
+ }),
+ execute: async (input, ctx) => {
+ const result = await ctx.proxyExecute({
+ toolkit: "github",
+ endpoint: `/repos/composiohq/composio/issues/${input.issueNumber}`,
+ method: "GET",
+ });
+ return { data: result.data };
+ },
+});
+
+const session = await composio.create("default", {
+ experimental: { customTools: [getIssueInfo] },
+});
```
</Tab>
</Tabs>
-For more information, including executing custom tools and defining custom headers and query parameters, refer to the [Custom Tools](/docs/tools-direct/custom-tools) documentation.
+For more information, see [Custom Tools and Toolkits](/docs/toolkits/custom-tools-and-toolkits).
### Auth configs (formerly integrations)
diff --git a/docs/content/docs/proxy-execute.mdx b/docs/content/docs/proxy-execute.mdx
index 2afa07df5..f91be48f3 100644
--- a/docs/content/docs/proxy-execute.mdx
+++ b/docs/content/docs/proxy-execute.mdx
@@ -321,7 +321,7 @@ curl --location 'https://backend.composio.dev/api/v3.1/tools/execute/proxy' \
```
<Callout type="warn">
-`binary_body` posts the file as the request body with a single `Content-Type` header. It does **not** build a `multipart/form-data` payload, so APIs that require multipart uploads (for example, Twitter / X media upload, Slack `files.upload`, some Google upload endpoints) are not supported today. For those, wrap the call in a [custom tool](/docs/tools-direct/custom-tools) that constructs the multipart body yourself.
+`binary_body` posts the file as the request body with a single `Content-Type` header. It does **not** build a `multipart/form-data` payload, so APIs that require multipart uploads (for example, Twitter / X media upload, Slack `files.upload`, some Google upload endpoints) are not supported today. For those, wrap the call in a [session custom tool](/docs/toolkits/custom-tools-and-toolkits) that constructs the multipart body yourself.
</Callout>
See the [binary data changelog entry](/docs/changelog/2025/12/30) for the full upload and download flow.
diff --git a/docs/content/docs/tools-direct/custom-tools.mdx b/docs/content/docs/tools-direct/custom-tools.mdx
deleted file mode 100644
index fe5c27ab6..000000000
--- a/docs/content/docs/tools-direct/custom-tools.mdx
+++ /dev/null
@@ -1,380 +0,0 @@
----
-title: Creating Custom Tools
-description: Learn how to extend Composio's toolkits with your own tools
-keywords: [create tool, custom action, extend, standalone tool]
-llmGuardrails: "direct-execution"
----
-
-<Callout type="info">
-If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. See [Custom Tools and Toolkits (Experimental)](/docs/toolkits/custom-tools-and-toolkits) for defining local tools that run in-process alongside remote Composio tools within a session.
-</Callout>
-
-Custom tools allow you to create your own tools that can be used with Composio.
-
-1. **Standalone tools** - Simple tools that don't require any authentication
-2. **Toolkit-based tools** - Tools that require authentication and can use toolkit credentials
-
-## Creating a Custom Tool
-
-### Standalone Tool
-
-A standalone tool is the simplest form of custom tool. It only requires input parameters and an execute function:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-from pydantic import BaseModel, Field
-
-from composio import Composio
-from composio.types import ExecuteRequestFn
-
-composio = Composio()
-
-
-class AddTwoNumbersInput(BaseModel):
- a: int = Field(
- ...,
- description="The first number to add",
- )
- b: int = Field(
- ...,
- description="The second number to add",
- )
-
-# function name will be used as slug
-def add_two_numbers(request: AddTwoNumbersInput) -> int:
- """Add two numbers."""
- return request.a + request.b
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-import { z } from 'zod/v3';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const tool = await composio.tools.createCustomTool({
- slug: 'CALCULATE_SQUARE',
- name: 'Calculate Square',
- description: 'Calculates the square of a number',
- inputParams: z.object({
- number: z.number().describe('The number to calculate the square of'),
- }),
- execute: async input => {
- const { number } = input;
- return {
- data: { result: number * number },
- error: null,
- successful: true,
- };
- },
-});
-```
- </Tab>
-</Tabs>
-
-### Toolkit-based Tool
-
-A toolkit-based tool has access to two ways of making authenticated requests:
-
-**1. Using `executeToolRequest`** - The recommended way to make authenticated requests to the toolkit's API endpoints. Composio automatically handles credential injection and baseURL resolution:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-class GetIssueInfoInput(BaseModel):
- issue_number: int = Field(
- ...,
- description="The number of the issue to get information about",
- )
-
-# function name will be used as slug
[email protected]_tool(toolkit="github")
-def get_issue_info(
- request: GetIssueInfoInput,
- execute_request: ExecuteRequestFn,
- auth_credentials: dict,
-) -> dict:
- """Get information about a GitHub issue."""
- response = execute_request(
- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",
- method="GET",
- parameters=[
- {
- "name": "Accept",
- "value": "application/vnd.github.v3+json",
- "type": "header",
- },
- {
- "name": "Authorization",
- "value": f"Bearer {auth_credentials['access_token']}",
- "type": "header",
- },
- ],
- )
- return {"data": response.data}
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-import { z } from 'zod/v3';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const tool = await composio.tools.createCustomTool({
- slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',
- name: 'Github star composio repositories',
- toolkitSlug: 'github',
- description: 'Star any specified repo of `composiohq` user',
- inputParams: z.object({
- repository: z.string().describe('The repository to star'),
- page: z.number().optional().describe('Pagination page number'),
- customHeader: z.string().optional().describe('Custom header'),
- }),
- execute: async (input, connectionConfig, executeToolRequest) => {
- // This method makes authenticated requests to the relevant API
- // You can use relative paths!
- // Composio will automatically inject the baseURL
- const result = await executeToolRequest({
- endpoint: `/user/starred/composiohq/${input.repository}`,
- method: 'PUT',
- body: {},
- // Add custom headers or query parameters
- parameters: [
- // Add query parameters
- {
- name: 'page',
- value: input.page?.toString() || '1',
- in: 'query',
- },
- // Add custom headers
- {
- name: 'x-custom-header',
- value: input.customHeader || 'default-value',
- in: 'header',
- },
- ],
- });
- return result;
- },
-});
-```
- </Tab>
-</Tabs>
-
-**2. Using `connectionConfig`** - For making direct API calls when needed:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-import requests
-
[email protected]_tool(toolkit="github")
-def get_issue_info_direct(
- request: GetIssueInfoInput,
- execute_request: ExecuteRequestFn,
- auth_credentials: dict,
-) -> dict:
- """Get information about a GitHub issue."""
- response = requests.get(
- f"https://api.github.com/repos/composiohq/composio/issues/{request.issue_number}",
- headers={
- "Accept": "application/vnd.github.v3+json",
- "Authorization": f"Bearer {auth_credentials['access_token']}",
- },
- )
- return {"data": response.json()}
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-import { z } from 'zod/v3';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const tool = await composio.tools.createCustomTool({
- slug: 'GITHUB_DIRECT_API',
- name: 'Direct GitHub API Call',
- description: 'Makes direct calls to GitHub API',
- toolkitSlug: 'github',
- inputParams: z.object({
- repo: z.string().describe('Repository name'),
- }),
- execute: async (input, connectionConfig, executeToolRequest) => {
- // Use connectionConfig for direct API calls
- if (!connectionConfig || connectionConfig.authScheme !== 'OAUTH2') {
- throw new Error('OAuth2 connection required');
- }
- const result = await fetch(`https://api.github.com/repos/${input.repo}`, {
- headers: {
- Authorization: `Bearer ${connectionConfig.val.access_token}`,
- },
- });
-
- return {
- data: await result.json(),
- error: null,
- successful: true,
- };
- },
-});
-```
- </Tab>
-</Tabs>
-
-### Using Custom Headers and Query Parameters
-
-You can add custom headers and query parameters to your toolkit-based tools using the `parameters` option in `executeToolRequest`:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
[email protected]_tool(toolkit="github")
-def get_issue_info(
- request: GetIssueInfoInput,
- execute_request: ExecuteRequestFn,
- auth_credentials: dict,
-) -> dict:
- """Get information about a GitHub issue."""
- response = execute_request(
- endpoint=f"/repos/composiohq/composio/issues/{request.issue_number}",
- method="GET",
- parameters=[
- {
- "name": "Accept",
- "value": "application/vnd.github.v3+json",
- "type": "header",
- },
- {
- "name": "Authorization",
- "value": f"Bearer {auth_credentials['access_token']}",
- "type": "header",
- },
- {
- "name": 'X-Custom-Header',
- "value": 'custom-value',
- "type": 'header',
- },
- ],
- )
- return {"data": response.data}
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-import { z } from 'zod/v3';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const tool = await composio.tools.createCustomTool({
- slug: 'GITHUB_SEARCH_REPOSITORIES',
- name: 'Search GitHub Repositories',
- description: 'Search for repositories with custom parameters',
- toolkitSlug: 'github',
- inputParams: z.object({
- query: z.string().describe('Search query'),
- perPage: z.number().optional().describe('Results per page'),
- acceptType: z.string().optional().describe('Custom accept header'),
- }),
- execute: async (input, connectionConfig, executeToolRequest) => {
- const result = await executeToolRequest({
- endpoint: '/search/repositories',
- method: 'GET',
- parameters: [
- // Add query parameters for pagination
- {
- name: 'q',
- value: input.query,
- in: 'query',
- },
- {
- name: 'per_page',
- value: (input.perPage || 30).toString(),
- in: 'query',
- },
- // Add custom headers
- {
- name: 'Accept',
- value: input.acceptType || 'application/vnd.github.v3+json',
- in: 'header',
- },
- {
- name: 'X-Custom-Header',
- value: 'custom-value',
- in: 'header',
- },
- ],
- });
- return result;
- },
-});
-```
- </Tab>
-</Tabs>
-
-## Executing Custom Tools
-
-You can execute custom tools just like any other tool:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-response = composio.tools.execute(
- user_id="default",
- slug="TOOL_SLUG", # For the tool above you can use `get_issue_info.slug`
- arguments={"issue_number": 1},
-)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const result = await composio.tools.execute('TOOL_SLUG', {
- arguments: {
- // Tool input parameters
- },
- userId: 'user-id',
- connectedAccountId: 'optional-account-id', // Required for toolkit-based tools
-});
-```
- </Tab>
-</Tabs>
-
-## Best Practices
-
-1. Use descriptive names and slugs for your tools
-2. Always provide descriptions for input parameters using `describe()`
-3. Handle errors gracefully in your execute function
-4. For toolkit-based tools:
- - Prefer `executeToolRequest` over direct API calls when possible
- - Use relative paths with `executeToolRequest` - Composio will automatically inject the correct baseURL
- - Use the `parameters` option to add custom headers or query parameters:
- ```typescript
- parameters: [
- { name: 'page', value: '1', in: 'query' }, // Adds ?page=1 to URL
- { name: 'x-custom', value: 'value', in: 'header' }, // Adds header
- ];
- ```
- - Remember that `executeToolRequest` can only call tools from the same toolkit
- - Use `executeToolRequest` to leverage Composio's automatic credential handling
- - Only use `connectionConfig` when you need to make direct API calls or interact with different services
-5. Chain multiple toolkit operations using `executeToolRequest` for better maintainability
-
-## Limitations
-
-1. Custom tools are stored in memory and are not persisted
-2. They need to be recreated when the application restarts
-3. Toolkit-based tools require a valid connected account with the specified toolkit
-4. `executeToolRequest` can only execute tools from the same toolkit that the custom tool belongs to
-5. Each toolkit-based tool can only use one connected account at a time
-
-## What to read next
-
-<Cards>
- <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
- <Card icon={<Wrench />} title="Fetching tools" href="/docs/tools-direct/fetching-tools" description="Fetch and filter tools, inspect schemas, and search semantically" />
- <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
-</Cards>
diff --git a/docs/content/docs/tools-direct/executing-tools.mdx b/docs/content/docs/tools-direct/executing-tools.mdx
index ccf5fa40c..4c35d9760 100644
--- a/docs/content/docs/tools-direct/executing-tools.mdx
+++ b/docs/content/docs/tools-direct/executing-tools.mdx
@@ -307,7 +307,7 @@ console.log(data);
</Tabs>
<Callout type="info">
-Need an API that isn't supported by any Composio toolkit, or want to extend an existing one? Learn how to [create custom tools](/docs/tools-direct/custom-tools).
+Need an API that isn't supported by any Composio toolkit, or want to extend an existing one? Learn how to [create session custom tools](/docs/toolkits/custom-tools-and-toolkits).
</Callout>
## Automatic File Handling
@@ -599,5 +599,5 @@ await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
<Cards>
<Card icon={<Wrench />} title="Fetching tools" href="/docs/tools-direct/fetching-tools" description="Fetch and filter tools, inspect schemas, and search semantically" />
<Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
- <Card icon={<Wrench />} title="Custom tools" href="/docs/tools-direct/custom-tools" description="Create your own standalone or toolkit-based tools" />
+ <Card icon={<Wrench />} title="Custom tools" href="/docs/toolkits/custom-tools-and-toolkits" description="Create local tools that run inside sessions" />
</Cards>
diff --git a/docs/content/docs/tools-direct/meta.json b/docs/content/docs/tools-direct/meta.json
index bb9f3efcb..52ef02b22 100644
--- a/docs/content/docs/tools-direct/meta.json
+++ b/docs/content/docs/tools-direct/meta.json
@@ -6,7 +6,6 @@
"authenticating-tools",
"executing-tools",
"modify-tool-behavior",
- "custom-tools",
"toolkit-versioning"
]
}
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
index 3a54a342e..439fe841a 100644
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -354,7 +354,17 @@ const config = {
},
{
source: '/docs/custom-tools',
- destination: '/docs/tools-direct/custom-tools',
+ destination: '/docs/toolkits/custom-tools-and-toolkits',
+ permanent: true,
+ },
+ {
+ source: '/docs/tools-direct/custom-tools',
+ destination: '/docs/toolkits/custom-tools-and-toolkits',
+ permanent: true,
+ },
+ {
+ source: '/docs/tools-direct/custom-tools/:path*',
+ destination: '/docs/toolkits/custom-tools-and-toolkits',
permanent: true,
},
{
@@ -428,7 +438,7 @@ const config = {
},
{
source: '/custom-tools/:path*',
- destination: '/docs/tools-direct/custom-tools',
+ destination: '/docs/toolkits/custom-tools-and-toolkits',
permanent: true,
},
// Error handling redirect (old fern URL)
diff --git a/docs/tests/integration/redirects.test.ts b/docs/tests/integration/redirects.test.ts
index 58cf19e6d..0ed7f63f7 100644
--- a/docs/tests/integration/redirects.test.ts
+++ b/docs/tests/integration/redirects.test.ts
@@ -23,7 +23,10 @@ const REDIRECTS = [
{ from: "/docs/providers/langgraph", to: "/docs/providers/langchain" },
{ from: "/tools", to: "/toolkits" },
{ from: "/docs/fetching-tools", to: "/docs/tools-direct/fetching-tools" },
- { from: "/docs/custom-tools", to: "/docs/tools-direct/custom-tools" },
+ { from: "/docs/custom-tools", to: "/docs/toolkits/custom-tools-and-toolkits" },
+ { from: "/docs/tools-direct/custom-tools", to: "/docs/toolkits/custom-tools-and-toolkits" },
+ { from: "/docs/tools-direct/custom-tools/github", to: "/docs/toolkits/custom-tools-and-toolkits" },
+ { from: "/custom-tools/github", to: "/docs/toolkits/custom-tools-and-toolkits" },
{ from: "/docs/how-tools-work", to: "/docs/tools-and-toolkits" },
{ from: "/authentication", to: "/docs/authentication" },
{ from: "/changelog", to: "/docs/changelog" },