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
Sushmithamallesh committed
Oct 30, 2025 at 15:46 UTC
4ca3a4545607e9d3e0915847ea3096e1169954f5
14 files changed
+84
-140
fern/pages/src/migration-guide/index.mdx
+2
-4
@@ -6,19 +6,17 @@ keywords: "migration, upgrade, sdk, versioning"
6
hide-nav-links: false
7
---
8
9
-Find the appropriate migration guide for your use case:
10
-
9
## Available migration guides
10
11
<AccordionGroup>
12
<Accordion title="New SDK migration">
15
- Migrate from the old Composio SDK to the new next-generation SDK, including breaking changes, new features, and updated APIs.
13
+ Migrate from the old Composio SDK to the new new SDK, including breaking changes, new features, and updated APIs.
14
15
[View SDK migration guide →](/resources/migration-guide/new-sdk)
16
</Accordion>
17
18
<Accordion title="Toolkit versioning migration">
21
- Migrate to the new toolkit versioning system introduced on October 22, 2025.
19
+ Migrate to use the toolkit versioning system.
20
21
[View versioning migration guide →](/resources/migration-guide/toolkit-versioning)
22
</Accordion>
fern/pages/src/migration-guide/new-sdk.mdx
+2
-2
@@ -1,8 +1,8 @@
1
---
2
-title: New SDK migration
2
+title: Our next generation SDKs
3
subtitle: Learn more about Composio's next generation SDKs and how to migrate
4
image: "https://og.composio.dev/api/og?title=New%20SDK%20migration"
5
-keywords: 'sdk, migration, next generation, upgrade'
5
+keywords: 'sdk, migration, upgrade'
6
hide-nav-links: false
7
---
8
fern/pages/src/migration-guide/toolkit-versioning.mdx
+9
-28
@@ -2,7 +2,7 @@
2
title: Toolkit versioning migration
3
subtitle: Migrate to the new toolkit versioning system
4
image: "https://og.composio.dev/api/og?title=Toolkit%20versioning%20migration"
5
-keywords: "toolkit versioning, migration, breaking changes"
5
+keywords: "toolkit versioning, migration"
6
hide-nav-links: false
7
---
8
@@ -41,11 +41,11 @@ Choose one of three migration strategies:
41
42
<CodeGroup>
43
<SnippetCode
44
- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
44
+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
45
title="Python"
46
/>
47
<SnippetCode
48
- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
48
+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
49
title="TypeScript"
50
/>
51
</CodeGroup>
@@ -54,14 +54,14 @@ Choose one of three migration strategies:
54
55
<CodeGroup>
56
<SnippetCode
57
- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
58
- startLine={5}
59
- endLine={16}
57
+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"
58
+ startLine={6}
59
+ endLine={15}
60
title="Python"
61
/>
62
<SnippetCode
63
- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
64
- startLine={5}
63
+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
64
+ startLine={6}
65
endLine={14}
66
title="TypeScript"
67
/>
@@ -70,28 +70,9 @@ Choose one of three migration strategies:
70
#### Option 3: Use environment variables
71
72
```bash
73
-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
73
+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
74
```
75
76
-Then execute normally:
77
-
78
-<CodeGroup>
79
-```python Python
80
-result = composio.tools.execute(
81
- "GITHUB_CREATE_ISSUE",
82
- {"user_id": "user-123", "arguments": {...}}
83
-)
84
-```
85
-
86
-```typescript TypeScript
87
-const result = await composio.tools.execute({
88
- toolSlug: "GITHUB_CREATE_ISSUE",
89
- userId: "user-123",
90
- arguments: {...}
91
-});
92
-```
93
-</CodeGroup>
94
-
76
## Migration checklist
77
78
1. **Audit your code**: Find all `tools.execute()` calls in your codebase
fern/pages/src/tool-calling/toolkit-versioning.mdx
+13
-34
@@ -20,11 +20,11 @@ Configure toolkit versions using one of three methods:
20
21
<CodeGroup>
22
<SnippetCode
23
- src="fern/snippets/tool-calling/versioning/python/sdk-initialization.py"
23
+ src="fern/snippets/tool-calling/python/versioning-sdk-init.py"
24
title="Python"
25
/>
26
<SnippetCode
27
- src="fern/snippets/tool-calling/versioning/typescript/sdk-initialization.ts"
27
+ src="fern/snippets/tool-calling/typescript/versioning-sdk-init.ts"
28
title="TypeScript"
29
/>
30
</CodeGroup>
@@ -33,20 +33,20 @@ Configure toolkit versions using one of three methods:
33
34
```bash
35
# Set versions for specific toolkits
36
-export COMPOSIO_TOOLKIT_VERSION_GITHUB="20250116_00"
37
-export COMPOSIO_TOOLKIT_VERSION_SLACK="20250115_01"
38
-export COMPOSIO_TOOLKIT_VERSION_GMAIL="20250115_00"
36
+export COMPOSIO_TOOLKIT_VERSION_GITHUB="20251027_00"
37
+export COMPOSIO_TOOLKIT_VERSION_SLACK="20251027_00"
38
+export COMPOSIO_TOOLKIT_VERSION_GMAIL="20251027_00"
39
```
40
41
### Per-execution override
42
43
<CodeGroup>
44
<SnippetCode
45
- src="fern/snippets/tool-calling/versioning/python/per-execution-override.py"
45
+ src="fern/snippets/tool-calling/python/versioning-per-execution.py"
46
title="Python"
47
/>
48
<SnippetCode
49
- src="fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts"
49
+ src="fern/snippets/tool-calling/typescript/versioning-per-execution.ts"
50
title="TypeScript"
51
/>
52
</CodeGroup>
@@ -59,7 +59,7 @@ Versions follow the format `YYYYMMDD_NN`:
59
60
```python
61
# Production
62
-toolkit_versions = {"github": "20250116_00"}
62
+toolkit_versions = {"github": "20251027_00"}
63
64
# Development
65
toolkit_versions = {"github": "latest"}
@@ -77,42 +77,21 @@ Never use `latest` in production. It can introduce breaking changes.
77
78
## Managing versions
79
80
-### List available versions
81
-
82
-Check what versions are available for a toolkit:
80
+Check available versions and inspect what your tools are using:
81
82
<CodeGroup>
83
<SnippetCode
86
- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
87
- startLine={8}
84
+ src="fern/snippets/tool-calling/python/versioning-manage.py"
85
+ startLine={5}
86
endLine={11}
87
title="Python"
88
/>
89
<SnippetCode
92
- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
93
- startLine={8}
90
+ src="fern/snippets/tool-calling/typescript/versioning-manage.ts"
91
+ startLine={5}
92
endLine={12}
93
title="TypeScript"
94
/>
95
</CodeGroup>
96
99
-### Inspect current versions
100
-
101
-Check which version your tools are actually using:
102
-
103
-<CodeGroup>
104
-<SnippetCode
105
- src="fern/snippets/tool-calling/versioning/python/manage-versions.py"
106
- startLine={13}
107
- endLine={16}
108
- title="Python"
109
-/>
110
-<SnippetCode
111
- src="fern/snippets/tool-calling/versioning/typescript/manage-versions.ts"
112
- startLine={14}
113
- endLine={20}
114
- title="TypeScript"
115
-/>
116
-</CodeGroup>
117
-
97
fern/snippets/tool-calling/python/versioning-manage.py
new
+11
@@ -0,0 +1,11 @@
1
+from composio import Composio
2
+
3
+composio = Composio(api_key="YOUR_API_KEY")
4
+
5
+# Get toolkit information including available versions
6
+toolkit = composio.toolkits.get(slug="github")
7
+
8
+# Extract and print version information
9
+print(f"Toolkit: {toolkit.name}")
10
+print(f"Current Version: {toolkit.meta.version}")
11
+print(f"Available Versions: {toolkit.meta.available_versions}")
\ No newline at end of file
fern/snippets/tool-calling/python/versioning-per-execution.py
new
+15
@@ -0,0 +1,15 @@
1
+from composio import Composio
2
+
3
+composio = Composio(api_key="YOUR_API_KEY")
4
+
5
+# Specify version directly in execute call
6
+result = composio.tools.execute(
7
+ "GITHUB_LIST_STARGAZERS",
8
+ arguments={
9
+ "owner": "ComposioHQ",
10
+ "repo": "composio"
11
+ },
12
+ user_id="user-k7334",
13
+ version="20251027_00" # Override version for this execution
14
+)
15
+print(result)
\ No newline at end of file
fern/snippets/tool-calling/python/versioning-sdk-init.py
renamed
+3
-3
@@ -4,8 +4,8 @@ from composio import Composio
4
composio = Composio(
5
api_key="YOUR_API_KEY",
6
toolkit_versions={
7
- "github": "20250116_00",
8
- "slack": "20250115_01",
9
- "gmail": "20250115_00"
7
+ "github": "20251027_00",
8
+ "slack": "20251027_00",
9
+ "gmail": "20251027_00"
10
}
11
)
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-manage.ts
new
+12
@@ -0,0 +1,12 @@
1
+import { Composio } from "@composio/core";
2
+
3
+const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4
+
5
+// Get toolkit information including available versions
6
+const toolkit = await composio.toolkits.get("github");
7
+
8
+// Extract and print version information
9
+console.log("Toolkit:", toolkit.name);
10
+console.log("Current Version:", toolkit.meta.version);
11
+console.log("Available Versions:", toolkit.meta.availableVersions);
12
+console.log("Latest Version:", toolkit.meta.availableVersions[0]); // First one is usually the latest
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-per-execution.ts
new
+14
@@ -0,0 +1,14 @@
1
+import { Composio } from "@composio/core";
2
+
3
+const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4
+
5
+// Specify version directly in execute call
6
+const result = await composio.tools.execute("GITHUB_LIST_STARGAZERS", {
7
+ userId: "user-k7334",
8
+ arguments: {
9
+ owner: "ComposioHQ",
10
+ repo: "composio"
11
+ },
12
+ version: "20251027_00" // Override version for this execution
13
+});
14
+console.log(result);
\ No newline at end of file
fern/snippets/tool-calling/typescript/versioning-sdk-init.ts
renamed
+3
-3
@@ -4,8 +4,8 @@ import { Composio } from "@composio/core";
4
const composio = new Composio({
5
apiKey: "YOUR_API_KEY",
6
toolkitVersions: {
7
- github: "20250116_00",
8
- slack: "20250115_01",
9
- gmail: "20250115_00"
7
+ github: "20251027_00",
8
+ slack: "20251027_00",
9
+ gmail: "20251027_00"
10
}
11
});
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/manage-versions.py
deleted
-16
@@ -1,16 +0,0 @@
1
-from composio import Composio
2
-
3
-composio = Composio(
4
- api_key="YOUR_API_KEY",
5
- toolkit_versions={"github": "20250116_00"}
6
-)
7
-
8
-# List available versions for a toolkit
9
-versions = composio.tools.get_toolkit_versions("github")
10
-for version in versions[:3]:
11
- print(f"Version: {version['version']} - Status: {version['status']}")
12
-
13
-# Fetch tools and inspect their versions
14
-tools = composio.tools.get("user-123", toolkits=["github"])
15
-for tool in tools[:3]:
16
- print(f"{tool.slug}: v{tool.toolkit_version}")
\ No newline at end of file
fern/snippets/tool-calling/versioning/python/per-execution-override.py
deleted
-16
@@ -1,16 +0,0 @@
1
-from composio import Composio
2
-
3
-composio = Composio(api_key="YOUR_API_KEY")
4
-
5
-# Specify version directly in execute call
6
-result = composio.tools.execute(
7
- "GITHUB_CREATE_ISSUE",
8
- {
9
- "user_id": "user-123",
10
- "arguments": {
11
- "repo": "my-repo",
12
- "title": "Critical fix"
13
- },
14
- "toolkit_version": "20250116_00" # Version for this execution
15
- }
16
-)
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/manage-versions.ts
deleted
-20
@@ -1,20 +0,0 @@
1
-import { Composio } from "@composio/core";
2
-
3
-const composio = new Composio({
4
- apiKey: "YOUR_API_KEY",
5
- toolkitVersions: { github: "20250116_00" }
6
-});
7
-
8
-// List available versions for a toolkit
9
-const versions = await composio.tools.getToolkitVersions("github");
10
-versions.slice(0, 3).forEach(version => {
11
- console.log(`Version: ${version.version} - Status: ${version.status}`);
12
-});
13
-
14
-// Fetch tools and inspect their versions
15
-const tools = await composio.tools.get("user-123", {
16
- toolkits: ["github"]
17
-});
18
-tools.slice(0, 3).forEach(tool => {
19
- console.log(`${tool.slug}: v${tool.toolkitVersion}`);
20
-});
\ No newline at end of file
fern/snippets/tool-calling/versioning/typescript/per-execution-override.ts
deleted
-14
@@ -1,14 +0,0 @@
1
-import { Composio } from "@composio/core";
2
-
3
-const composio = new Composio({ apiKey: "YOUR_API_KEY" });
4
-
5
-// Specify version directly in execute call
6
-const result = await composio.tools.execute({
7
- toolSlug: "GITHUB_CREATE_ISSUE",
8
- userId: "user-123",
9
- arguments: {
10
- repo: "my-repo",
11
- title: "Critical fix"
12
- },
13
- toolkitVersion: "20250116_00" // Version for this execution
14
-});
\ No newline at end of file