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.

Versioning docs fixes

Sushmithamallesh4ca3a4545607
diff --git a/fern/pages/src/migration-guide/index.mdx b/fern/pages/src/migration-guide/index.mdx
index c9d9d6dc7..c009a0ff4 100644
--- a/fern/pages/src/migration-guide/index.mdx
+++ b/fern/pages/src/migration-guide/index.mdx
@@ -6,19 +6,17 @@ keywords: "migration, upgrade, sdk, versioning"
hide-nav-links: false
---
-Find the appropriate migration guide for your use case:
-
## Available migration guides
<AccordionGroup>
<Accordion title="New SDK migration">
- Migrate from the old Composio SDK to the new next-generation SDK, including breaking changes, new features, and updated APIs.
+ Migrate from the old Composio SDK to the new new SDK, including breaking changes, new features, and updated APIs.
[View SDK migration guide →](/resources/migration-guide/new-sdk)
</Accordion>
<Accordion title="Toolkit versioning migration">
- Migrate to the new toolkit versioning system introduced on October 22, 2025.
+ Migrate to use the toolkit versioning system.
[View versioning migration guide →](/resources/migration-guide/toolkit-versioning)
</Accordion>
diff --git a/fern/pages/src/migration-guide/new-sdk.mdx b/fern/pages/src/migration-guide/new-sdk.mdx
index bcabf1e50..27bc068eb 100644
--- a/fern/pages/src/migration-guide/new-sdk.mdx
+++ b/fern/pages/src/migration-guide/new-sdk.mdx
@@ -1,8 +1,8 @@
---
-title: New SDK migration
+title: Our next generation SDKs
subtitle: Learn more about Composio's next generation SDKs and how to migrate
image: "https://og.composio.dev/api/og?title=New%20SDK%20migration"
-keywords: 'sdk, migration, next generation, upgrade'
+keywords: 'sdk, migration, upgrade'
hide-nav-links: false
---
diff --git a/fern/pages/src/migration-guide/toolkit-versioning.mdx b/fern/pages/src/migration-guide/toolkit-versioning.mdx
index d38f94bc1..6cab52ed9 100644
--- a/fern/pages/src/migration-guide/toolkit-versioning.mdx
+++ b/fern/pages/src/migration-guide/toolkit-versioning.mdx
@@ -2,7 +2,7 @@
title: Toolkit versioning migration
subtitle: Migrate to the new toolkit versioning system
image: "https://og.composio.dev/api/og?title=Toolkit%20versioning%20migration"
-keywords: "toolkit versioning, migration, breaking changes"
+keywords: "toolkit versioning, migration"
hide-nav-links: false
---
@@ -41,11 +41,11 @@ Choose one of three migration strategies:
<CodeGroup>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
title="Python"
/>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
title="TypeScript"
/>
</CodeGroup>
@@ -54,14 +54,14 @@ Choose one of three migration strategies:
<CodeGroup>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
- startLine={5}
- endLine={16}
+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"
+ startLine={6}
+ endLine={15}
title="Python"
/>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
- startLine={5}
+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
+ startLine={6}
endLine={14}
title="TypeScript"
/>
@@ -70,28 +70,9 @@ Choose one of three migration strategies:
#### Option 3: Use environment variables
```bash
-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
```
-Then execute normally:
-
-<CodeGroup>
-```python Python
-result = composio.tools.execute(
- "GITHUB_CREATE_ISSUE",
- {"user_id": "user-123", "arguments": {...}}
-)
-```
-
-```typescript TypeScript
-const result = await composio.tools.execute({
- toolSlug: "GITHUB_CREATE_ISSUE",
- userId: "user-123",
- arguments: {...}
-});
-```
-</CodeGroup>
-
## Migration checklist
1. **Audit your code**: Find all `tools.execute()` calls in your codebase
diff --git a/fern/pages/src/tool-calling/toolkit-versioning.mdx b/fern/pages/src/tool-calling/toolkit-versioning.mdx
index 86bb2d868..eb4677eb3 100644
--- a/fern/pages/src/tool-calling/toolkit-versioning.mdx
+++ b/fern/pages/src/tool-calling/toolkit-versioning.mdx
@@ -20,11 +20,11 @@ Configure toolkit versions using one of three methods:
<CodeGroup>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
title="Python"
/>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
title="TypeScript"
/>
</CodeGroup>
@@ -33,20 +33,20 @@ Configure toolkit versions using one of three methods:
```bash
# Set versions for specific toolkits
-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
-export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
-export COMPOSIO_TOOLKIT_VERSION_GMAIL="20250115_00"
+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
+export COMPOSIO_TOOLKIT_VERSION_SLACK="20251027_00"
+export COMPOSIO_TOOLKIT_VERSION_GMAIL="20251027_00"
```
### Per-execution override
<CodeGroup>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"
title="Python"
/>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
title="TypeScript"
/>
</CodeGroup>
@@ -59,7 +59,7 @@ Versions follow the format `YYYYMMDD_NN`:
```python
# Production
-toolkit_versions = {"github": "20250116_00"}
+toolkit_versions = {"github": "20251027_00"}
# Development
toolkit_versions = {"github": "latest"}
@@ -77,42 +77,21 @@ Never use `latest` in production. It can introduce breaking changes.
## Managing versions
-### List available versions
-
-Check what versions are available for a toolkit:
+Check available versions and inspect what your tools are using:
<CodeGroup>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
- startLine={8}
+ src="fern/snippets/tool-calling/python/versioning-manage.py"
+ startLine={5}
endLine={11}
title="Python"
/>
<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
- startLine={8}
+ src="fern/snippets/tool-calling/typescript/versioning-manage.ts"
+ startLine={5}
endLine={12}
title="TypeScript"
/>
</CodeGroup>
-### Inspect current versions
-
-Check which version your tools are actually using:
-
-<CodeGroup>
-<SnippetCode
- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
- startLine={13}
- endLine={16}
- title="Python"
-/>
-<SnippetCode
- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
- startLine={14}
- endLine={20}
- title="TypeScript"
-/>
-</CodeGroup>
-
diff --git a/fern/snippets/tool-calling/python/versioning-manage.py b/fern/snippets/tool-calling/python/versioning-manage.py
new file mode 100644
index 000000000..c661e9e6a
--- /dev/null
+++ b/fern/snippets/tool-calling/python/versioning-manage.py
@@ -0,0 +1,11 @@
+from composio import Composio
+
+composio = Composio(api_key="YOUR_API_KEY")
+
+# Get toolkit information including available versions
+toolkit = composio.toolkits.get(slug="github")
+
+# Extract and print version information
+print(f"Toolkit: {toolkit.name}")
+print(f"Current Version: {toolkit.meta.version}")
+print(f"Available Versions: {toolkit.meta.available_versions}")
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/python/versioning-per-execution.py b/fern/snippets/tool-calling/python/versioning-per-execution.py
new file mode 100644
index 000000000..2e1c64482
--- /dev/null
+++ b/fern/snippets/tool-calling/python/versioning-per-execution.py
@@ -0,0 +1,15 @@
+from composio import Composio
+
+composio = Composio(api_key="YOUR_API_KEY")
+
+# Specify version directly in execute call
+result = composio.tools.execute(
+ "GITHUB_LIST_STARGAZERS",
+ arguments={
+ "owner": "ComposioHQ",
+ "repo": "composio"
+ },
+ user_id="user-k7334",
+ version="20251027_00" # Override version for this execution
+)
+print(result)
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py b/fern/snippets/tool-calling/python/versioning-sdk-init.py
similarity index 60%
rename from fern/snippets/tool-calling/versioning/python/sdk-initialization.py
rename to fern/snippets/tool-calling/python/versioning-sdk-init.py
index a391dd09f..fc9ef0959 100644
--- a/fern/snippets/tool-calling/versioning/python/sdk-initialization.py
+++ b/fern/snippets/tool-calling/python/versioning-sdk-init.py
@@ -4,8 +4,8 @@ from composio import Composio
composio = Composio(
api_key="YOUR_API_KEY",
toolkit_versions={
- "github": "20250116_00",
- "slack": "20250115_01",
- "gmail": "20250115_00"
+ "github": "20251027_00",
+ "slack": "20251027_00",
+ "gmail": "20251027_00"
}
)
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/typescript/versioning-manage.ts b/fern/snippets/tool-calling/typescript/versioning-manage.ts
new file mode 100644
index 000000000..6bc364555
--- /dev/null
+++ b/fern/snippets/tool-calling/typescript/versioning-manage.ts
@@ -0,0 +1,12 @@
+import { Composio } from "@composio/core";
+
+const composio = new Composio({ apiKey: "YOUR_API_KEY" });
+
+// Get toolkit information including available versions
+const toolkit = await composio.toolkits.get("github");
+
+// Extract and print version information
+console.log("Toolkit:", toolkit.name);
+console.log("Current Version:", toolkit.meta.version);
+console.log("Available Versions:", toolkit.meta.availableVersions);
+console.log("Latest Version:", toolkit.meta.availableVersions[0]); // First one is usually the latest
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/typescript/versioning-per-execution.ts b/fern/snippets/tool-calling/typescript/versioning-per-execution.ts
new file mode 100644
index 000000000..ba3eab26e
--- /dev/null
+++ b/fern/snippets/tool-calling/typescript/versioning-per-execution.ts
@@ -0,0 +1,14 @@
+import { Composio } from "@composio/core";
+
+const composio = new Composio({ apiKey: "YOUR_API_KEY" });
+
+// Specify version directly in execute call
+const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {
+ userId: "user-k7334",
+ arguments: {
+ owner: "ComposioHQ",
+ repo: "composio"
+ },
+ version: "20251027_00" // Override version for this execution
+});
+console.log(result);
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts b/fern/snippets/tool-calling/typescript/versioning-sdk-init.ts
similarity index 65%
rename from fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts
rename to fern/snippets/tool-calling/typescript/versioning-sdk-init.ts
index 0e11d1f8f..f3c5e70ff 100644
--- a/fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts
+++ b/fern/snippets/tool-calling/typescript/versioning-sdk-init.ts
@@ -4,8 +4,8 @@ import { Composio } from "@composio/core";
const composio = new Composio({
apiKey: "YOUR_API_KEY",
toolkitVersions: {
- github: "20250116_00",
- slack: "20250115_01",
- gmail: "20250115_00"
+ github: "20251027_00",
+ slack: "20251027_00",
+ gmail: "20251027_00"
}
});
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/python/manage-versions.py b/fern/snippets/tool-calling/versioning/python/manage-versions.py
deleted file mode 100644
index 7b51f1be3..000000000
--- a/fern/snippets/tool-calling/versioning/python/manage-versions.py
+++ /dev/null
@@ -1,16 +0,0 @@
-from composio import Composio
-
-composio = Composio(
- api_key="YOUR_API_KEY",
- toolkit_versions={"github": "20250116_00"}
-)
-
-# List available versions for a toolkit
-versions = composio.tools.get_toolkit_versions("github")
-for version in versions[:3]:
- print(f"Version: {version['version']} - Status: {version['status']}")
-
-# Fetch tools and inspect their versions
-tools = composio.tools.get("user-123", toolkits=["github"])
-for tool in tools[:3]:
- print(f"{tool.slug}: v{tool.toolkit_version}")
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/python/per-execution-override.py b/fern/snippets/tool-calling/versioning/python/per-execution-override.py
deleted file mode 100644
index aa6658c27..000000000
--- a/fern/snippets/tool-calling/versioning/python/per-execution-override.py
+++ /dev/null
@@ -1,16 +0,0 @@
-from composio import Composio
-
-composio = Composio(api_key="YOUR_API_KEY")
-
-# Specify version directly in execute call
-result = composio.tools.execute(
- "GITHUB_CREATE_ISSUE",
- {
- "user_id": "user-123",
- "arguments": {
- "repo": "my-repo",
- "title": "Critical fix"
- },
- "toolkit_version": "20250116_00" # Version for this execution
- }
-)
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/typescript/manage-versions.ts b/fern/snippets/tool-calling/versioning/typescript/manage-versions.ts
deleted file mode 100644
index 1685fffeb..000000000
--- a/fern/snippets/tool-calling/versioning/typescript/manage-versions.ts
+++ /dev/null
@@ -1,20 +0,0 @@
-import { Composio } from "@composio/core";
-
-const composio = new Composio({
- apiKey: "YOUR_API_KEY",
- toolkitVersions: { github: "20250116_00" }
-});
-
-// List available versions for a toolkit
-const versions = await composio.tools.getToolkitVersions("github");
-versions.slice(0, 3).forEach(version => {
- console.log(`Version: ${version.version} - Status: ${version.status}`);
-});
-
-// Fetch tools and inspect their versions
-const tools = await composio.tools.get("user-123", {
- toolkits: ["github"]
-});
-tools.slice(0, 3).forEach(tool => {
- console.log(`${tool.slug}: v${tool.toolkitVersion}`);
-});
\ No newline at end of file
diff --git a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts b/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts
deleted file mode 100644
index 221017717..000000000
--- a/fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts
+++ /dev/null
@@ -1,14 +0,0 @@
-import { Composio } from "@composio/core";
-
-const composio = new Composio({ apiKey: "YOUR_API_KEY" });
-
-// Specify version directly in execute call
-const result = await composio.tools.execute({
- toolSlug: "GITHUB_CREATE_ISSUE",
- userId: "user-123",
- arguments: {
- repo: "my-repo",
- title: "Critical fix"
- },
- toolkitVersion: "20250116_00" // Version for this execution
-});
\ No newline at end of file