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
- Fix /toolkits/introduction → /toolkits in troubleshooting pages - Remove broken relative links to source files in cookbooks - Remove unnecessary "See Authenticating Users" link in errors.mdx - Add dynamic toolkit slug validation from toolkits.json to link checker Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sushmithamallesh committed
Feb 17, 2026 at 20:16 UTC
a7634a32234bc13e3bc12c403a65d3eb80cd7ce0
6 files changed
+12
-25
docs/content/cookbooks/fast-api.mdx
-10
@@ -199,8 +199,6 @@ A Composio client dependency.
199
"""
200
```
201
202
-Check [dependencies](./simple_gmail_agent/server/dependencies.py) module for more details.
203
-
202
### Invoke agent via FastAPI
203
204
When invoking an agent, make sure you validate the `user_id`.
@@ -265,18 +263,10 @@ def _run_gmail_agent(
263
return result
264
```
265
268
-<Callout>
269
-Check [server](./simple_gmail_agent/server/) module for service implementation
270
-</Callout>
271
-
266
## Putting everything together
267
268
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.
269
276
-<Callout>
277
-Before proceeding, check the [code](./simple_gmail_agent/server/api.py) for utility endpoints not discussed in the cookbook
278
-</Callout>
279
-
270
271
1. Clone the repository
272
```bash
docs/content/cookbooks/hono.mdx
-10
@@ -215,8 +215,6 @@ export function provideComposioClient(): Composio<OpenAIProvider> {
215
export type ComposioClient = Composio<OpenAIProvider>;
216
```
217
218
-Check [config/composio.ts](./src/config/composio.ts) module for more details.
219
-
218
### Invoke agent via Hono
219
220
When invoking an agent, make sure you validate the `user_id`.
@@ -290,18 +288,10 @@ app.post("/agent", async (c) => {
288
});
289
```
290
293
-<Callout>
294
- Check [src/api.ts](./src/api.ts) module for service implementation
295
-</Callout>
296
-
291
## Putting everything together
292
293
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.
294
301
-<Callout>
302
- Before proceeding, check the [code](./src/api.ts) for utility endpoints not discussed in the cookbook
303
-</Callout>
304
-
295
1. Clone the repository
296
```bash
297
git clone git@github.com:composiohq/composio-hono
docs/content/docs/troubleshooting/sdks.mdx
+1
-1
@@ -48,7 +48,7 @@ Check current version:
48
## Common issues
49
50
- **Type errors or parameter confusion**: Search [DeepWiki](https://deepwiki.com/ComposioHQ/composio) or use the Ask AI assistant
51
-- **Tool-specific issues**: Check the [specific tool's documentation](/docs/tools-and-toolkits)
51
+- **Tool-specific issues**: Check the [specific tool's documentation](/toolkits)
52
- **Bug reporting**: Create a [GitHub issue](https://github.com/ComposioHQ/composio/issues/new?labels=bug) with debug logs and reproduction steps
53
54
## Getting help
docs/content/docs/troubleshooting/tools.mdx
+1
-1
@@ -33,7 +33,7 @@ Verify the connected account has necessary permissions:
33
34
## Tool not working
35
36
-- Check [tool-specific documentation](/docs/tools-and-toolkits) for requirements
36
+- Check [tool-specific documentation](/toolkits) for requirements
37
- Verify the connected account is active and properly authenticated
38
- Test with the latest SDK version
39
docs/content/reference/errors.mdx
+1
-1
@@ -68,7 +68,7 @@ Errors that occur when fetching or executing tools.
68
| Error | Cause |
69
|-------|-------|
70
| Tool not found | The tool slug doesn't exist. Tool slugs are case-sensitive and use `SCREAMING_SNAKE_CASE`. |
71
-| No connected account | The user hasn't connected to this toolkit yet. See [Authenticating Users](/docs/authenticating-users/manually-authenticating). |
71
+| No connected account | The user hasn't connected to this toolkit yet. |
72
| Tool execution failed | The external service returned an error. Check tool parameters and user permissions. |
73
74
<Callout>
docs/scripts/validate-links.ts
+9
-2
@@ -86,13 +86,20 @@ async function buildPopulateEntries(src: AnySource) {
86
);
87
}
88
89
+async function getDynamicToolkitEntries() {
90
+ const raw = await readFile('public/data/toolkits.json', 'utf-8');
91
+ const toolkits: { slug: string }[] = JSON.parse(raw);
92
+ return toolkits.map((t) => ({ value: { slug: [t.slug] }, hashes: [] as string[] }));
93
+}
94
+
95
async function checkLinks() {
96
const referenceSource = await getReferenceSource();
91
- const [docsEntries, refEntries, cookbookEntries, toolkitEntries] = await Promise.all([
97
+ const [docsEntries, refEntries, cookbookEntries, toolkitEntries, dynamicToolkitEntries] = await Promise.all([
98
buildPopulateEntries(source),
99
buildPopulateEntries(referenceSource),
100
buildPopulateEntries(cookbooksSource),
101
buildPopulateEntries(toolkitsSource),
102
+ getDynamicToolkitEntries(),
103
]);
104
105
const scanned = await scanURLs({
@@ -102,7 +109,7 @@ async function checkLinks() {
109
'(home)/docs/[[...slug]]': docsEntries,
110
'(home)/reference/[[...slug]]': refEntries,
111
'(home)/cookbooks/[[...slug]]': cookbookEntries,
105
- '(home)/toolkits/[[...slug]]': toolkitEntries,
112
+ '(home)/toolkits/[[...slug]]': [...toolkitEntries, ...dynamicToolkitEntries],
113
},
114
});
115