---
title: "Update Tool Policy"
method: POST
path: "/v1/tool/policy"
tags: ["tool management"]
---

# Update Tool Policy

`POST /v1/tool/policy`

Set the call policy for a tool.

Parameters:
- tool_name: str - The tool to update
- call_policy: "trusted" | "untrusted" | "dual_llm" | "blocked"

Setting a tool to "blocked" will cause the ToolPolicyGuardrail to remove
that tool_call from LLM responses before returning them to the client.

## Request body

- ToolPolicyUpdateRequest
  - `tool_name` string, required
  - `call_policy` 'trusted' | 'untrusted' | 'dual_llm' | 'blocked', required

## Response `200`

Successful Response

- ToolPolicyUpdateResponse
  - `tool_name` string, required
  - `call_policy` 'trusted' | 'untrusted' | 'dual_llm' | 'blocked', required
  - `updated` boolean, required

## Other responses

- `422` — Validation Error

---

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