跳到主要内容

updateMemberCulture

EmployeeFullWrapper updateMemberCulture(userId, UpdateMemberCultureRequest)

PUT /api/2.0/people/{userId}/culture

Update a user culture

Changes the interface language of a profile, which decides the language of the portal for that account and of the emails it receives. The culture has to be one the portal has enabled, otherwise the operation answers 400; read the enabled list from the portal settings rather than guessing a code. A caller may only change their own language - the ID in the route has to be the calling account, and an administrator gets 403 for anybody else - and the account must be allowed to edit its own profile. The change takes effect immediately, raises a UserUpdated webhook, and answers with the profile carrying the new cultureName. Other profile fields are not touched here; use PUT api/2.0/people/{userId} for those.

Parameters​

NameInTypeDescriptionNotes
userIdpathStringThe user ID.[required] [example: 00000000-0000-0000-0000-000000000000]
UpdateMemberCultureRequestbodyUpdateMemberCultureRequestThe culture name parameters.[optional]

Responses​

Status codeDescriptionTypeResponse headers
200The profile with its new cultureEmployeeFullWrapperX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
400The specified culture is not enabled on the portal--
403The ID in the route is not the calling account, or the account may not edit its own profile--
404No user has the specified ID--
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

EmployeeFullWrapper

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json