{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-patch-admin-user-data-schema.json",
  "title": "PatchAdminUserData",
  "description": "Partial admin-only user update payload.\nAll fields are optional. Omitted fields remain unchanged.\nOnly one logical change category may be sent per request: profile/preferences fields, `role`, or `tier`. `marketingEmailConsent` is read-only and cannot be changed through this payload. The canonical account email is read-only.\n",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-user-account-api-openapi.yml#/components/schemas/PatchAdminUserData",
  "type": "object",
  "properties": {
    "firstName": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "New first name (truncated to 64 Unicode characters)."
    },
    "lastName": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "New last name (truncated to 64 Unicode characters)."
    },
    "language": {
      "allOf": [
        {
          "$ref": "#/$defs/LanguageData"
        }
      ],
      "description": "New preferred language."
    },
    "currency": {
      "allOf": [
        {
          "$ref": "#/$defs/CurrencyData"
        }
      ],
      "description": "New preferred currency."
    },
    "measurementUnit": {
      "allOf": [
        {
          "$ref": "#/$defs/MeasurementUnitData"
        }
      ],
      "description": "New preferred measurement unit system."
    },
    "showUnassessedOrSensitiveContent": {
      "type": "boolean",
      "description": "Omit to leave unchanged. Send `true` to show unassessed or sensitive content; send `false` to hide it. `null` is invalid."
    },
    "tier": {
      "allOf": [
        {
          "$ref": "#/$defs/UserTierData"
        }
      ],
      "description": "Omit to leave unchanged. Null is invalid."
    },
    "role": {
      "allOf": [
        {
          "$ref": "#/$defs/UserRoleData"
        }
      ],
      "description": "Omit to leave unchanged. Null is invalid."
    }
  },
  "$defs": {
    "CurrencyData": {
      "type": "string",
      "enum": [
        "EUR",
        "GBP",
        "USD",
        "AUD",
        "CAD",
        "NZD",
        "CNY",
        "BRL",
        "PLN",
        "TRY",
        "JPY",
        "CZK",
        "RUB",
        "AED",
        "SAR",
        "HKD",
        "SGD",
        "CHF",
        "ZAR",
        "SEK",
        "DKK",
        "NOK",
        "KRW",
        "INR",
        "TWD",
        "HUF",
        "RON",
        "MXN",
        "THB",
        "ARS"
      ],
      "description": "Supported currencies (ISO 4217 codes):\n- EUR: Euro\n- GBP: British Pound\n- USD: US Dollar\n- AUD: Australian Dollar\n- CAD: Canadian Dollar\n- NZD: New Zealand Dollar\n- CNY: Chinese Yuan\n- BRL: Brazilian Real\n- PLN: Polish Złoty\n- TRY: Turkish Lira\n- JPY: Japanese Yen\n- CZK: Czech Koruna\n- RUB: Russian Ruble\n- AED: UAE Dirham\n- SAR: Saudi Riyal\n- HKD: Hong Kong Dollar\n- SGD: Singapore Dollar\n- CHF: Swiss Franc\n- ZAR: South African Rand\n- SEK: Swedish Krona\n- DKK: Danish Krone\n- NOK: Norwegian Krone\n- KRW: South Korean Won\n- INR: Indian Rupee\n- TWD: New Taiwan Dollar\n- HUF: Hungarian Forint\n- RON: Romanian Leu\n- MXN: Mexican Peso\n- THB: Thai Baht\n- ARS: Argentine Peso (2 minor-unit decimal places)\n",
      "default": "EUR"
    },
    "LanguageData": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "fr",
        "es",
        "it",
        "zh",
        "pt",
        "pl",
        "tr",
        "nl",
        "cs",
        "ja",
        "ru",
        "ar"
      ],
      "description": "Supported language codes (ISO 639-1 canonical values):\n- de: German (includes de-DE, de-AT, de-CH, de-LU, de-LI)\n- en: English (includes en-US, en-GB, en-AU, en-CA, en-NZ, and backend-specific accepted alias en_IE)\n- fr: French (includes fr-FR, fr-CA, fr-BE, fr-CH, fr-LU)\n- es: Spanish (includes es-ES, es-MX, es-AR, es-CO, es-CL, es-PE, es-VE)\n- it: Italian (includes it-IT, it-CH)\n- zh: Chinese (Simplified) (includes zh-CN, zh-Hans)\n- pt: Portuguese (includes pt-PT, pt-BR)\n- pl: Polish (includes pl-PL)\n- tr: Turkish (includes tr-TR)\n- nl: Dutch (includes nl-NL, nl-BE)\n- cs: Czech (includes cs-CZ)\n- ja: Japanese (includes ja-JP)\n- ru: Russian (includes ru-RU)\n- ar: Arabic (includes ar-SA, ar-EG, ar-AE)\n\n`de`, `en`, `fr`, `es`, and `it` are fully supported localization/translation-target languages.\n`zh`, `pt`, `pl`, `tr`, `nl`, `cs`, `ja`, `ru`, and `ar` are ingestion-only languages:\nthey can appear in stored/native content and are accepted anywhere `LanguageData` is used,\nbut backend-generated translations and fallback localized strings are not produced in these languages.\n",
      "default": "en"
    },
    "MeasurementUnitData": {
      "type": "string",
      "enum": [
        "METRIC",
        "IMPERIAL"
      ],
      "description": "User preference for distance/size presentation:\n- METRIC: Metric units.\n- IMPERIAL: Imperial units.\n",
      "default": "METRIC"
    },
    "UserRoleData": {
      "type": "string",
      "description": "The user's role used for API authorization.\n- `USER`: Standard authenticated user.\n- `ADMIN`: Administrator with access to admin-only endpoints.\n",
      "enum": [
        "USER",
        "ADMIN"
      ]
    },
    "UserTierData": {
      "type": "string",
      "description": "The user's subscription tier, which determines limits and feature access (e.g. max watchlist entries, max search filters, allowed search filter fields).\n- `FREE`: Default tier for all users. Allows up to 20 watchlist entries, up to 1 search filter (limited to `productQuery`, `price`, `state`, `excludeProductListingId`, and `lifecycle` filter fields), and up to 10 product matches per filter.\n- `PRO`: Premium tier. Allows up to 100 watchlist entries, up to 5 search filters with access to all filter fields, and unlimited product matches per filter.\n- `ULTIMATE`: Highest tier. Allows unlimited watchlist entries, unlimited search filters with access to all filter fields, and unlimited product matches per filter.\n",
      "enum": [
        "FREE",
        "PRO",
        "ULTIMATE"
      ]
    }
  }
}