MCP Gateway
ApiSettings

Update user preferences

Update current user's UI preferences. Supports partial updates. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

PUT
/api/v1/settings/preferences

Authorization

User API Key
AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

access_token?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X PUT "https://loading/api/v1/settings/preferences" \  -H "Content-Type: application/json" \  -d '{}'
{
  "theme": "string",
  "default_page": "string",
  "locale": "string",
  "items_per_page": 0
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Update notification settings

Update the current user's notification preferences. Supports partial updates - only provided fields are changed. This is an API-only endpoint for programmatic access — no frontend UI currently consumes it.

Complete setup with API key (no OAuth)

Create the first owner user and generate an API key. Only available when no users exist and setup has not been completed. Does NOT support recovery token bypass.