---
title: "Set preference value"
method: PUT
path: "/api/v1/storage/preferences/{key}"
tags: ["storage"]
---

# Set preference value

`PUT /api/v1/storage/preferences/{key}`

Creates or updates a preference entry.

## Path parameters

- `key` string, required

## Request body

- PreferenceSetRequest — unresolved $ref

## Response `200`

Preference set.

- PreferenceEntry — unresolved $ref

## Other responses

- `500` — Internal server error.
- `501` — Capability not implemented by the connected backend.

## Changes

- **2026-08-17** `dcf9b09e550f` — 1 info
  - added the non-success response with the status `501`

[Change history](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/changes/api/v1/storage/preferences/:key/put.md)

---

[API](https://skmtc.dev/dotnet/apis/devflow-agent-protocol.md) · [All operations](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotnet/devflow-agent-protocol/revisions/31dec8eed3de/schema)