> ## Documentation Index
> Fetch the complete documentation index at: https://developers.phrase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update user

> Partially updates a user's attributes using SCIM PATCH operations (RFC 7644 Section 3.5.2).

Only the `replace` operation is supported. Supported target paths:
- `active`
- `externalId`
- `userName`
- `name.givenName`
- `name.familyName`
- `name` (complex object)
- `emails` (complex array)
- `emails[type eq "work"].value`

When `path` is omitted, the value must be an object whose fields are merged into the user resource.

Returns `204 No Content` on success.




## OpenAPI

````yaml /openapi/phrase-platform.json patch /scim/Users/{userUid}
openapi: 3.0.0
info:
  title: Phrase Platform API
  description: |
    ### Phrase Platform related API.
  version: 1.0.0
  termsOfService: https://phrase.com/terms/
  contact:
    url: https://phrase.com
servers:
  - url: https://eu.phrase.com/idm/
    description: The API server for EU data center.
  - url: https://us.phrase.com/idm/
    description: The API server for US data center.
security: []
tags:
  - name: OAuth
    description: OAuth Protocol
  - name: SCIM
    description: >-
      System for Cross-domain Identity Management (RFC 7643, RFC 7644). Enables
      automated user provisioning and deprovisioning from an identity provider
      (IdP).
paths:
  /scim/Users/{userUid}:
    patch:
      tags:
        - SCIM
      summary: Update user
      description: >
        Partially updates a user's attributes using SCIM PATCH operations (RFC
        7644 Section 3.5.2).


        Only the `replace` operation is supported. Supported target paths:

        - `active`

        - `externalId`

        - `userName`

        - `name.givenName`

        - `name.familyName`

        - `name` (complex object)

        - `emails` (complex array)

        - `emails[type eq "work"].value`


        When `path` is omitted, the value must be an object whose fields are
        merged into the user resource.


        Returns `204 No Content` on success.
      operationId: patchScimUser
      parameters:
        - name: userUid
          in: path
          description: Phrase Platform identity UID of the user
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/scim+json:
            schema:
              $ref: '#/components/schemas/ScimPatchRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ScimPatchRequest'
      responses:
        '204':
          description: User updated successfully — no content returned
        '400':
          description: >-
            Bad request — unsupported operation, unsupported path, or malformed
            body
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
        '401':
          description: Unauthorized — missing or invalid token
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
        '404':
          description: User not found or does not belong to the authenticated organization
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
        '409':
          description: Conflict — userName already in use by another identity
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
        '422':
          description: Unprocessable entity — business rule violation
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
        '500':
          description: Internal server error
          content:
            application/scim+json:
              schema:
                $ref: '#/components/schemas/ScimError'
      security:
        - scimToken: []
components:
  schemas:
    ScimPatchRequest:
      description: SCIM PATCH request body (RFC 7644 Section 3.5.2)
      type: object
      required:
        - Operations
      properties:
        schemas:
          description: SCIM schema URNs
          type: array
          items:
            type: string
          example:
            - urn:ietf:params:scim:api:messages:2.0:PatchOp
        Operations:
          description: List of PATCH operations to apply
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/ScimPatchOperation'
    ScimError:
      description: SCIM error response (RFC 7644 Section 3.12)
      type: object
      properties:
        schemas:
          type: array
          items:
            type: string
          example:
            - urn:ietf:params:scim:api:messages:2.0:Error
        status:
          description: HTTP status code as a string
          type: string
        scimType:
          description: >-
            SCIM error keyword (RFC 7644 Section 3.12), e.g. `invalidFilter`,
            `invalidValue`, `uniqueness`
          type: string
        detail:
          description: Human-readable error description
          type: string
    ScimPatchOperation:
      description: A single PATCH operation. Only the `replace` operation is supported.
      type: object
      required:
        - op
      properties:
        op:
          description: >-
            Operation type. Only `replace` is supported; `add` and `remove` are
            rejected.
          type: string
          enum:
            - replace
        path:
          description: >-
            Attribute path to update. When omitted, `value` must be an object
            whose fields are merged into the user. Supported paths: `active`,
            `externalId`, `userName`, `name.givenName`, `name.familyName`,
            `name`, `emails`, `emails[type eq "work"].value`.
          type: string
        value:
          description: >-
            New value for the attribute. Type depends on the target path
            (string, boolean, object, or array).
  securitySchemes:
    scimToken:
      type: http
      scheme: bearer
      description: >-
        SCIM access token issued via Phrase Platform organization settings. The
        Bearer token value must be configured in Phrase Platform SCIM section.

````