Save or update user settings

Save or update specific user settings. This returns a confirmation and the saved setting, which can be useful for verifying the change or for subsequent calls where the setting key is used.

Account & Settings Preferences

Context

Workflow links

Produces

key → data.key

POST /api/domain-preferences

Related endpoints

GET /api/preferences Get user settings

Headers

Accept Example

Content-Type Example

Body

required

application/json

category string required · Example: ui

key string required · Example: timezone

value string | boolean · enum required · Example: Europe/Stockholm

America/Guatemala

America/Sao_Paulo

Europe/Berlin

Europe/Moscow

Europe/Paris

Europe/Stockholm

Responses

200

data object required

data.category string required · Example: ui

data.key string required · Example: timezone

data.message string required · Example: Preference saved successfully

Human-readable message.

data.value string | boolean · enum required · Example: Europe/Stockholm

America/Guatemala

America/Sao_Paulo

Europe/Berlin

Europe/Moscow

Europe/Paris

Europe/Stockholm

requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

POST https://cloud.hostup.se/api/preferences

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/preferences" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "timezone",
    "value": "Europe/Stockholm",
    "category": "ui"
  }'

Response

{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "message": "Preference saved successfully",
    "key": "timezone",
    "value": "Europe/Stockholm",
    "category": "ui"
  }
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string"
        },
        "key": {
          "type": "string"
        },
        "message": {
          "type": "string",
          "description": "Human-readable message."
        },
        "value": {
          "type": "string | boolean",
          "enum": [
            "America/Guatemala",
            "America/Sao_Paulo",
            "Europe/Berlin",
            "Europe/Moscow",
            "Europe/Paris",
            "Europe/Stockholm"
          ]
        }
      }
    },
    "requestId": {
      "type": "string",
      "description": "Unique request identifier (UUID)."
    },
    "success": {
      "type": "boolean",
      "description": "True for successful responses."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO 8601 timestamp (UTC)."
    }
  }
}

Request Body Example 1

{
  "key": "timezone",
  "value": "Europe/Stockholm",
  "category": "ui"
}