> ## 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.

# Delete user

> Deprovisions a user from the authenticated organization.

The exact effect depends on the user's membership type:
- **Internal user, single-org**: removes all organization memberships and deletes the identity.
- **Internal user, multi-org (same SSO customer group)**: removes only the membership in this organization; the identity and other memberships are preserved.
- **External user**: removes only the membership in this organization.

Bot identities and the last owner of an organization cannot be deleted.

Returns `204 No Content` on success.




## OpenAPI

````yaml /openapi/phrase-platform.json delete /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}:
    delete:
      tags:
        - SCIM
      summary: Delete user
      description: >
        Deprovisions a user from the authenticated organization.


        The exact effect depends on the user's membership type:

        - **Internal user, single-org**: removes all organization memberships
        and deletes the identity.

        - **Internal user, multi-org (same SSO customer group)**: removes only
        the membership in this organization; the identity and other memberships
        are preserved.

        - **External user**: removes only the membership in this organization.


        Bot identities and the last owner of an organization cannot be deleted.


        Returns `204 No Content` on success.
      operationId: deleteScimUser
      parameters:
        - name: userUid
          in: path
          description: Phrase Platform identity UID of the user
          required: true
          schema:
            type: string
      responses:
        '204':
          description: User deprovisioned successfully — no content returned
        '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'
        '422':
          description: >-
            Unprocessable entity — bot identity, last organization owner, or
            identity not managed by this organization
          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:
    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
  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.

````