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: clarify toolkit version defaults

Kshitij Jhunjhunwala84aea2674fd5
diff --git a/docs/content/docs/tools-direct/fetching-tools.mdx b/docs/content/docs/tools-direct/fetching-tools.mdx
index 3470ff1d5..0c2ee3f0a 100644
--- a/docs/content/docs/tools-direct/fetching-tools.mdx
+++ b/docs/content/docs/tools-direct/fetching-tools.mdx
@@ -241,8 +241,8 @@ const toolkitSearchRaw = await composio.tools.getRawComposioTools({
</Tab>
</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. Never use `latest` in production. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).
+<Callout type="info">
+These SDK examples default to `latest` when `toolkit_versions` is omitted. For direct REST calls, omission depends on the API version: v3 defaults to the pinned base version (`00000000_00`), while v3.1 defaults to `latest`. Use `latest` when an LLM consumes tool output; pin a dated version when application code parses the output. See [toolkit versioning](/docs/tools-direct/toolkit-versioning).
</Callout>
## Next
diff --git a/docs/tests/static/content.test.ts b/docs/tests/static/content.test.ts
index f525f348b..6d416693c 100644
--- a/docs/tests/static/content.test.ts
+++ b/docs/tests/static/content.test.ts
@@ -12,6 +12,7 @@ const DOCS_DIR = join(import.meta.dir, "../../content/docs");
const EXAMPLES_DIR = join(import.meta.dir, "../../content/examples");
const CHANGELOG_DIR = join(import.meta.dir, "../../content/changelog");
const GOOGLE_PROVIDER_DOC = join(DOCS_DIR, "providers/google.mdx");
+const FETCHING_TOOLS_DOC = join(DOCS_DIR, "tools-direct/fetching-tools.mdx");
/** Recursively find all .mdx files */
async function findMdxFiles(dir: string): Promise<string[]> {
@@ -135,6 +136,18 @@ describe("Content - Context7 ingest rules", () => {
});
});
+describe("Content - toolkit version guidance", () => {
+ test("the SDK fetching guide distinguishes SDK, REST v3, and REST v3.1 defaults", async () => {
+ const content = await readFile(FETCHING_TOOLS_DOC, "utf-8");
+
+ expect(content).toContain("These SDK examples default to `latest`");
+ expect(content).toContain("v3 defaults to the pinned base version (`00000000_00`)");
+ expect(content).toContain("v3.1 defaults to `latest`");
+ expect(content).not.toMatch(/the API returns tools from the base version/i);
+ expect(content).not.toContain("Never use `latest` in production");
+ });
+});
+
describe("Content - changelog validation", () => {
test("changelog files use MM-DD-YY naming pattern", async () => {
let entries;