Skip to content

Set or clear the authenticated workspace user's personal interface locale.

PUT
/api/workspace/account/preferred-locale
curl --request PUT \
--url https://example.com/api/workspace/account/preferred-locale \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "PreferredLocale": "example" }'

The personal locale applies to the user’s later requests: localized validation and business messages and Work Inbox texts. A null or empty value follows the workspace locale again.

access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

Request payload to set or clear the personal interface locale of the authenticated workspace account.

object
PreferredLocale

Locale code en, uk, de, pl or es; null or empty follows the workspace locale.

string
nullable
Examplegenerated
{
"PreferredLocale": "example"
}

OK

Media typeapplication/json
object
Data

Profile fields for the authenticated workspace account.

object
UserId

Workspace user identifier.

string
nullable
UserName

Exact stored Unicode login name.

string
nullable
Email

Optional email address.

string
nullable
FirstName

First name.

string
nullable
LastName

Last name.

string
nullable
DisplayName

Canonical effective display name.

string
nullable
UserType
integer format: int32
Allowed values: 0 1 2
Avatar

Avatar presentation values for a workspace user.

object
Initials

Initials derived from the user name.

string
nullable
BackgroundColor

Hex color for the avatar background.

string
nullable
TextColor

Hex color for the avatar text.

string
nullable
PreferredLocale

Personal interface locale code (en, uk, de, pl or es); null follows the workspace locale.

string
nullable
HasLocalPassword

Whether the account has a local password that can be changed with the current password.

boolean
NamesManagedByWorker

Whether first and last name are managed by the associated Worker and are read-only here.

boolean
ExternalIdentityProviderName

Display name of the identity provider that manages email and names, or null for a local account.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"UserType": 0
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Profile fields for the authenticated workspace account.

object
UserId

Workspace user identifier.

string
nullable
UserName

Exact stored Unicode login name.

string
nullable
Email

Optional email address.

string
nullable
FirstName

First name.

string
nullable
LastName

Last name.

string
nullable
DisplayName

Canonical effective display name.

string
nullable
UserType
integer format: int32
Allowed values: 0 1 2
Avatar

Avatar presentation values for a workspace user.

object
Initials

Initials derived from the user name.

string
nullable
BackgroundColor

Hex color for the avatar background.

string
nullable
TextColor

Hex color for the avatar text.

string
nullable
PreferredLocale

Personal interface locale code (en, uk, de, pl or es); null follows the workspace locale.

string
nullable
HasLocalPassword

Whether the account has a local password that can be changed with the current password.

boolean
NamesManagedByWorker

Whether first and last name are managed by the associated Worker and are read-only here.

boolean
ExternalIdentityProviderName

Display name of the identity provider that manages email and names, or null for a local account.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"UserType": 0
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/json
object
Data

Profile fields for the authenticated workspace account.

object
UserId

Workspace user identifier.

string
nullable
UserName

Exact stored Unicode login name.

string
nullable
Email

Optional email address.

string
nullable
FirstName

First name.

string
nullable
LastName

Last name.

string
nullable
DisplayName

Canonical effective display name.

string
nullable
UserType
integer format: int32
Allowed values: 0 1 2
Avatar

Avatar presentation values for a workspace user.

object
Initials

Initials derived from the user name.

string
nullable
BackgroundColor

Hex color for the avatar background.

string
nullable
TextColor

Hex color for the avatar text.

string
nullable
PreferredLocale

Personal interface locale code (en, uk, de, pl or es); null follows the workspace locale.

string
nullable
HasLocalPassword

Whether the account has a local password that can be changed with the current password.

boolean
NamesManagedByWorker

Whether first and last name are managed by the associated Worker and are read-only here.

boolean
ExternalIdentityProviderName

Display name of the identity provider that manages email and names, or null for a local account.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"UserType": 0
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}