Skip to main content
Murph user preferences are scoped to the authenticated user. They control the default language for new Murph conversations and expose display preferences the UI can use when formatting Murph surfaces.
These endpoints are available only when Murph is enabled for the caller’s customer account.

​
Get preferences

GET /api/v2/murph/user-preferences Returns the caller’s current Murph preferences. If the request is authenticated with a service token instead of a user session, the endpoint returns the same shape with all preference fields set to null.
curl
curl https://api.interchange.io/api/v2/murph/user-preferences \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Response

{
  "preferredLanguage": "de",
  "locale": "de-DE",
  "timezone": "Europe/Berlin",
  "displayCurrency": "EUR"
}
FieldTypeNotes
preferredLanguageenum | nullUser-level default language for new Murph conversations. null means Murph auto-detects language
localestring | nullBCP-47 display locale, such as en-US, de-DE, or ja-JP
timezonestring | nullIANA timezone, such as America/New_York or Europe/Berlin
displayCurrencystring | nullISO 4217 currency code used for display formatting, such as USD, EUR, or JPY

​
Set default language

PUT /api/v2/murph/user-preferences/language Sets the caller’s user-level default Murph language. New conversations inherit this value at creation time. Existing conversations keep their own language override unless you update them separately. Send preferredLanguage: null to clear the user default and return new conversations to auto-detect.
curl
curl -X PUT https://api.interchange.io/api/v2/murph/user-preferences/language \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "preferredLanguage": "fr"
  }'

​
Request body

FieldTypeRequiredNotes
preferredLanguageenum | nullYesSupported Murph language code, or null to clear the default

​
Response

{
  "preferredLanguage": "fr",
  "locale": "fr-FR",
  "timezone": null,
  "displayCurrency": null
}
The response returns the full preference object now in effect.

​
Supported languages

CodeLanguage
enEnglish
deGerman
frFrench
esSpanish
ptPortuguese
itItalian
nlDutch
svSwedish
plPolish
jaJapanese
koKorean
zhChinese, Simplified
arArabic
hiHindi
trTurkish

​
Errors

  • 400 VALIDATION_ERROR — invalid request body, unsupported language code, invalid locale, invalid timezone, or invalid currency.
  • 400 BAD_REQUEST — setting a user-level default was attempted from a non-user auth context.
  • 401 UNAUTHORIZED — missing or invalid bearer token.
  • 403 FORBIDDEN — Murph is not enabled for the caller’s account.
See Errors for the full error contract.

Ask Murph

How storefront operators use Murph in the platform.

Murph confirmations

Confirmation flows for Murph actions that need approval.