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 Jhunjhunwala committed
Aug 10, 2026 at 12:46 UTC
84aea2674fd5afab2b55058f1740bbde991f8429
2 files changed
+15
-2
docs/content/docs/tools-direct/fetching-tools.mdx
+2
-2
@@ -241,8 +241,8 @@ const toolkitSearchRaw = await composio.tools.getRawComposioTools({
241
</Tab>
242
</Tabs>
243
244
-<Callout type="warn">
245
-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).
244
+<Callout type="info">
245
+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).
246
</Callout>
247
248
## Next
docs/tests/static/content.test.ts
+13
@@ -12,6 +12,7 @@ const DOCS_DIR = join(import.meta.dir, "../../content/docs");
12
const EXAMPLES_DIR = join(import.meta.dir, "../../content/examples");
13
const CHANGELOG_DIR = join(import.meta.dir, "../../content/changelog");
14
const GOOGLE_PROVIDER_DOC = join(DOCS_DIR, "providers/google.mdx");
15
+const FETCHING_TOOLS_DOC = join(DOCS_DIR, "tools-direct/fetching-tools.mdx");
16
17
/** Recursively find all .mdx files */
18
async function findMdxFiles(dir: string): Promise<string[]> {
@@ -135,6 +136,18 @@ describe("Content - Context7 ingest rules", () => {
136
});
137
});
138
139
+describe("Content - toolkit version guidance", () => {
140
+ test("the SDK fetching guide distinguishes SDK, REST v3, and REST v3.1 defaults", async () => {
141
+ const content = await readFile(FETCHING_TOOLS_DOC, "utf-8");
142
+
143
+ expect(content).toContain("These SDK examples default to `latest`");
144
+ expect(content).toContain("v3 defaults to the pinned base version (`00000000_00`)");
145
+ expect(content).toContain("v3.1 defaults to `latest`");
146
+ expect(content).not.toMatch(/the API returns tools from the base version/i);
147
+ expect(content).not.toContain("Never use `latest` in production");
148
+ });
149
+});
150
+
151
describe("Content - changelog validation", () => {
152
test("changelog files use MM-DD-YY naming pattern", async () => {
153
let entries;