Update preferences
PUT
/v1/me/preferences
Change the signed-in user's saved preferences: default destination language, default export format, time zone, notification channels, and display currency. This is a partial update — any field you leave out keeps its current value.
Authorizations
Bearer
JWT bearer token from POST /v1/auth/login.
Type
HTTP (bearer)
or
ApiKey
Scoped API key for non-interactive clients (issued by PBI #1426).
Type
API Key (header: X-Api-Key)
Request Body
application/json
Request body for editing the signed-in user's preferences (PBI #1359). Every field is optional — a
null means "leave this preference unchanged", so a client can patch one toggle without
resending the rest.
The language new projects translate into by default; null leaves it unchanged.
The currency code used to display monetary amounts; null leaves it unchanged.
Whether to send email notifications; null leaves it unchanged.
Whether to show in-app notifications; null leaves it unchanged.
The Projects-list page size (items per page); null leaves it unchanged (#2471).
Format
"int32"Pattern
"^-?(?:0|[1-9]\\d*)$"The IANA time zone id used to present dates in the UI; null leaves it unchanged.
Responses
OK
application/json
The signed-in user's profile, preferences, and avatar state — the shared success body for
GET /me, PUT /me, and PUT /me/preferences.
When the avatar was last changed, or null when no
avatar is set.
Format
"date-time"When the account was created, or null if the account
record could not be loaded (a valid token whose account row is gone).
Format
"date-time"The account's editable display name.
The account's email address.
Whether the account's email address has been verified.
Whether the account has an uploaded avatar image.
Whether the account has a password set (false for an
OAuth-only account that signs in only with Google/Apple). Lets the Account Security UI (#2127) hide the
change-password / change-email forms an OAuth-only user can't use, rather than surfacing a
password_not_set error after they submit.
Stable identifier for this account.
Format
"uuid"The account's display name, kept alongside string? MeView.DisplayName for
backward compatibility with older callers.
The account's saved application preferences.