---
title: "Changes to Execute a tool within a tool router session"
method: POST
path: "/api/v3/tool_router/session/{session_id}/execute"
---

# Changes to Execute a tool within a tool router session

`POST /api/v3/tool_router/session/{session_id}/execute`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 52 revisions.

- **2026-10-23** `4c0752121e52`: 1 info
- **2026-10-19** `d7c19962d149`: 1 breaking, 3 info
- **2026-10-08** `0b66fbcbc714`: 4 breaking, 6 info
- **2026-10-07** `887f3a98b87b`: 5 breaking, 1 warning, 3 info
- **2026-09-30** `da0faa944f15`: 1 warning, 1 info
- **2026-09-24** `1b238f52e097`: 1 info
- **2026-09-23** `db68e3c3cf29`: 1 info
- **2026-09-15** `e27f2d779f27`: 1 info
- **2026-07-12** `73b05c1e5119`: 2 info
- **2026-05-03** `afeba73724e5`: 5 info
- **2026-03-20** `1a01eea79bb9`: 1 info
- **2026-02-12** `881fa7b9eb11`: 1 warning, 5 info

## Changes

- **2026-10-23** `4c0752121e52`: 1 info
  - the endpoint scheme security `workbench_access_key` was removed from the API
- **2026-10-19** `d7c19962d149`: 1 breaking, 3 info
  - added `#/components/schemas/ExecuteBlocked` to the response body `oneOf` list for the response status `200`
  - added `blocked` mapping keys to the response discriminator for the response status `200`
  - added the optional property `oneOf[#/components/schemas/ExecuteCompleted]/hook_results` to the response with the `200` status
  - added the optional property `oneOf[#/components/schemas/ExecuteFailed]/hook_results` to the response with the `200` status
- **2026-10-08** `0b66fbcbc714`: 4 breaking, 6 info
  - added the new required request property `input_responses/additionalProperties/action`
  - the request property `input_responses/additionalProperties/` became not nullable
  - the `input_responses/additionalProperties/` request property type changed from no type to `object`
  - added `#/components/schemas/ExecuteCompleted, #/components/schemas/ExecuteFailed, #/components/schemas/ExecuteRequiresUserInput` to the response body `oneOf` list for the response status `200`
  - added the new optional request property `input_responses/additionalProperties/content`
  - mapped value for key `completed` changed from `#/components/schemas/ToolRouterSessionExecuteCompleted` to `#/components/schemas/ExecuteCompleted` from the response discriminator for the response status `200`
  - mapped value for key `failed` changed from `#/components/schemas/ToolRouterSessionExecuteFailed` to `#/components/schemas/ExecuteFailed` from the response discriminator for the response status `200`
  - mapped value for key `input_required` changed from `#/components/schemas/ToolRouterInputRequiredResponse` to `#/components/schemas/ExecuteRequiresUserInput` from the response discriminator for the response status `200`
  - removed `#/components/schemas/ToolRouterSessionExecuteCompleted, #/components/schemas/ToolRouterSessionExecuteFailed, #/components/schemas/ToolRouterInputRequiredResponse` from the response body `oneOf` list for the response status `200`
  - added the non-success response with the status `410`
- **2026-10-07** `887f3a98b87b`: 5 breaking, 1 warning, 3 info
  - added `#/components/schemas/ToolRouterSessionExecuteCompleted, #/components/schemas/ToolRouterSessionExecuteFailed, #/components/schemas/ToolRouterInputRequiredResponse` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `data` from the response with the `200` status
  - removed the required property `error` from the response with the `200` status
  - removed the required property `log_id` from the response with the `200` status
  - removed the optional property `instant_charge` from the response with the `200` status
  - added the new optional request property `input_responses`
  - added the new optional request property `request_state`
  - added response discriminator for the response status `200`
- **2026-09-30** `da0faa944f15`: 1 warning, 1 info
  - removed the optional property `premium_charge` from the response with the `200` status
  - added the optional property `instant_charge` to the response with the `200` status
- **2026-09-24** `1b238f52e097`: 1 info
  - added the non-success response with the status `402`
- **2026-09-23** `db68e3c3cf29`: 1 info
  - added the optional property `premium_charge` to the response with the `200` status
- **2026-09-15** `e27f2d779f27`: 1 info
  - added the non-success response with the status `409`
- **2026-07-12** `73b05c1e5119`: 2 info
  - the endpoint scheme security `CookieAuth` was removed from the API
  - the endpoint scheme security `UserApiKeyAuth` was removed from the API
- **2026-05-03** `afeba73724e5`: 5 info
  - added the new optional request property `account`
  - added the new optional request property `enable_auto_workbench_offload`
  - added the non-success response with the status `413`
  - added the non-success response with the status `429`
  - added the non-success response with the status `502`
- **2026-03-20** `1a01eea79bb9`: 1 info
  - the endpoint scheme security `UserApiKeyAuth` was added to the API
- **2026-02-12** `881fa7b9eb11`: 1 warning, 5 info
  - deleted the `header` request parameter `x-session-access-key`
  - added the required property `error/slug` to the response with the `400` status
  - added the required property `error/slug` to the response with the `401` status
  - added the required property `error/slug` to the response with the `403` status
  - added the required property `error/slug` to the response with the `404` status
  - added the required property `error/slug` to the response with the `500` status

---

[Operation](https://skmtc.dev/composiohq/apis/composio-platform-api/docs/api/v3/tool_router/session/:session_id/execute/post.md) - [API](https://skmtc.dev/composiohq/apis/composio-platform-api.md) - [Page](https://skmtc.dev/composiohq/apis/composio-platform-api/changes/api/v3/tool_router/session/:session_id/execute/post)