21
Starting from Python SDK v0.9.0 and TypeScript SDK v0.2.0, specifying versions is required for manual tool execution.
22
</Callout>
23
24
+## Default version behavior
25
+
26
+<Callout type="warn">
27
+When no version is specified, the API defaults to the base version (`00000000_00`), **not** the latest version. This means the response may contain fewer tools than what's shown on the [platform UI](https://platform.composio.dev). To get all available tools including ones added in newer versions, explicitly set `toolkit_versions` to `"latest"` or a specific version.
28
+</Callout>
29
+
30
+This applies to both the SDK and direct REST API calls:
31
+
32
+```bash
33
+# Without version — returns only tools from the base version
34
+curl 'https://backend.composio.dev/api/v3/tools?toolkit_slug=googledrive' \
35
+ -H 'x-api-key: YOUR_API_KEY'
36
+
37
+# With version=latest — returns all tools including newer ones
38
+curl 'https://backend.composio.dev/api/v3/tools?toolkit_slug=googledrive&toolkit_versions=latest' \
39
+ -H 'x-api-key: YOUR_API_KEY'
40
+```
41
+
42
## Configuration methods
43
44
Configure toolkit versions using one of three methods:
136
- `NN`: Sequential release number
137
138
```python
121
-# Production
139
+# Production — pin to a specific version
140
toolkit_versions = {"github": "20251027_00"}
141
124
-# Development
142
+# Development — always use the newest tools
143
toolkit_versions = {"github": "latest"}
144
```
145
146
<Callout type="warn">
129
-Never use `latest` in production. It can introduce breaking changes.
147
+Never use `latest` in production. It can introduce breaking changes. Pin to a specific version instead.
148
+</Callout>
149
+
150
+<Callout type="info">
151
+If you omit `toolkit_versions` entirely, the API uses the base version (`00000000_00`). This is the oldest version and may not include all tools available for a toolkit. Always specify a version explicitly.
152
</Callout>
153
154
## Version resolution order