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: fix remaining broken links and validate dynamic toolkit pages

Sushmithamallesha7634a32234b
diff --git a/docs/content/cookbooks/fast-api.mdx b/docs/content/cookbooks/fast-api.mdx
index 14353d9ae..365233f6b 100644
--- a/docs/content/cookbooks/fast-api.mdx
+++ b/docs/content/cookbooks/fast-api.mdx
@@ -199,8 +199,6 @@ A Composio client dependency.
"""
```
-Check [dependencies](./simple_gmail_agent/server/dependencies.py) module for more details.
-
### Invoke agent via FastAPI
When invoking an agent, make sure you validate the `user_id`.
@@ -265,18 +263,10 @@ def _run_gmail_agent(
return result
```
-<Callout>
-Check [server](./simple_gmail_agent/server/) module for service implementation
-</Callout>
-
## Putting everything together
So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a FastAPI service. Now let's run the service.
-<Callout>
-Before proceeding, check the [code](./simple_gmail_agent/server/api.py) for utility endpoints not discussed in the cookbook
-</Callout>
-
1. Clone the repository
```bash
diff --git a/docs/content/cookbooks/hono.mdx b/docs/content/cookbooks/hono.mdx
index 344b67a54..a1891bad8 100644
--- a/docs/content/cookbooks/hono.mdx
+++ b/docs/content/cookbooks/hono.mdx
@@ -215,8 +215,6 @@ export function provideComposioClient(): Composio<OpenAIProvider> {
export type ComposioClient = Composio<OpenAIProvider>;
```
-Check [config/composio.ts](./src/config/composio.ts) module for more details.
-
### Invoke agent via Hono
When invoking an agent, make sure you validate the `user_id`.
@@ -290,18 +288,10 @@ app.post("/agent", async (c) => {
});
```
-<Callout>
- Check [src/api.ts](./src/api.ts) module for service implementation
-</Callout>
-
## Putting everything together
So far, we have created an agent with ability to interact with `gmail` using the `composio` SDK, functions to manage connected accounts for users and a Hono service. Now let's run the service.
-<Callout>
- Before proceeding, check the [code](./src/api.ts) for utility endpoints not discussed in the cookbook
-</Callout>
-
1. Clone the repository
```bash
git clone [email protected]:composiohq/composio-hono
diff --git a/docs/content/docs/troubleshooting/sdks.mdx b/docs/content/docs/troubleshooting/sdks.mdx
index 627189113..cd7f7e221 100644
--- a/docs/content/docs/troubleshooting/sdks.mdx
+++ b/docs/content/docs/troubleshooting/sdks.mdx
@@ -48,7 +48,7 @@ Check current version:
## Common issues
- **Type errors or parameter confusion**: Search [DeepWiki](https://deepwiki.com/ComposioHQ/composio) or use the Ask AI assistant
-- **Tool-specific issues**: Check the [specific tool's documentation](/docs/tools-and-toolkits)
+- **Tool-specific issues**: Check the [specific tool's documentation](/toolkits)
- **Bug reporting**: Create a [GitHub issue](https://github.com/ComposioHQ/composio/issues/new?labels=bug) with debug logs and reproduction steps
## Getting help
diff --git a/docs/content/docs/troubleshooting/tools.mdx b/docs/content/docs/troubleshooting/tools.mdx
index ac2ef7808..b6d9bc535 100644
--- a/docs/content/docs/troubleshooting/tools.mdx
+++ b/docs/content/docs/troubleshooting/tools.mdx
@@ -33,7 +33,7 @@ Verify the connected account has necessary permissions:
## Tool not working
-- Check [tool-specific documentation](/docs/tools-and-toolkits) for requirements
+- Check [tool-specific documentation](/toolkits) for requirements
- Verify the connected account is active and properly authenticated
- Test with the latest SDK version
diff --git a/docs/content/reference/errors.mdx b/docs/content/reference/errors.mdx
index c3b79b63b..802991bfe 100644
--- a/docs/content/reference/errors.mdx
+++ b/docs/content/reference/errors.mdx
@@ -68,7 +68,7 @@ Errors that occur when fetching or executing tools.
| Error | Cause |
|-------|-------|
| Tool not found | The tool slug doesn't exist. Tool slugs are case-sensitive and use `SCREAMING_SNAKE_CASE`. |
-| No connected account | The user hasn't connected to this toolkit yet. See [Authenticating Users](/docs/authenticating-users/manually-authenticating). |
+| No connected account | The user hasn't connected to this toolkit yet. |
| Tool execution failed | The external service returned an error. Check tool parameters and user permissions. |
<Callout>
diff --git a/docs/scripts/validate-links.ts b/docs/scripts/validate-links.ts
index fa41d1886..665385e0d 100644
--- a/docs/scripts/validate-links.ts
+++ b/docs/scripts/validate-links.ts
@@ -86,13 +86,20 @@ async function buildPopulateEntries(src: AnySource) {
);
}
+async function getDynamicToolkitEntries() {
+ const raw = await readFile('public/data/toolkits.json', 'utf-8');
+ const toolkits: { slug: string }[] = JSON.parse(raw);
+ return toolkits.map((t) => ({ value: { slug: [t.slug] }, hashes: [] as string[] }));
+}
+
async function checkLinks() {
const referenceSource = await getReferenceSource();
- const [docsEntries, refEntries, cookbookEntries, toolkitEntries] = await Promise.all([
+ const [docsEntries, refEntries, cookbookEntries, toolkitEntries, dynamicToolkitEntries] = await Promise.all([
buildPopulateEntries(source),
buildPopulateEntries(referenceSource),
buildPopulateEntries(cookbooksSource),
buildPopulateEntries(toolkitsSource),
+ getDynamicToolkitEntries(),
]);
const scanned = await scanURLs({
@@ -102,7 +109,7 @@ async function checkLinks() {
'(home)/docs/[[...slug]]': docsEntries,
'(home)/reference/[[...slug]]': refEntries,
'(home)/cookbooks/[[...slug]]': cookbookEntries,
- '(home)/toolkits/[[...slug]]': toolkitEntries,
+ '(home)/toolkits/[[...slug]]': [...toolkitEntries, ...dynamicToolkitEntries],
},
});