# Delete a user

Deactivates a specific user identified by the user ID.

Endpoint: DELETE /scim/v2/Users/{id}
Version: 2026-02-20
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    The ID of the user to delete.

## Header parameters:

  - `Idempotency-Key` (string, required)
    Unique key used to ensure idempotent behavior.

  - `Accept-Encoding` (string)
    Indicates the response's preferred content encoding. Supported values are gzip and identity.

  - `Content-Encoding` (string)
    This header is returned if you specify the Accept-Encoding: gzip request header and the response contains over 1000 bytes of data.

## Response 200 fields (application/json):

  - `id` (string)
    The unique identifier for the user resource.

  - `userName` (string)
    The unique username of the user.

  - `displayName` (string)
    The display name of the user, used for user interfaces and profile views.

  - `active` (boolean)
    Indicates whether the user account is active (true) or inactive (false).

  - `emails` (array)

  - `emails.value` (string)
    The email address associated with the user.

  - `emails.primary` (boolean)
    Indicates whether this email address is the primary one for the user.

  - `meta` (object)

  - `meta.resourceType` (string)
    The type of the resource, e.g., 'User'.

  - `meta.created` (string)
    The date and time when the user resource was created.

  - `meta.lastModified` (string)
    The date and time when the user resource was last modified.

## Response 401 fields (application/json):

  - `success` (boolean)
    Indicates whether the request was successful. For a 401 Unauthorized response, this will be false.

  - `reasons` (array)

  - `reasons.message` (string)
    A message describing the reason for the authorization failure.
    Example: "Unauthorized"

  - `reasons.code` (string)
    An application-specific error code indicating the nature of the authorization issue.
    Example: "90000011"

## Response 403 fields (application/json):

  - `timestamp` (string)
    The date and time when the error occurred, in ISO 8601 format.
    Example: "2023-07-28T10:47:07.931Z"

  - `status` (integer)
    The HTTP status code for the response. For a 403 Forbidden response, this will be 403.
    Example: 403

  - `error` (string)
    A short, general description of the error.
    Example: "Forbidden"

  - `message` (string)
    A detailed message explaining why access is forbidden, such as lack of permissions.
    Example: "Admin access denied"

  - `path` (string)
    The request path that triggered the error.
    Example: "/scim/v2/Users/123"