Manage Applications

    Delete user

    delete
    https://api.box.com/2.0
    /users/:user_id

    Deletes a user. By default this will fail if the user still owns any content. Move their owned content first before proceeding, or use the force field to delete the user and their files.

    Request

    application/json

    Path Parameters

    stringin pathrequired
    12345

    The ID of the user.

    Query Parameters

    booleanin queryoptional
    true

    Whether the user should be deleted even if this user still own files

    booleanin queryoptional
    true

    Whether the user will receive email notification of the deletion

    Response

    none

    Removes the user and returns an empty response.

    You can now try out some of our APIs live, right here in the documentation.
    Log In

    Request Example

    cURL
    curl -X DELETE https://api.box.com/2.0/users/12345 \
         -H "Authorization: Bearer <ACCESS_TOKEN>"
    .NET
    await client.UsersManager.DeleteEnterpriseUserAsync("44444", notify: false, force: true);
    Java
    BoxUser user = new BoxUser(api, "0");
    user.delete(false, false);
    Python
    user_id = '33333'
    client.user(user_id).delete(force=True)
    Node
    // Delete the user even if they still have files in their account
    client.users.delete('123', {force: true})
        .then(() => {
            // deletion succeeded — no value returned
        });