---
title: "Set or remove one op-desk preference"
method: PUT
path: "/api/v0/desk/preferences/{key}"
tags: ["Desk"]
---

# Set or remove one op-desk preference

`PUT /api/v0/desk/preferences/{key}`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/desk/preferences/{key}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/desk/preferences/:key/put.ts> (a function with typed inputs; its response is checked against the schema)

Writes one key and leaves every other one as stored, so two tabs writing different keys both land. Answers every preference after the write.

## Path parameters

- `key` string, required

## Request body

- DeskPreferenceWriteRequest: The key's new value. ``null`` removes the key.
  - `value` unknown

## Response `200`

Successful Response

- DeskPreferencesResponse
  - `preferences` object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `07854361a13b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/desk/preferences/:key/put.md)

---

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