@devries-cameron20 / composio Mirror · read-only / commits / 26e39ba99
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 05:45 UTC

docs: improve cross-linking across all documentation pages

Add "What to read next" card footers, inline links, and session-guide callouts so pages are no longer standalone islands. Changes span all 7 sidebar sections (29 files, +190 lines): - Get Started: quickstart intro links, cookbook card - Core Concepts: workbench and triggers cross-links - Getting Started: in-chat auth, fetching tools, enable/disable, creating triggers - Guides: white-labeling, managing accounts, custom auth, webhooks, connection expiry - Features: CLI callout, projects footer - Direct Tool Execution: footers for all 12 pages, improved session callouts - Resources: glossary terms linked to docs, debugging-info internal links, toolkit-versioning migration footer Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmitha Mallesh committed Mar 2, 2026 at 17:02 UTC 26e39ba99538c960793e2cc4dee0628e4bf38b2e
29 files changed +190 -37
docs/content/docs/auth-configuration/connected-accounts.mdx
+12
@@ -331,6 +331,10 @@ try {
331 </Tab>
332 </Tabs>
333
334 +<Callout type="info">
335 +For session-based apps, see [Managing multiple connected accounts](/docs/managing-multiple-connected-accounts) for how sessions handle account selection automatically.
336 +</Callout>
337 +
338 ### Execute with a specific account
339
340 When you have multiple accounts, specify which one to use with `connected_account_id`:
@@ -367,3 +371,11 @@ console.log('Tool executed:', result);
371 ```
372 </Tab>
373 </Tabs>
374 +
375 +## What to read next
376 +
377 +<Cards>
378 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
379 + <Card icon={<Palette />} title="Custom auth configs" href="/docs/auth-configuration/custom-auth-configs" description="Use your own OAuth apps for white-labeled authentication" />
380 + <Card icon={<Wrench />} title="Programmatic auth configs" href="/docs/auth-configuration/programmatic-auth-configs" description="Create auth configs programmatically via the SDK" />
381 +</Cards>
docs/content/docs/auth-configuration/custom-auth-configs.mdx
+8
@@ -254,3 +254,11 @@ The custom redirect endpoint is a simple passthrough that preserves all OAuth pa
254
255 </Accordion>
256 </Accordions>
257 +
258 +## What to read next
259 +
260 +<Cards>
261 + <Card icon={<Database />} title="Connected accounts" href="/docs/auth-configuration/connected-accounts" description="Manage and monitor user connections to toolkits" />
262 + <Card icon={<Wrench />} title="Programmatic auth configs" href="/docs/auth-configuration/programmatic-auth-configs" description="Create auth configs programmatically via the SDK" />
263 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
264 +</Cards>
docs/content/docs/auth-configuration/custom-auth-params.mdx
+8
@@ -147,3 +147,11 @@ console.log(JSON.stringify(result, null, 2));
147 ```
148 </Tab>
149 </Tabs>
150 +
151 +## What to read next
152 +
153 +<Cards>
154 + <Card icon={<Wrench />} title="Before execution modifiers" href="/docs/tools-direct/modify-tool-behavior/before-execution-modifiers" description="Modify tool arguments before execution" />
155 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
156 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
157 +</Cards>
docs/content/docs/auth-configuration/programmatic-auth-configs.mdx
+8
@@ -252,3 +252,11 @@ console.log("Required auth config fields:", authFields);
252 </Tabs>
253
254 Then inspect the required fields and specify them in the `credentials` object.
255 +
256 +## What to read next
257 +
258 +<Cards>
259 + <Card icon={<Palette />} title="Custom auth configs" href="/docs/auth-configuration/custom-auth-configs" description="Use your own OAuth apps for white-labeled authentication" />
260 + <Card icon={<Database />} title="Connected accounts" href="/docs/auth-configuration/connected-accounts" description="Manage and monitor user connections to toolkits" />
261 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
262 +</Cards>
docs/content/docs/authenticating-users/in-chat-authentication.mdx
+1 -1
@@ -4,7 +4,7 @@ description: Let your agent prompt users to connect accounts during conversation
4 keywords: [automatic auth, dynamic auth, agent prompts]
5 ---
6
7 -In-chat authentication lets your agent prompt users to connect accounts during chat. When a tool requires authentication, the agent returns a Connect Link URL. The user authenticates, confirms in chat, and the agent retries.
7 +In-chat authentication lets your agent prompt users to connect accounts during chat. When a tool requires authentication, the agent returns a Connect Link URL. The user authenticates, confirms in chat, and the agent retries. For an overview of all auth approaches, see [Authentication](/docs/authentication).
8
9 ## How it works
10
docs/content/docs/cli.mdx
+6 -1
@@ -61,7 +61,11 @@ composio logout
61
62 ## Generate type definitions
63
64 -Generate TypeScript or Python type definitions for all Composio tools. These types provide type safety when using direct tool execution (`composio.tools.execute()`), helping you pass the correct parameters and catch errors early.
64 +<Callout type="info">
65 +Type generation is only useful if you're using [direct tool execution](/docs/tools-direct/executing-tools). If you're using sessions with meta tools, you don't need this.
66 +</Callout>
67 +
68 +Generate TypeScript or Python type definitions for all Composio tools. These types provide type safety when using `composio.tools.execute()`, helping you pass the correct parameters and catch errors early.
69
70 ### Auto-detect and generate
71
@@ -130,3 +134,4 @@ For explicit control, use language-specific commands:
134 ```
135 </Tab>
136 </Tabs>
137 +
docs/content/docs/debugging-info.mdx
+1 -1
@@ -4,7 +4,7 @@ description: Share your debugging info with Composio team for faster issue resol
4 keywords: [debug, support, troubleshoot]
5 ---
6
7 -Your debugging info is tied to your project and it helps us trace what happened and debug the issue faster.
7 +Your debugging info is tied to your [project](/docs/projects) and it helps us trace what happened and debug the issue faster. Before reaching out, check the [troubleshooting guide](/docs/troubleshooting) and [common FAQ](/docs/common-faq) for solutions to frequent issues.
8
9 ## Finding Your Debugging Info
10
docs/content/docs/glossary.mdx
+16 -16
@@ -8,7 +8,7 @@ keywords: [glossary, definitions, terminology]
8 <Glossary>
9
10 <GlossaryTerm name="Auth Config">
11 -A blueprint defining how authentication works for a toolkit: auth method (OAuth2, API key, Bearer token, Basic Auth), scopes, and credentials. Created automatically by a session when needed. You can create a custom one to use your own OAuth credentials or non-default scopes.
11 +A blueprint defining how authentication works for a toolkit: auth method (OAuth2, API key, Bearer token, Basic Auth), scopes, and credentials. Created automatically by a [session](/docs/users-and-sessions) when needed. You can [create a custom one](/docs/auth-configuration/custom-auth-configs) to use your own OAuth credentials or non-default scopes.
12 </GlossaryTerm>
13
14 <GlossaryTerm name="Auth Scheme">
@@ -28,11 +28,11 @@ The default mode where Composio provides its own OAuth app credentials for each
28 </GlossaryTerm>
29
30 <GlossaryTerm name="Connect Link">
31 -A hosted page where a user authorizes access to a toolkit. Returned as a `redirect_url` from `session.authorize()` or `connectedAccounts.initiate()`. Composio manages the full OAuth flow.
31 +A hosted page where a user authorizes access to a toolkit. Returned as a `redirect_url` from `session.authorize()` or `connectedAccounts.initiate()`. Composio manages the full OAuth flow. See [Authentication](/docs/authentication).
32 </GlossaryTerm>
33
34 <GlossaryTerm name="Connected Account">
35 -Created when a user authenticates with a toolkit. Stores credentials (OAuth tokens or API keys) linked to a user ID. Composio automatically refreshes OAuth tokens. A user can have multiple connected accounts for the same toolkit. IDs are prefixed `ca_`.
35 +Created when a user authenticates with a toolkit. Stores credentials (OAuth tokens or API keys) linked to a user ID. Composio automatically refreshes OAuth tokens. A user can have [multiple connected accounts](/docs/managing-multiple-connected-accounts) for the same toolkit. IDs are prefixed `ca_`.
36 </GlossaryTerm>
37
38 <GlossaryTerm name="Connection Request">
@@ -40,11 +40,11 @@ The object returned when you initiate authentication. Contains the Connect Link
40 </GlossaryTerm>
41
42 <GlossaryTerm name="Custom Tool">
43 -A user-defined tool used alongside Composio's built-in tools. Can be standalone (no auth) or toolkit-based (authenticated API requests). Stored in memory, must be recreated on restart.
43 +A user-defined tool used alongside Composio's built-in tools. Can be standalone (no auth) or toolkit-based (authenticated API requests). Stored in memory, must be recreated on restart. See [Creating custom tools](/docs/tools-direct/custom-tools).
44 </GlossaryTerm>
45
46 <GlossaryTerm name="In-Chat Authentication">
47 -A flow where the AI agent handles authentication by calling `COMPOSIO_MANAGE_CONNECTIONS` to generate a Connect Link and send it to the user in the conversation.
47 +A flow where the AI agent handles authentication by calling `COMPOSIO_MANAGE_CONNECTIONS` to generate a Connect Link and send it to the user in the conversation. See [In-chat authentication](/docs/authenticating-users/in-chat-authentication).
48 </GlossaryTerm>
49
50 <GlossaryTerm name="MCP (Model Context Protocol)">
@@ -52,15 +52,15 @@ An open protocol for connecting AI models to external tools. Every session expos
52 </GlossaryTerm>
53
54 <GlossaryTerm name="Manual Authentication">
55 -Authenticating users from your own code using `session.authorize()` or `connectedAccounts.initiate()`, as opposed to letting the AI agent handle it via in-chat authentication.
55 +Authenticating users from your own code using `session.authorize()` or `connectedAccounts.initiate()`, as opposed to letting the AI agent handle it via in-chat authentication. See [Manual authentication](/docs/authenticating-users/manually-authenticating).
56 </GlossaryTerm>
57
58 <GlossaryTerm name="Meta Tools">
59 -A set of tools included in every session, including `COMPOSIO_SEARCH_TOOLS`, `COMPOSIO_MANAGE_CONNECTIONS`, `COMPOSIO_MULTI_EXECUTE_TOOL`, `COMPOSIO_REMOTE_WORKBENCH`, and `COMPOSIO_REMOTE_BASH_TOOL`. They let the agent discover tools, manage auth, execute in parallel, and run code without loading hundreds of tool definitions upfront.
59 +A set of tools included in every session, including `COMPOSIO_SEARCH_TOOLS`, `COMPOSIO_MANAGE_CONNECTIONS`, `COMPOSIO_MULTI_EXECUTE_TOOL`, `COMPOSIO_REMOTE_WORKBENCH`, and `COMPOSIO_REMOTE_BASH_TOOL`. They let the agent discover tools, manage auth, execute in parallel, and run code without loading hundreds of tool definitions upfront. See [Tools and toolkits](/docs/tools-and-toolkits#meta-tools).
60 </GlossaryTerm>
61
62 <GlossaryTerm name="Modifiers">
63 -Middleware that transforms tool behavior: **schema modifiers** change a tool's schema before the agent sees it, **before-execution modifiers** modify arguments before a tool runs, **after-execution modifiers** transform the result.
63 +Middleware that transforms tool behavior: [schema modifiers](/docs/tools-direct/modify-tool-behavior/schema-modifiers) change a tool's schema before the agent sees it, [before-execution modifiers](/docs/tools-direct/modify-tool-behavior/before-execution-modifiers) modify arguments before a tool runs, [after-execution modifiers](/docs/tools-direct/modify-tool-behavior/after-execution-modifiers) transform the result.
64 </GlossaryTerm>
65
66 <GlossaryTerm name="Native Tools">
@@ -76,7 +76,7 @@ A key (`x-org-api-key`) for organization-level operations like creating and mana
76 </GlossaryTerm>
77
78 <GlossaryTerm name="Project">
79 -An isolated environment within an organization that scopes API keys, connected accounts, auth configs, and webhooks. Resources in one project are inaccessible from another. IDs are prefixed `proj_`.
79 +An isolated environment within an organization that scopes API keys, connected accounts, auth configs, and webhooks. Resources in one project are inaccessible from another. IDs are prefixed `proj_`. See [Projects](/docs/projects).
80 </GlossaryTerm>
81
82 <GlossaryTerm name="Proxy Execute">
@@ -84,11 +84,11 @@ Making authenticated HTTP requests through a toolkit's connected account without
84 </GlossaryTerm>
85
86 <GlossaryTerm name="Provider">
87 -An adapter package that transforms Composio tools into the format expected by an AI framework (OpenAI, Anthropic, LangChain, Vercel AI SDK, etc.).
87 +An adapter package that transforms Composio tools into the format expected by an AI framework (OpenAI, Anthropic, LangChain, Vercel AI SDK, etc.). See [Providers](/docs/providers).
88 </GlossaryTerm>
89
90 <GlossaryTerm name="Session">
91 -An ephemeral configuration object from `composio.create(userId)`. Ties together a user ID, available toolkits, auth config, and connected accounts. Immutable. Exposes `tools()`, `mcp.url`, `authorize()`, and `toolkits()`.
91 +An ephemeral configuration object from `composio.create(userId)`. Ties together a user ID, available toolkits, auth config, and connected accounts. Immutable. Exposes `tools()`, `mcp.url`, `authorize()`, and `toolkits()`. See [Users and sessions](/docs/users-and-sessions).
92 </GlossaryTerm>
93
94 <GlossaryTerm name="Session ID">
@@ -112,11 +112,11 @@ The lowercase identifier for a toolkit, e.g. `github`, `gmail`, `slack`. Used wh
112 </GlossaryTerm>
113
114 <GlossaryTerm name="Toolkit Versioning">
115 -Pinning a toolkit to a specific version so your integration uses a consistent set of tools even as Composio updates definitions.
115 +Pinning a toolkit to a specific version so your integration uses a consistent set of tools even as Composio updates definitions. See [Toolkit versioning](/docs/tools-direct/toolkit-versioning).
116 </GlossaryTerm>
117
118 <GlossaryTerm name="Trigger">
119 -Sends structured payloads to your application when something happens in a connected app. Two delivery types: **webhook** (the app pushes events in real time, e.g. GitHub, Slack) and **polling** (Composio periodically checks for new data, e.g. Gmail).
119 +Sends structured payloads to your application when something happens in a connected app. Two delivery types: **webhook** (the app pushes events in real time, e.g. GitHub, Slack) and **polling** (Composio periodically checks for new data, e.g. Gmail). See [Triggers](/docs/triggers).
120 </GlossaryTerm>
121
122 <GlossaryTerm name="Trigger Instance">
@@ -124,15 +124,15 @@ A specific, active trigger scoped to a user's connected account.
124 </GlossaryTerm>
125
126 <GlossaryTerm name="User ID">
127 -An identifier from your application that Composio uses to scope connected accounts, tool executions, and authorizations. Connections are fully isolated between user IDs.
127 +An identifier from your application that Composio uses to scope connected accounts, tool executions, and authorizations. Connections are fully isolated between user IDs. See [Users and sessions](/docs/users-and-sessions).
128 </GlossaryTerm>
129
130 <GlossaryTerm name="White-Labeling">
131 -Customizing the auth experience so users see your brand during the OAuth flow. You provide your own OAuth credentials, redirect URIs, and branding.
131 +Customizing the auth experience so users see your brand during the OAuth flow. You provide your own OAuth credentials, redirect URIs, and branding. See [White-labeling authentication](/docs/white-labeling-authentication).
132 </GlossaryTerm>
133
134 <GlossaryTerm name="Workbench">
135 -A persistent Python sandbox via the `COMPOSIO_REMOTE_WORKBENCH` meta tool. State persists across calls within a session. Used for bulk operations, data transformations, and processing large tool responses.
135 +A persistent Python sandbox via the `COMPOSIO_REMOTE_WORKBENCH` meta tool. State persists across calls within a session. Used for bulk operations, data transformations, and processing large tool responses. See [Workbench](/docs/workbench).
136 </GlossaryTerm>
137
138 </Glossary>
docs/content/docs/managing-multiple-connected-accounts.mdx
+9 -1
@@ -4,7 +4,7 @@ description: Handle users with multiple accounts for the same toolkit
4 keywords: [multiple accounts, work personal, switch account]
5 ---
6
7 -Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail accounts). This is useful when users need to manage different email accounts, GitHub organizations, or separate work and personal contexts. This guide explains how to connect, select, and manage multiple accounts.
7 +Users can connect multiple accounts for the same toolkit (e.g., personal and work Gmail accounts). This is useful when users need to manage different email accounts, GitHub organizations, or separate work and personal contexts. This guide explains how to connect, select, and manage multiple accounts. For background on how users, sessions, and connected accounts relate, see [Users & Sessions](/docs/users-and-sessions).
8
9 ## Default account behavior
10
@@ -142,3 +142,11 @@ for (const toolkit of toolkits.items) {
142 ```
143 </Tab>
144 </Tabs>
145 +
146 +## What to read next
147 +
148 +<Cards>
149 + <Card icon={<Wrench />} title="Configuring sessions" href="/docs/configuring-sessions" description="Pass connectedAccounts, auth configs, and toolkit restrictions to sessions" />
150 + <Card icon={<ShieldCheck />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating" description="Pre-authenticate users with session.authorize() and Connect Links" />
151 + <Card icon={<Key />} title="Authentication overview" href="/docs/authentication" description="Connect Links, OAuth, API keys, and how Composio manages auth" />
152 +</Cards>
docs/content/docs/migration-guide/toolkit-versioning.mdx
+6 -2
@@ -156,6 +156,10 @@ const result = await composio.tools.execute({
156 The `dangerouslySkipVersionCheck` flag is only for migration or debugging. Never use in production.
157 </Callout>
158
159 -## Next steps
159 +## What to read next
160
161 -For complete documentation on toolkit versioning, including best practices and advanced configuration, see [Toolkit versioning](/docs/tools-direct/toolkit-versioning).
161 +<Cards>
162 + <Card icon={<Blocks />} title="Toolkit versioning" href="/docs/tools-direct/toolkit-versioning" description="Complete guide to version formats, resolution order, and managing versions" />
163 + <Card icon={<Rocket />} title="Migrate to sessions" href="/docs/migration-guide/direct-to-sessions" description="Move from direct tool execution to the sessions pattern" />
164 + <Card icon={<Play />} title="Quickstart" href="/docs/quickstart" description="Build your first agent with the sessions API" />
165 +</Cards>
docs/content/docs/projects.mdx
+8
@@ -86,3 +86,11 @@ curl -X PATCH https://backend.composio.dev/api/v3/org/project/config \
86 ```
87
88 You can also view and update these from **Settings > Project Settings** in the [dashboard](https://platform.composio.dev?next_page=/settings). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
89 +
90 +## What to read next
91 +
92 +<Cards>
93 + <Card icon={<Key />} title="Authentication" href="/docs/authentication" description="Auth configs are scoped to projects — learn how Composio manages auth" />
94 + <Card icon={<Database />} title="Users & Sessions" href="/docs/users-and-sessions" description="Connected accounts and sessions live within a project" />
95 + <Card icon={<Zap />} title="Triggers" href="/docs/triggers" description="Webhook configurations are project-scoped" />
96 +</Cards>
docs/content/docs/quickstart.mdx
+2 -1
@@ -4,7 +4,7 @@ description: Build an AI agent with access to 1000+ tools
4 keywords: [tutorial, setup, first agent]
5 ---
6
7 -Build your first AI agent with Composio Tools.
7 +Build your first AI agent with Composio Tools. You'll create a [session](/docs/users-and-sessions) for a user, give your agent access to [tools](/docs/tools-and-toolkits), and let it take action across 1000+ apps.
8
9 <QuickstartFlow>
10
@@ -836,5 +836,6 @@ By default, sessions have access to **all available toolkits** in the Composio c
836 <Card icon={<Wrench />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Restrict toolkits, set custom auth configs, and select connected accounts" />
837 <Card icon={<Key />} title="Authenticating Users" href="/docs/authentication" description="Learn how users connect their accounts via Connect Links, OAuth, and API keys" />
838 <Card icon={<BookOpen />} title="How Composio works" href="/docs/how-composio-works" description="Understand what happens under the hood: sessions, meta tools, and the tool execution lifecycle" />
839 + <Card icon={<Play />} title="Build a chat app" href="/cookbooks/chat-app" description="Full Next.js tutorial: tool discovery, auth, and multi-turn conversations" />
840 </Cards>
841
docs/content/docs/setting-up-triggers/creating-triggers.mdx
+1 -1
@@ -4,7 +4,7 @@ description: Create trigger instances via the dashboard or SDK
4 keywords: [triggers, create trigger, trigger config]
5 ---
6
7 -Create a trigger to start receiving events. A trigger watches for a specific event (e.g., `GITHUB_COMMIT_EVENT`) on a specific user's connected account.
7 +Create a trigger to start receiving events. A trigger watches for a specific event (e.g., `GITHUB_COMMIT_EVENT`) on a specific user's connected account. For an overview of how triggers work, see [Triggers](/docs/triggers).
8
9 <Callout type="info" title="Prerequisites">
10 Before creating triggers, ensure you have:
docs/content/docs/subscribing-to-connection-expiry-events.mdx
+8
@@ -162,3 +162,11 @@ console.log(`Re-connected: ${connectedAccount.id}`);
162 <Callout>
163 Always [verify webhook signatures](/docs/webhook-verification) before processing events in production.
164 </Callout>
165 +
166 +## What to read next
167 +
168 +<Cards>
169 + <Card icon={<ShieldCheck />} title="Verifying webhooks" href="/docs/webhook-verification" description="Validate webhook signatures to ensure payloads are authentic" />
170 + <Card icon={<Zap />} title="Subscribing to events" href="/docs/setting-up-triggers/subscribing-to-events" description="Set up webhooks and SDK subscriptions to receive trigger events" />
171 + <Card icon={<Key />} title="Authentication overview" href="/docs/authentication" description="How Composio manages OAuth, token refresh, and connected accounts" />
172 +</Cards>
docs/content/docs/toolkits/enable-and-disable-toolkits.mdx
+2
@@ -271,5 +271,7 @@ const session = await composio.create("user_123", {
271
272 <Cards>
273 <Card icon={<Wrench />} title="Fetching tools and toolkits" href="/docs/toolkits/fetching-tools-and-toolkits" description="List enabled toolkits, get meta tools, and browse the catalog" />
274 + <Card icon={<Wrench />} title="Configuring sessions" href="/docs/configuring-sessions" description="Auth configs, connected accounts, and other session options" />
275 + <Card icon={<Wrench />} title="Tools and toolkits" href="/docs/tools-and-toolkits" description="How meta tools discover, authenticate, and execute tools at runtime" />
276 </Cards>
277
docs/content/docs/toolkits/fetching-tools-and-toolkits.mdx
+2
@@ -177,4 +177,6 @@ console.log(tool.outputParameters);
177
178 <Cards>
179 <Card icon={<Wrench />} title="Enable & disable toolkits" href="/docs/toolkits/enable-and-disable-toolkits" description="Control which toolkits and individual tools are available in sessions" />
180 + <Card icon={<Wrench />} title="Tools and toolkits" href="/docs/tools-and-toolkits" description="How meta tools discover, authenticate, and execute tools at runtime" />
181 + <Card icon={<Blocks />} title="Browse toolkits" href="/toolkits" description="Explore all available toolkits and their tools" />
182 </Cards>
docs/content/docs/tools-direct/authenticating-tools.mdx
+6 -2
@@ -522,6 +522,10 @@ filteredConnections.items.forEach(connection => {
522 Only connections with **ACTIVE** status can be used to execute tools. If a connection is in any other state, you'll need to take appropriate action (re-authenticate, wait for processing, etc.) before using it.
523 </Callout>
524
525 -## Next Step
525 +## What to read next
526
527 -With authentication set up, you can now fetch and execute tools. See [Executing Tools](/docs/tools-direct/executing-tools) to get started.
527 +<Cards>
528 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
529 + <Card icon={<Database />} title="Connected accounts" href="/docs/auth-configuration/connected-accounts" description="Manage and monitor user connections to toolkits" />
530 + <Card icon={<Palette />} title="Custom auth configs" href="/docs/auth-configuration/custom-auth-configs" description="Use your own OAuth apps for white-labeled authentication" />
531 +</Cards>
docs/content/docs/tools-direct/custom-tools.mdx
+9 -1
@@ -6,7 +6,7 @@ llmGuardrails: "direct-execution"
6 ---
7
8 <Callout type="info">
9 -If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically.
9 +If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. See [Tools and toolkits](/docs/tools-and-toolkits) for how sessions discover and execute tools automatically.
10 </Callout>
11
12 Custom tools allow you to create your own tools that can be used with Composio.
@@ -370,3 +370,11 @@ const result = await composio.tools.execute('TOOL_SLUG', {
370 3. Toolkit-based tools require a valid connected account with the specified toolkit
371 4. `executeToolRequest` can only execute tools from the same toolkit that the custom tool belongs to
372 5. Each toolkit-based tool can only use one connected account at a time
373 +
374 +## What to read next
375 +
376 +<Cards>
377 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
378 + <Card icon={<Wrench />} title="Fetching tools" href="/docs/tools-direct/fetching-tools" description="Fetch and filter tools, inspect schemas, and search semantically" />
379 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
380 +</Cards>
docs/content/docs/tools-direct/executing-tools.mdx
+9 -1
@@ -6,7 +6,7 @@ llmGuardrails: "direct-execution"
6 ---
7
8 <Callout type="info">
9 -If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically.
9 +If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically. See the [quickstart](/docs/quickstart) to build your first agent with sessions.
10 </Callout>
11
12 LLMs on their own can only do generation. Tool calling changes that by letting them interact with external services. Instead of just drafting an email, the model can call `GMAIL_SEND_EMAIL` to actually send it. The tool's results feed back to the LLM, closing the loop so it can decide, act, observe, and adapt.
@@ -401,3 +401,11 @@ const fileData = await composio.files.upload({
401 toolkitSlug: 'googledrive'
402 });
403 ```
404 +
405 +## What to read next
406 +
407 +<Cards>
408 + <Card icon={<Wrench />} title="Fetching tools" href="/docs/tools-direct/fetching-tools" description="Fetch and filter tools, inspect schemas, and search semantically" />
409 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
410 + <Card icon={<Wrench />} title="Custom tools" href="/docs/tools-direct/custom-tools" description="Create your own standalone or toolkit-based tools" />
411 +</Cards>
docs/content/docs/tools-direct/fetching-tools.mdx
+8
@@ -241,3 +241,11 @@ const toolkitSearchRaw = await composio.tools.getRawComposioTools({
241 <Callout type="info">
242 Use specific toolkit versions in production to prevent breaking changes. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).
243 </Callout>
244 +
245 +## What to read next
246 +
247 +<Cards>
248 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
249 + <Card icon={<Key />} title="Authenticating tools" href="/docs/tools-direct/authenticating-tools" description="Create auth configs and connect user accounts" />
250 + <Card icon={<Blocks />} title="Toolkit versioning" href="/docs/tools-direct/toolkit-versioning" description="Pin specific tool versions for consistent behavior in production" />
251 +</Cards>
docs/content/docs/tools-direct/modify-tool-behavior/after-execution-modifiers.mdx
+9 -1
@@ -5,7 +5,7 @@ llmGuardrails: "direct-execution"
5 ---
6
7 <Callout type="info">
8 -If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically.
8 +If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. See [Tools and toolkits](/docs/tools-and-toolkits#meta-tools) for how sessions handle tool discovery and execution automatically.
9 </Callout>
10
11 After execution modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.
@@ -182,3 +182,11 @@ const agenticTools = await composio.tools.get(
182 ```
183 </Tab>
184 </Tabs>
185 +
186 +## What to read next
187 +
188 +<Cards>
189 + <Card icon={<Wrench />} title="Before execution modifiers" href="/docs/tools-direct/modify-tool-behavior/before-execution-modifiers" description="Modify tool arguments before execution" />
190 + <Card icon={<Wrench />} title="Schema modifiers" href="/docs/tools-direct/modify-tool-behavior/schema-modifiers" description="Customize how tools appear to agents" />
191 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
192 +</Cards>
docs/content/docs/tools-direct/modify-tool-behavior/before-execution-modifiers.mdx
+9 -1
@@ -5,7 +5,7 @@ llmGuardrails: "direct-execution"
5 ---
6
7 <Callout type="info">
8 -If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically.
8 +If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. See [Tools and toolkits](/docs/tools-and-toolkits#meta-tools) for how sessions handle tool discovery and execution automatically.
9 </Callout>
10
11 Before execution modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.
@@ -177,3 +177,11 @@ const agenticTools = await composio.tools.get(
177 ```
178 </Tab>
179 </Tabs>
180 +
181 +## What to read next
182 +
183 +<Cards>
184 + <Card icon={<Wrench />} title="After execution modifiers" href="/docs/tools-direct/modify-tool-behavior/after-execution-modifiers" description="Transform tool results after execution" />
185 + <Card icon={<Wrench />} title="Schema modifiers" href="/docs/tools-direct/modify-tool-behavior/schema-modifiers" description="Customize how tools appear to agents" />
186 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
187 +</Cards>
docs/content/docs/tools-direct/modify-tool-behavior/schema-modifiers.mdx
+9 -1
@@ -5,7 +5,7 @@ llmGuardrails: "direct-execution"
5 ---
6
7 <Callout type="info">
8 -If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. Sessions handle tool fetching, authentication, and execution automatically.
8 +If you're building an agent, we recommend using [sessions](/docs/configuring-sessions) instead. See [Tools and toolkits](/docs/tools-and-toolkits#meta-tools) for how sessions handle tool discovery and execution automatically.
9 </Callout>
10
11 Schema modifiers are part of Composio SDK's powerful middleware capabilities that allow you to customize and extend the behavior of tools.
@@ -267,3 +267,11 @@ console.log(tools);
267 ```
268 </Tab>
269 </Tabs>
270 +
271 +## What to read next
272 +
273 +<Cards>
274 + <Card icon={<Wrench />} title="Before execution modifiers" href="/docs/tools-direct/modify-tool-behavior/before-execution-modifiers" description="Modify tool arguments before execution" />
275 + <Card icon={<Wrench />} title="After execution modifiers" href="/docs/tools-direct/modify-tool-behavior/after-execution-modifiers" description="Transform tool results after execution" />
276 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
277 +</Cards>
docs/content/docs/tools-direct/toolkit-versioning.mdx
+8
@@ -166,3 +166,11 @@ console.log("Latest Version:", toolkit.meta.availableVersions?.[0]);
166 ```
167 </Tab>
168 </Tabs>
169 +
170 +## What to read next
171 +
172 +<Cards>
173 + <Card icon={<Wrench />} title="Fetching tools" href="/docs/tools-direct/fetching-tools" description="Fetch and filter tools, inspect schemas, and search semantically" />
174 + <Card icon={<Play />} title="Executing tools" href="/docs/tools-direct/executing-tools" description="Run tools with providers, agentic frameworks, or direct execution" />
175 + <Card icon={<Terminal />} title="CLI" href="/docs/cli" description="Generate type-safe code from tool schemas with the Composio CLI" />
176 +</Cards>
docs/content/docs/triggers.mdx
+2 -1
@@ -26,7 +26,7 @@ There are two delivery types:
26 A trigger type is a template that defines what event to listen for and what configuration is required. For example, `GITHUB_COMMIT_EVENT` requires an `owner` and `repo`. Each toolkit exposes its own set of trigger types.
27 </Accordion>
28 <Accordion title="What happens when you create an active trigger?">
29 -When you create a trigger from a type, it's scoped to a specific user and connected account. For example, creating a `GITHUB_COMMIT_EVENT` trigger for user `alice` on the `composio` repo produces a trigger with its own ID.
29 +When you create a trigger from a type, it's scoped to a specific [user and connected account](/docs/users-and-sessions). For example, creating a `GITHUB_COMMIT_EVENT` trigger for user `alice` on the `composio` repo produces a trigger with its own ID.
30 </Accordion>
31 </Accordions>
32
@@ -41,4 +41,5 @@ Triggers are scoped to a connected account. If you haven't set up authentication
41 <Card title="Subscribing to events" href="/docs/setting-up-triggers/subscribing-to-events" description="Receive trigger events via webhooks or SDK subscriptions" />
42 <Card title="Verifying webhooks" href="/docs/webhook-verification" description="Verify webhook signatures and understand payload versions" />
43 <Card title="Managing triggers" href="/docs/setting-up-triggers/managing-triggers" description="Discover, list, enable, disable, and delete triggers" />
44 + <Card title="Example: Gmail labeler" href="/cookbooks/gmail-labeler" description="Build an automated email labeling agent using triggers" />
45 </Cards>
docs/content/docs/using-custom-auth-configuration.mdx
+8
@@ -63,3 +63,11 @@ const session = await composio.create("user_123", {
63 Your session will now use this auth config when users connect to this toolkit.
64 </Step>
65 </Steps>
66 +
67 +## What to read next
68 +
69 +<Cards>
70 + <Card icon={<Palette />} title="White-labeling authentication" href="/docs/white-labeling-authentication" description="Use your own OAuth apps so users see your branding on consent screens" />
71 + <Card icon={<Key />} title="Authentication overview" href="/docs/authentication" description="Connect Links, OAuth, API keys, and how Composio manages auth" />
72 + <Card icon={<Wrench />} title="Configuring sessions" href="/docs/configuring-sessions" description="Pass auth configs, connected accounts, and toolkit restrictions to sessions" />
73 +</Cards>
docs/content/docs/webhook-verification.mdx
+8
@@ -193,3 +193,11 @@ Metadata fields are mixed into the `data` object alongside event data.
193 </Tab>
194 </Tabs>
195
196 +## What to read next
197 +
198 +<Cards>
199 + <Card icon={<Zap />} title="Subscribing to events" href="/docs/setting-up-triggers/subscribing-to-events" description="Set up webhooks and SDK subscriptions to receive trigger events" />
200 + <Card icon={<Zap />} title="Triggers overview" href="/docs/triggers" description="How Composio delivers event data from connected apps" />
201 + <Card icon={<Zap />} title="Connection expiry events" href="/docs/subscribing-to-connection-expiry-events" description="Detect when OAuth connections expire and prompt re-authentication" />
202 +</Cards>
203 +
docs/content/docs/white-labeling-authentication.mdx
+2
@@ -160,4 +160,6 @@ This makes the OAuth flow go through your domain first, then to Composio for tok
160
161 <Cards>
162 <Card icon={<Key />} title="Using custom auth configuration" href="/docs/using-custom-auth-configuration" description="Set up auth configs for toolkits that don't have Composio managed authentication" />
163 + <Card icon={<Key />} title="Authentication overview" href="/docs/authentication" description="Connect Links, OAuth, API keys, and how Composio manages auth" />
164 + <Card icon={<Wrench />} title="Configuring sessions" href="/docs/configuring-sessions" description="Pass auth configs, connected accounts, and toolkit restrictions to sessions" />
165 </Cards>
docs/content/docs/workbench.mdx
+5 -5
@@ -4,15 +4,15 @@ description: A persistent Python sandbox for writing code, calling tools program
4 keywords: [workbench, sandbox, remote execution, bulk operations, data processing]
5 ---
6
7 -The workbench is a persistent Python sandbox where your agent can write and execute code. It has access to all Composio tools programmatically, plus helper functions for calling LLMs, uploading files, and making API requests. State persists across calls within a session. The `COMPOSIO_REMOTE_BASH_TOOL` meta tool also runs commands in the same sandbox.
7 +The workbench is a persistent Python sandbox where your agent can write and execute code. It has access to all Composio tools programmatically, plus helper functions for calling LLMs, uploading files, and making API requests. State persists across calls within a [session](/docs/users-and-sessions). The `COMPOSIO_REMOTE_BASH_TOOL` meta tool also runs commands in the same sandbox.
8
9 <Callout>
10 -The workbench is part of the meta tools system. It's available when you create sessions, not when [executing tools directly](/docs/tools-direct/executing-tools).
10 +The workbench is part of the [meta tools](/docs/tools-and-toolkits#meta-tools) system. It's available when you create sessions, not when [executing tools directly](/docs/tools-direct/executing-tools).
11 </Callout>
12
13 ## Where it fits
14
15 -Your agent starts with `SEARCH_TOOLS` to find the right tools, then uses `MULTI_EXECUTE` for straightforward calls. When the task involves bulk operations, data transformations, or multi-step logic, the agent uses `COMPOSIO_REMOTE_WORKBENCH` instead.
15 +Your agent starts with [`SEARCH_TOOLS` to find the right tools, then uses `MULTI_EXECUTE`](/docs/tools-and-toolkits#meta-tools) for straightforward calls. When the task involves bulk operations, data transformations, or multi-step logic, the agent uses `COMPOSIO_REMOTE_WORKBENCH` instead.
16
17 ```mermaid
18 graph TD
@@ -72,7 +72,7 @@ The sandbox preserves variables and files across calls. The agent can paginate t
72 ## What to read next
73
74 <Cards>
75 - <Card icon={<Zap />} title="Triggers" href="/docs/triggers" description="Event-driven payloads from connected apps" />
75 + <Card icon={<Database />} title="Users & Sessions" href="/docs/users-and-sessions" description="How sessions scope tools, auth, and workbench state to a user" />
76 <Card icon={<Wrench />} title="Tools and toolkits" href="/docs/tools-and-toolkits" description="How meta tools discover, authenticate, and execute tools at runtime" />
77 - <Card icon={<Blocks />} title="Browse toolkits" href="/toolkits" description="Explore all available toolkits" />
77 + <Card icon={<Zap />} title="Triggers" href="/docs/triggers" description="Event-driven payloads from connected apps" />
78 </Cards>