---
title: "Delete Policy"
method: DELETE
path: "/v1/routing/policies/{name}"
tags: ["routing"]
---

# Delete Policy

`DELETE /v1/routing/policies/{name}`

Delete a stored policy in one scope.

## Path parameters

- `name` string, required

## Query parameters

- `user_id` string, nullable — Delete the policy scoped to this user. Omit to delete the workspace-wide one.
- `workspace_id` string, uuid, nullable — Delete the policy in this workspace. Omit for the deployment's default workspace.

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-25** `daef1d31b5d1` — 1 info
  - added the new optional `query` request parameter `workspace_id`
- **2026-08-05** `00866b0c5407` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mozilla-ai/apis/otari/changes/v1/routing/policies/:name/delete.md)

---

[API](https://skmtc.dev/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.dev/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc.dev/mozilla-ai/apis/otari/revisions/80c117c36f36?raw)