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

# Update Tool Policy

`POST /v1/tool/policy`

Set the input_policy and/or output_policy for a tool (global), or block for a specific team/key (override).

Parameters:
- tool_name: str - The tool to update
- input_policy: optional - "trusted" | "untrusted" | "blocked"
- output_policy: optional - "trusted" | "untrusted"
- team_id: optional - if set, create/update override for this team only
- key_hash: optional - if set, create/update override for this key only

## Request body

- ToolPolicyUpdateRequest
  - `tool_name` string, required
  - `input_policy` 'trusted' | 'untrusted' | 'blocked', nullable
  - `output_policy` 'trusted' | 'untrusted', nullable
  - `team_id` string, nullable
  - `key_hash` string, nullable
  - `key_alias` string, nullable

## Response `200`

Successful Response

- ToolPolicyUpdateResponse
  - `tool_name` string, required
  - `input_policy` 'trusted' | 'untrusted' | 'blocked', nullable
  - `output_policy` 'trusted' | 'untrusted', nullable
  - `updated` boolean, required
  - `team_id` string, nullable
  - `key_hash` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/79928a3d37d3/schema)