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: add cross-linking to practical guides and getting started pages
Sushmitha Mallesha932295de3b2
diff --git a/docs/content/docs/authenticating-users/in-chat-authentication.mdx b/docs/content/docs/authenticating-users/in-chat-authentication.mdxindex 1966b5795..9b35e159d 100644--- a/docs/content/docs/authenticating-users/in-chat-authentication.mdx+++ b/docs/content/docs/authenticating-users/in-chat-authentication.mdx@@ -183,4 +183,13 @@ Assistant: What would you like me to do today? Type 'exit' to end the conversatiAssistant: I need you to connect your GitHub account first.Please click here to authorize: https://connect.composio.dev/link/ln_abc123-> Done\ No newline at end of file+> Done+```++## What to read next++<Cards>+ <Card icon={<ShieldCheck />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating" description="Pre-authenticate users before chat using Connect Links and session.authorize()" />+ <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" />+ <Card icon={<Wrench />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Restrict toolkits, set custom auth configs, and select connected accounts" />+</Cards>\ No newline at end of filediff --git a/docs/content/docs/authenticating-users/manually-authenticating.mdx b/docs/content/docs/authenticating-users/manually-authenticating.mdxindex 384951b16..d8b264491 100644--- a/docs/content/docs/authenticating-users/manually-authenticating.mdx+++ b/docs/content/docs/authenticating-users/manually-authenticating.mdx@@ -147,6 +147,7 @@ const session = await composio.create("user_123", {## Putting it together+A common pattern is to verify all required connections before starting the agent:<Tabs groupId="language" items={['Python', 'TypeScript']} persist>@@ -212,3 +213,11 @@ console.log(`All toolkits connected! MCP URL: ${session.mcp.url}`);```</Tab></Tabs>++## What to read next++<Cards>+ <Card icon={<MessageCircle />} title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication" description="Let the agent prompt users to connect accounts during conversation instead" />+ <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" />+ <Card icon={<Database />} title="Managing multiple accounts" href="/docs/managing-multiple-connected-accounts" description="Handle users with multiple accounts for the same toolkit (e.g., work and personal Gmail)" />+</Cards>diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdxindex bf2be867d..43bcc5127 100644--- a/docs/content/docs/configuring-sessions.mdx+++ b/docs/content/docs/configuring-sessions.mdx@@ -271,3 +271,12 @@ toolkits.items.forEach((toolkit) => {</Tabs>Returns the first 20 toolkits by default.++## What to read next++<Cards>+ <Card icon={<MessageCircle />} title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication" description="Let the agent prompt users to connect accounts during conversation" />+ <Card icon={<ShieldCheck />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating" description="Pre-authenticate users before chat using Connect Links and session.authorize()" />+ <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" />+ <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" />+</Cards>diff --git a/docs/content/docs/projects.mdx b/docs/content/docs/projects.mdxindex b41438261..fe4ec2b8c 100644--- a/docs/content/docs/projects.mdx+++ b/docs/content/docs/projects.mdx@@ -1,10 +1,10 @@---title: Projects-description: Organize your Composio resources with projects and manage team access-keywords: [projects, organizations, teams, api keys, environments]+description: Isolate resources across environments or clients using projects for multi-tenancy+keywords: [projects, organizations, teams, api keys, environments, multi-tenancy, multitenancy, tenant isolation]----Every Composio account belongs to an **organization**. Inside an organization, **projects** are isolated environments that scope your API keys, connected accounts, auth configs, and webhook configurations. Resources in one project are not accessible from another.+Projects are Composio's multi-tenancy primitive. Every Composio account belongs to an **organization**. Inside an organization, **projects** are isolated environments that scope your API keys, connected accounts, auth configs, and webhook configurations. Resources in one project are not accessible from another.```mermaidgraph LR@@ -19,9 +19,9 @@ graph LR```Common reasons to use multiple projects:-- **Separate environments** — keep production and staging isolated-- **Separate products** — keep resources for different apps independent-- **Client isolation** — give each client their own project with separate credentials and data+- **Separate environments**: keep production and staging isolated+- **Separate products**: keep resources for different apps independent+- **Client isolation**: give each client their own project with separate credentials and data## Managing projectsdiff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdxindex 231a9d675..82bb993f1 100644--- a/docs/content/docs/quickstart.mdx+++ b/docs/content/docs/quickstart.mdx@@ -831,5 +831,6 @@ readline.close();<Cards><Card icon={<Wrench />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Restrict toolkits, set custom auth configs, and select connected accounts" /><Card icon={<Key />} title="Authenticating Users" href="/docs/authentication" description="Learn how users connect their accounts via Connect Links, OAuth, and API keys" />+ <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" /></Cards>diff --git a/docs/content/docs/setting-up-triggers/creating-triggers.mdx b/docs/content/docs/setting-up-triggers/creating-triggers.mdxindex 1c5c2ff71..cfb1b0d92 100644--- a/docs/content/docs/setting-up-triggers/creating-triggers.mdx+++ b/docs/content/docs/setting-up-triggers/creating-triggers.mdx@@ -85,3 +85,10 @@ The trigger instance uses the toolkit version configured during Composio initial5. Click **Create Trigger**<Video src="/videos/triggers-creation.mp4" caption="Creating a GitHub Star Added trigger from the dashboard" />++## What to read next++<Cards>+ <Card icon={<Zap />} title="Subscribing to events" href="/docs/setting-up-triggers/subscribing-to-events" description="Receive trigger events via webhooks or SDK subscriptions" />+ <Card icon={<Zap />} title="Managing triggers" href="/docs/setting-up-triggers/managing-triggers" description="List, enable, disable, and delete trigger instances" />+</Cards>diff --git a/docs/content/docs/setting-up-triggers/managing-triggers.mdx b/docs/content/docs/setting-up-triggers/managing-triggers.mdxindex a971572bd..06057bca7 100644--- a/docs/content/docs/setting-up-triggers/managing-triggers.mdx+++ b/docs/content/docs/setting-up-triggers/managing-triggers.mdx@@ -121,3 +121,11 @@ await composio.triggers.delete('ti_abcd123');<Callout type="warn">Deleting a trigger is permanent. Use `disable()` instead to temporarily stop receiving events.</Callout>++## What to read next++<Cards>+ <Card icon={<Zap />} title="Creating triggers" href="/docs/setting-up-triggers/creating-triggers" description="Create trigger instances to start receiving events from connected apps" />+ <Card icon={<Zap />} title="Subscribing to events" href="/docs/setting-up-triggers/subscribing-to-events" description="Set up webhooks or SDK subscriptions to handle trigger events" />+ <Card icon={<ShieldCheck />} title="Verifying webhooks" href="/docs/webhook-verification" description="Validate webhook signatures to ensure payloads are authentic" />+</Cards>diff --git a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdxindex 32c0fe81a..5fd91f081 100644--- a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx+++ b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx@@ -222,6 +222,10 @@ Every webhook event includes a `metadata` object that tells you exactly where itUse `trigger_id` to match events to a specific trigger instance, or `trigger_slug` to handle all events of a certain type. These fields can also be passed as filters when using [SDK subscriptions](#sdk-subscriptions).+## What to read next+<Cards>- <Card title="Troubleshooting triggers" href="/docs/troubleshooting/triggers" description="Not receiving events? Check common trigger issues and how to fix them" />+ <Card icon={<ShieldCheck />} title="Verifying webhooks" href="/docs/webhook-verification" description="Validate webhook signatures to ensure payloads are authentic" />+ <Card icon={<Zap />} title="Managing triggers" href="/docs/setting-up-triggers/managing-triggers" description="List, enable, disable, and delete trigger instances" />+ <Card icon={<Zap />} title="Troubleshooting triggers" href="/docs/troubleshooting/triggers" description="Not receiving events? Check common trigger issues and how to fix them" /></Cards>diff --git a/docs/content/docs/toolkits/enable-and-disable-toolkits.mdx b/docs/content/docs/toolkits/enable-and-disable-toolkits.mdxindex 633a98b38..d89401ca0 100644--- a/docs/content/docs/toolkits/enable-and-disable-toolkits.mdx+++ b/docs/content/docs/toolkits/enable-and-disable-toolkits.mdx@@ -267,3 +267,9 @@ const session = await composio.create("user_123", {</Tab></Tabs>+## What to read next++<Cards>+ <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" />+</Cards>+diff --git a/docs/content/docs/toolkits/fetching-tools-and-toolkits.mdx b/docs/content/docs/toolkits/fetching-tools-and-toolkits.mdxindex 5bc0c7f51..fcfa48848 100644--- a/docs/content/docs/toolkits/fetching-tools-and-toolkits.mdx+++ b/docs/content/docs/toolkits/fetching-tools-and-toolkits.mdx@@ -172,3 +172,9 @@ console.log(tool.outputParameters);```</Tab></Tabs>++## What to read next++<Cards>+ <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" />+</Cards>diff --git a/docs/content/docs/white-labeling-authentication.mdx b/docs/content/docs/white-labeling-authentication.mdxindex fec5feb66..02f107524 100644--- a/docs/content/docs/white-labeling-authentication.mdx+++ b/docs/content/docs/white-labeling-authentication.mdx@@ -155,3 +155,9 @@ export default function handler(req: NextApiRequest, res: NextApiResponse) {3. Update your auth config in the Composio dashboard to use your custom redirect URI.This makes the OAuth flow go through your domain first, then to Composio for token storage.++## What to read next++<Cards>+ <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" />+</Cards>