SCIM

Update user

Updates a user's attributes. Only fields explicitly provided with a non-null, non-blank value are written — omitted, null, blank, or empty-list fields keep their current values.

Updatable fields: userName, name.givenName, name.familyName, emails (primary address), externalId, locale, timezone, active.

The active field is always applied from the request body regardless of its previous value.

Bot identities and users managed externally (EXTERNAL membership) cannot be updated.

Role assignments in the request body are ignored — role updates via SCIM are not supported.

put/scim/Users/{userUid}

Request

Path parameters

userUidstring required

Phrase Platform identity UID of the user

Request body

schemasstring[]

SCIM schema URNs

externalIdstring

Identifier assigned by the provisioning client (IdP)

userNamestring required

Unique username within the Phrase Platform. Required for create; optional for replace if unchanged.

activeboolean

Whether the user account should be enabled. Ignored on create — newly provisioned users are always active regardless of this value.

localestring

User locale in IETF BCP 47 format (e.g. en-US). Falls back to the organization default when not provided or when the value does not match a supported locale.

timezonestring

User time zone in IANA Time Zone Database format (e.g. Europe/Berlin). Falls back to the organization default when not provided or when the value is not a recognized IANA timezone.

rolesunknown

Example request

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ]
}

Response

User updated successfully

schemasstring[]

SCIM schema URNs

idstring

Unique Phrase Platform identity UID, assigned by the service provider

externalIdstring

Identifier assigned by the provisioning client (IdP). Used to correlate the Phrase identity with the IdP record.

userNamestring

Unique username within the Phrase Platform

activeboolean

Whether the user account is enabled

localestring

User locale in IETF BCP 47 format (e.g. en-US)

timezonestring

User time zone in IANA Time Zone Database format (e.g. Europe/Berlin)

Example response

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "roles": [
    {
      "type": "phrase__platform",
      "value": "MEMBER"
    }
  ],
  "meta": {
    "resourceType": "User"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.