---
title: "Changes to Create a new tool router session"
method: POST
path: "/api/v3.1/tool_router/session"
---

# Changes to Create a new tool router session

`POST /api/v3.1/tool_router/session`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 61 revisions.

- **2026-06-17** `589a7d115a5e` — 1 info
- **2026-05-06** `6ccbbc3d49b9` — 3 breaking, 5 info
- **2026-05-05** `5a3709be76a7` — 1 breaking, 7 info
- **2026-05-05** `52c71f747c65` — 1 info

## Changes

- **2026-06-17** `589a7d115a5e` — 1 info
  - the endpoint scheme security `UserApiKeyAuth` was removed from the API
- **2026-05-06** `6ccbbc3d49b9` — 3 breaking, 5 info
  - the `connected_accounts/additionalProperties/` request property's minItems was increased to `1`
  - the `connected_accounts/additionalProperties/` request property type/format changed from `string`/`connectedAccountId` to `array`/``
  - the `config/connected_accounts/additionalProperties/` response's property type/format changed from `string`/`connectedAccountId` to `array`/`` for status `201`
  - the endpoint scheme security `CookieAuth` was removed from the API
  - added the new optional request property `experimental/custom_toolkits/items/preload`
  - added the new optional request property `experimental/custom_toolkits/items/tools/items/preload`
  - added the new optional request property `experimental/custom_tools/items/preload`
  - added the new optional request property `experimental/link_url_overwrite`
- **2026-05-05** `5a3709be76a7` — 1 breaking, 7 info
  - response property `config/preload/tools` list-of-types was widened by adding types `string` to media type `application/json` of response `201`
  - added the new optional request property `execute`
  - added the new optional request property `search`
  - added the new `ask_always` enum value to the request property `experimental/permissions/overrides/additionalProperties/`
  - added the new `ask_once` enum value to the request property `experimental/permissions/overrides/additionalProperties/`
  - request property `preload/tools` list-of-types was widened by adding types `string` to media type `application/json`
  - added the required property `config/execute` to the response with the `201` status
  - added the required property `config/search` to the response with the `201` status
- **2026-05-05** `52c71f747c65` — 1 info
  - endpoint added

---

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