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 production warning placement, remove duplicate info, restore gitleaks ignores

Devin AI98351ab68ca7
diff --git a/.gitleaksignore b/.gitleaksignore
index 8d2947eed..0b571c148 100644
--- a/.gitleaksignore
+++ b/.gitleaksignore
@@ -1,2 +1,8 @@
# Decimal chat widget public config JWT (not a secret - contains allowed domains only)
docs/app/layout.tsx:jwt
+
+# Documentation curl examples with placeholder API keys (not real secrets)
+cadbd463fddb5b31c901d2c222b73354b6d87327:docs/content/docs/common-faq.mdx:curl-auth-header:99
+cadbd463fddb5b31c901d2c222b73354b6d87327:docs/content/docs/troubleshooting/tools.mdx:curl-auth-header:43
+cadbd463fddb5b31c901d2c222b73354b6d87327:docs/content/docs/tools-direct/toolkit-versioning.mdx:curl-auth-header:34
+cadbd463fddb5b31c901d2c222b73354b6d87327:docs/content/docs/tools-direct/toolkit-versioning.mdx:curl-auth-header:38
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdx
index 8764352a2..3b897d5c4 100644
--- a/docs/content/docs/common-faq.mdx
+++ b/docs/content/docs/common-faq.mdx
@@ -112,7 +112,7 @@ curl 'https://backend.composio.dev/api/v3/tools?toolkit_slug=googledrive&toolkit
-H 'x-api-key: YOUR_API_KEY'
```
-For production use, pin to a specific version instead of `latest` to avoid breaking changes. See [Toolkit versioning](/docs/tools-direct/toolkit-versioning).
+See [Toolkit versioning](/docs/tools-direct/toolkit-versioning) for more details.
</Accordion>
<Accordion title="Can a user connect multiple accounts for the same app?">
diff --git a/docs/content/docs/tools-direct/fetching-tools.mdx b/docs/content/docs/tools-direct/fetching-tools.mdx
index bb937a650..89233b99e 100644
--- a/docs/content/docs/tools-direct/fetching-tools.mdx
+++ b/docs/content/docs/tools-direct/fetching-tools.mdx
@@ -239,7 +239,7 @@ const toolkitSearchRaw = await composio.tools.getRawComposioTools({
</Tabs>
<Callout type="warn">
-When no toolkit version is specified, the API returns tools from the base version (`00000000_00`), which may be fewer than what's available. Pass `toolkit_versions="latest"` or a specific version to get all tools. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).
+When no toolkit version is specified, the API returns tools from the base version (`00000000_00`), which may be fewer than what's available. Pass `toolkit_versions="latest"` or a specific version to get all tools. Never use `latest` in production. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).
</Callout>
## What to read next
diff --git a/docs/content/docs/tools-direct/toolkit-versioning.mdx b/docs/content/docs/tools-direct/toolkit-versioning.mdx
index 3d2bf616f..13d64811e 100644
--- a/docs/content/docs/tools-direct/toolkit-versioning.mdx
+++ b/docs/content/docs/tools-direct/toolkit-versioning.mdx
@@ -143,8 +143,8 @@ toolkit_versions = {"github": "20251027_00"}
toolkit_versions = {"github": "latest"}
```
-<Callout type="info">
-If you omit `toolkit_versions` entirely, the API uses the base version (`00000000_00`). This is the oldest version and may not include all tools available for a toolkit. Always specify a version explicitly.
+<Callout type="warn">
+Never use `latest` in production. It can introduce breaking changes. Pin to a specific version instead.
</Callout>
## Version resolution order
diff --git a/docs/content/docs/troubleshooting/tools.mdx b/docs/content/docs/troubleshooting/tools.mdx
index eddd42eb7..f4e6970c8 100644
--- a/docs/content/docs/troubleshooting/tools.mdx
+++ b/docs/content/docs/troubleshooting/tools.mdx
@@ -44,7 +44,7 @@ curl 'https://backend.composio.dev/api/v3/tools?toolkit_slug=googledrive&toolkit
-H 'x-api-key: YOUR_API_KEY'
```
-For production use, pin to a specific version instead of `latest`. See [Toolkit versioning](/docs/tools-direct/toolkit-versioning).
+See [Toolkit versioning](/docs/tools-direct/toolkit-versioning) for more details.
## Tool not working