---
title: "Set Tool Access"
method: PUT
path: "/waldo/tools/{tool_name}/access"
tags: ["Waldo"]
---

# Set Tool Access

`PUT /waldo/tools/{tool_name}/access`

## Request

- Base URL: `https://api.cloud.wherobots.com`
- URL: `https://api.cloud.wherobots.com/waldo/tools/{tool_name}/access`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Set what Waldo does when it calls the tool: run it, ask, or refuse.

## Path parameters

- `tool_name` string, required

## Request body

- SetToolAccess
  - `access` 'allow' | 'ask' | 'deny', required

## Response `204`

Successful Response

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `500`: Internal Server Error

## Changes

- **2026-10-31** `54fa857fb12d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/changes/waldo/tools/:tool_name/access/put.md)

---

[API](https://skmtc.dev/wherobots/apis/wherobots-cloud-api.md) - [All operations](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wherobots/apis/wherobots-cloud-api/revisions/54fa857fb12d?raw)