---
title: "Remove user from organization"
method: DELETE
path: "/users/{userId}"
tags: ["users"]
---

# Remove user from organization

`DELETE /users/{userId}`

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](/api/smartsheet/openapi/users/remove-user-from-plan).

**If you have <a href="https://help.smartsheet.com/articles/2482433-Enterprise-plan-manager-overview" target="_blank" rel="noopener noreferrer">Enterprise Plan Manager</a> 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.

## Query parameters

- `removeFromSharing` boolean
- `transferSheets` boolean
- `transferTo` integer

## Response `200`

Returns the result object.

- GenericResult
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation

## Other responses

- `400` — This can be caused by the following situations: - You attempted to remove your plan's main contact. Example response: ```json { "errorCode": 5687, "message": "This person is the main contact for your plan and can't be removed.", "refId": "abcd1234" } ``` - You cannot remove directory integration-managed users. Example response: ```json { "errorCode": 5666, "message": "This person is managed from your directory service. Please delete them through your directory service instead.", "refId": "abcd1234" } ``` - The user owns groups but you didn't set the `transferTo` parameter. Example response: ```json { "errorCode": 1121, "message": "transferTo must be provided because user being deleted owns one or more groups.", "refId": "abcd1234" } ``` - You cannot transfer to the user to be removed. Example response: ```json { "errorCode": 1018, "message": "The value '{userId}' was not valid for the parameter 'transferTo'.", "refId": "abcd1234" } ``` - The transfer recipient user cannot be found. Example response: ```json { "errorCode": 1019, "message": "Cannot transfer to the user specified. User not found.", "refId": "abcd1234" } ``` - You cannot transfer to a user in a different organization. Example response: ```json { "errorCode": 1021, "message": "Cannot transfer to the user specified. They are not a member of your account.", "refId": "abcd1234" } ``` - The user to be removed owns groups but the transfer recipient is not a <a href="https://help.smartsheet.com/articles/520100-user-types" target="_blank" rel="noopener noreferrer">Group Admin</a>. Example response: ```json { "errorCode": 1107, "message": "User specified in transferGroupsTo must be a group admin.", "refId": "abcd1234" } ``` - The asset transfer size exceeds the threshold. Example response: ```json { "errorCode": 5737, "message": "Sorry we could not complete this transfer ownership request at this time. Contact support@smartsheet.com", "refId": "abcd1234" }
- `403` — This can be caused by the following situations: - You are not a System Admin. Example response: ```json { "errorCode": 1004, "message": "You are not authorized to perform this action.", "refId": "abcd1234" } ``` - The user is not in your organization and the user is not internal to your User Subscription Model plan. Example response: ```json { "errorCode": 1004, "message": "You are not authorized to perform this action.", "refId": "abcd1234" } ```
- `404` — This can be caused by the following situations: - The user is not in your organization and you're on a Legacy Collaborator Model plan. Example response: ```json { "errorCode": 1020, "message": "User not found.", "refId": "abcd1234" } ``` - No user account found (invalid user ID). Example response: ```json { "errorCode": 1020, "message": "User not found.", "refId": "abcd1234" } ```
- `default` — Generic Error Payload

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)