# Remove user from organization

Removes the user from your organization.

> Who can use this operation?
>
> Permissions: System Admin

> Important: To remove a user from your plan, refer to Remove user from plan.

If you have Enterprise Plan Manager enabled, this endpoint removes the user from organizations that inherit from your organization.

If you're managing users via an external source, such as an identity provider (IdP) or directory integration (DI) provider, you must use that source to remove users. Okta and Azure AD are examples of external sources.

Endpoint: DELETE /users/{userId}
Version: 2.0.0
Security: APIToken, OAuth2

## Header parameters:

  - `Authorization` (string)
    API Access Token used to authenticate requests to Smartsheet APIs.

  - `smartsheet-integration-source` (string)
    Uses the following metadata to distinguish between human-initiated API requests and third-party service-initiated calls by AI Connectors or ITSM:

- Integration source type
- Organization name
- Integration source name 

Format:


TYPE,OrgName,SourceName


Examples: 

AI,SampleOrg,My-AI-Connector-v2

SCRIPT,SampleOrg2,Accounting-updater-script

APPLICATION,SampleOrg3,SheetUpdater
    Example: "AI,SampleOrg,My-AI-Connector-v2"

## Path parameters:

  - `userId` (number, required)
    ID of the user being accessed.

## Query parameters:

  - `removeFromSharing` (boolean)
    Set this to true to remove the user's access to all assets in your organization and plan.

  - `transferSheets` (boolean)
    If you want to transfer ownership of all the removed user's assets and groups to a qualified user\*, set this parameter to true and set the transferTo parameter to the ID of the qualified user. The transfer depends on setting the transferTo parameter.

> Warning: If your asset transfer size exceeds 38k, the transfer fails with a 400 error that prompts you to contact Support for guidance.

\* The receiving user must be a Group Admin of the group(s) to be transferred.

  - `transferTo` (integer)
    Set this to the ID of a qualified user\* to receive ownership of all groups the removed user owns.

Also if you set the transferSheets parameter to true, the operation additionally transfers ownership of all the removed user's assets to the assigned user.

\* The receiving user must be a Group Admin of the groups.

## Response 200 fields (application/json):

  - `message` (string)
    Message that indicates the outcome of the request. (One of SUCCESS or PARTIAL_SUCCESS.)
    Enum: "PARTIAL_SUCCESS", "SUCCESS"

  - `resultCode` (number)
    * '0' Success
* '3' Partial Success of Bulk Operation
    Enum: 0, 3

## Response default fields (application/json):

  - `refId` (string)
    The ID of the specific error occurrence. Please include this information when contacting Smartsheet support.

  - `errorCode` (number)
    Custom error code from Smartsheet. See the complete [Error Code List](/api/smartsheet/error-codes).

  - `message` (string)
    Descriptive error message.


## Response 400 fields

## Response 403 fields

## Response 404 fields