---
title: "Delete Org Preference"
method: DELETE
path: "/admin/preferences/organizations/{organization_id}/{definition_key}"
tags: ["admin", "preferences"]
---

# Delete Org Preference

`DELETE /admin/preferences/organizations/{organization_id}/{definition_key}`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/admin/preferences/organizations/{organization_id}/{definition_key}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Drop an org override, grading what reverting to the default does to the org.

Returns a body rather than 204 so the report has somewhere to go. Dropping
an override is an org settings edit like any other, and the default it
reverts to is as capable of blocking as the value being removed — so it is
graded like any other.

## Path parameters

- `organization_id` string, required
- `definition_key` string, required

## Headers

- `organization-id` string, nullable
- `timezone` string
- `x-user-id` string, nullable
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/upsmith/apis/upsmith-api.md) - [All operations](https://skmtc.dev/upsmith/apis/upsmith-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upsmith/apis/upsmith-api/revisions/86e2c2bd93af?raw)