Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
fix: add GET /tools to affected endpoints, add version parameter column
GET /tools uses toolkit_versions param which also defaults differently between v3 and v3.1. Added a column showing which parameter controls the version for each endpoint. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Zen Agent <zen@composio.dev>
rahul.lingala committed
Apr 8, 2026 at 13:02 UTC
0f889376dc679597429b3294dc519994a9dca0ac
1 file changed
+9
-8
docs/content/changelog/04-08-26-v31-api.mdx
+9
-8
@@ -12,14 +12,15 @@ In API v3 (`/api/v3/tools/*`), tool-related endpoints default the `version` para
12
13
In API v3.1 (`/api/v3.1/tools/*`), the default is flipped: **tool-related endpoints default to the latest toolkit version**. If you're already passing `version: "latest"` in your requests, switching to v3.1 changes nothing for you. If you were relying on the `00000000_00` default, you'll now get the latest version unless you explicitly pin.
14
15
-**Affected tool endpoints (those with a `version` parameter):**
16
-
17
-| Endpoint | v3 Default Version | v3.1 Default Version |
18
-|----------|-------------------|---------------------|
19
-| `GET /tools/{tool_slug}` | `00000000_00` | `latest` |
20
-| `POST /tools/execute/{tool_slug}` | `00000000_00` | `latest` |
21
-| `POST /tools/execute/{tool_slug}/input` | `00000000_00` | `latest` |
22
-| `POST /tools/scopes/required` | `00000000_00` | `latest` |
15
+**Affected tool endpoints (those with a version parameter):**
16
+
17
+| Endpoint | Version Parameter | v3 Default | v3.1 Default |
18
+|----------|------------------|------------|--------------|
19
+| `GET /tools` | `toolkit_versions` (query) | `00000000_00` | `latest` |
20
+| `GET /tools/{tool_slug}` | `version` (query) | `00000000_00` | `latest` |
21
+| `POST /tools/execute/{tool_slug}` | `version` (body) | `00000000_00` | `latest` |
22
+| `POST /tools/execute/{tool_slug}/input` | `version` (body) | `00000000_00` | `latest` |
23
+| `POST /tools/scopes/required` | `version` (body) | `00000000_00` | `latest` |
24
25
### All Other Endpoints Are Unchanged
26