---
title: "Remove users from organization"
method: DELETE
path: "/rest/servicedeskapi/organization/{organizationId}/user"
tags: ["Organization"]
---

# Remove users from organization

`DELETE /rest/servicedeskapi/organization/{organizationId}/user`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/servicedeskapi/organization/{organizationId}/user`
- Auth: OAuth 2
  - Authorization code: `https://auth.atlassian.com/authorize`
  - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:servicedesk-customer`

This method removes users from an organization.

**[Permissions](#permissions) required**: Service desk administrator or agent. Note: Permission to delete users from an organization can be switched to users with the Jira administrator permission, using the **[Organization management](https://confluence.atlassian.com/servicedeskcloud/setting-up-service-desk-users-732528877.html#Settingupservicedeskusers-manageorgsManageorganizations)** feature.

## Path parameters

- `organizationId` integer, required

## Request body

- UsersOrganizationUpdateDTO
  - `accountIds` string[]: List of customers, specific by account IDs, to add to or remove from the organization.
  - `organizationId` integer: The organizationId in which users need to be added
  - `usernames` string[]: This property is no longer available and will be removed from the documentation soon. See the [deprecation notice](https://developer.atlassian.com/cloud/jira/platform/deprecation-notice-user-privacy-api-migration-guide/) for details. Use `accountIds` instead.

## Response `204`

The request completed successfully. No additional content will be sent in the response.

## Other responses

- `400`: Returned if one or more user names are invalid.
- `401`: Returned if the user is not logged in.
- `403`: Returned if the user does not have permission to complete this request.
- `404`: Returned if the organization does not exist.
- `500`: Internal Server Error.

## Changes

> 20 revisions in range; 3 not diffed.

- **2024-02-08** `7c79c3ffe305`: 1 info
  - added the new optional request property `organizationId`

[Operation history](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/changes/rest/servicedeskapi/organization/:organizationId/user/delete.md)

---

[API](https://skmtc.dev/atlassian/apis/service-management-public-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/revisions/fe02b1260fc7?raw)