@devries-cameron20 / composio Mirror · read-only / commits / 84aea2674
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 16:00 UTC

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;