---
title: "PATCH /user/provider-preferences"
method: PATCH
path: "/user/provider-preferences"
---

# PATCH /user/provider-preferences

`PATCH /user/provider-preferences`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/user/provider-preferences`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Update provider preferences for the current user session

## Request body

- ProviderPreferencesUpdateRequest
  - `preferredProviders` string[]: Ordered list of preferred providers
  - `excludedProviders` string[]: Providers that should never be used
  - `enableFallback` boolean: Whether to fall back to the platform default if no preferred provider is available
  - `modelOverrides` object: Per-model overrides for provider selection preferences

## Response `200`

Updated provider preference settings

- ProviderPreferencesResponse
  - `preferredProviders` string[]: Ordered list of preferred providers
  - `excludedProviders` string[]: Providers that should never be used
  - `enableFallback` boolean: Whether to fall back to the platform default if no preferred provider is available
  - `modelOverrides` object: Per-model overrides for provider selection preferences
  - `availableProviders` string[]: Provider IDs available to the current user for the model

## Other responses

- `400`: Bad Request - Invalid exclusions or no usable providers
- `422`: Unprocessable Entity - Invalid payload

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/user/provider-preferences/patch.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)