---
title: "Changes to Get required scopes for tools"
method: POST
path: "/api/v3.1/tools/scopes/required"
---

# Changes to Get required scopes for tools

`POST /api/v3.1/tools/scopes/required`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 61 revisions.

- **2026-07-22** `c039e97e7f14` — 3 info
- **2026-07-16** `b61c29327d74` — 1 breaking, 2 info
- **2026-06-17** `589a7d115a5e` — 2 info
- **2026-05-05** `52c71f747c65` — 1 info

## Changes

- **2026-07-22** `c039e97e7f14` — 3 info
  - added the optional property `per_tool_requirements/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/anyOf[subschema #2]/source` to the response with the `200` status
  - added the optional property `per_tool_requirements/items/scope_requirements/all_of/items/anyOf[subschema #2]/source` to the response with the `200` status
  - added the optional property `per_tool_requirements/items/scope_requirements/source` to the response with the `200` status
- **2026-07-16** `b61c29327d74` — 1 breaking, 2 info
  - the `per_tool_requirements/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/` response's property type/format changed from `string`/`` to ``/`` for status `200`
  - added the optional property `per_tool_requirements/items/scope_requirements/all_of/items/anyOf[subschema #2]/when` to the response with the `200` status
  - added `subschema #1, subschema #2` to the `per_tool_requirements/items/scope_requirements/all_of/items/anyOf[subschema #2]/any_of/items/` response property `anyOf` list for the response status `200`
- **2026-06-17** `589a7d115a5e` — 2 info
  - the endpoint scheme security `CookieAuth` was removed from the API
  - the endpoint scheme security `UserApiKeyAuth` was removed from the API
- **2026-05-05** `52c71f747c65` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/composiohq/apis/composio-platform-api-v3-1/docs/api/v3.1/tools/scopes/required/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/tools/scopes/required/post)