Sign in

v63

latestOpenAPI 3.0.0Proprietaryraw.githubusercontent.com2026-08-0110571.8 MB
Tools

Get required scopes for tools

Resolves required scopes for the specified tools at a given toolkit version. All requested tools must belong to the same toolkit. Returns the flat scope union plus per-tool structured scope requirements when available.

post/api/v3.1/tools/scopes/required

Request body

toolsstring[] required

Tool slugs to resolve scopes for. All tools must belong to the same toolkit.

versionstring

Toolkit version to resolve scopes against for the requested toolkit. Defaults to the pinned HTTP version when omitted.

Example request

{
  "tools": [
    "GMAIL_FETCH_EMAILS",
    "GMAIL_SEND_EMAIL"
  ],
  "version": "latest"
}

Response

Successfully retrieved scopes for the specified tools

scopes_requiredstring[] required

A combined list of all unique scopes required by the specified tools

Example response

{
  "scopes_required": [
    "channels:read",
    "chat:write",
    "https://www.googleapis.com/auth/gmail.modify",
    "repo",
    "user:email"
  ]
}