---
title: "Check Tool Requirements"
method: POST
path: "/v1/tools/requirements"
tags: ["Tools"]
---

# Check Tool Requirements

`POST /v1/tools/requirements`

Checks authorization and secret requirements for multiple tools. Optionally starts OAuth flows for unmet auth requirements.

## Request body

- SchemasToolRequirementsRequest
  - `authorize` boolean
  - `tool_names` string[]
  - `tools` SchemasToolRef[]
    - `tool_name` string, required
    - `tool_version` string
  - `user_id` string

## Response `200`

OK

- SchemasToolRequirementsResponse
  - `authorization` SchemasAuthorizationRequirementsInfo
    - `items` object
    - `met` boolean
  - `met` boolean
  - `secrets` SchemasSecretRequirementsInfo
    - `items` object
    - `met` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `415` — Unsupported Media Type
- `500` — Internal Server Error

## Changes

- **2026-03-25** `611f307f9904` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/arcadeai/apis/arcade-api/changes/v1/tools/requirements/post.md)

---

[API](https://skmtc.dev/arcadeai/apis/arcade-api.md) · [All operations](https://skmtc.dev/arcadeai/apis/arcade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcadeai/arcade-api/revisions/a509111298b2/schema)
