A beta version of the new Box developer documentation site is launching soon! Updated Developer Guides, modern API Reference, and AI-powered search are on the way to help you build with Box faster. Stay tuned for more updates.
Delete user
Deletes a user. By default, this operation fails if the user
still owns any content, was recently active, or recently joined the enterprise from a free account.
To proceed, move their owned content first, or use the force parameter to delete
the user and their files.
Request
Path Parameters
12345The ID of the user.
Query Parameters
trueSpecifies whether to delete the user even if they still own files, were recently active, or recently joined the enterprise from a free account.
trueWhether the user will receive email notification of the deletion.
Response
Removes the user and returns an empty response.
An unexpected client error.
Request Example
curl -i -X DELETE "https://api.box.com/2.0/users/12345" \
-H "authorization: Bearer <ACCESS_TOKEN>"await client.users.deleteUserById(user.id);client.users.delete_user_by_id(user.id)await client.Users.DeleteUserByIdAsync(userId: user.Id);try await client.users.deleteUserById(userId: user.id)client.getUsers().deleteUserById(user.getId())BoxUser user = new BoxUser(api, "0");
user.delete(false, false);user_id = '33333'
client.user(user_id).delete(force=True)await client.UsersManager.DeleteEnterpriseUserAsync("44444", notify: false, force: true);// Delete the user even if they still have files in their account
client.users.delete('123', {force: true})
.then(() => {
// deletion succeeded — no value returned
});