---
title: "Update User Preferences"
method: PATCH
path: "/api/v1/users/preferences"
tags: ["Users"]
---

# Update User Preferences

`PATCH /api/v1/users/preferences`

Update user preferences.

Validates both the MCP tool-call timeout and the optional custom
queue-wait window. When the MCP timeout is lowered, any previously
stored custom wait window is auto-clamped down to fit the new ceiling
so the resolved value never exceeds 60% of the session timeout.

## Request body

- UpdatePreferencesRequest
  - `mcp_timeout_seconds` integer, nullable
  - `queue_wait_custom` boolean, nullable
  - `queue_wait_seconds` integer, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/humwork/apis/humwork-ai.md) · [All operations](https://skmtc.dev/humwork/apis/humwork-ai/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humwork/humwork-ai/revisions/38d9dc5f27e6/schema)