Box Developer Documentation

Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

Remove group

delete
https://api.box.com/2.0
/groups/:group_id

Permanently deletes a group. Only users with admin-level permissions will be able to use this API.

Request

bearer [ACCESS_TOKEN]
application/json

Path Parameters

stringin pathrequired
57645

The ID of the group.

Response

none

A blank response is returned if the group was successfully deleted.

application/jsonClient error

An unexpected client error.

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

Request Example

cURL
curl -i -X DELETE "https://api.box.com/2.0/groups/57645" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
TypeScript Gen
await client.groups.deleteGroupById(group.id);
Python Gen
client.groups.delete_group_by_id(group.id)
.NET Gen
await client.Groups.DeleteGroupByIdAsync(groupId: group.Id);
Swift Gen (Beta)
try await client.groups.deleteGroupById(groupId: group.id)
Java
BoxGroup group = new BoxGroup(api, "id");
group.delete();
Python
client.group(group_id='11111').delete()
print('The group was deleted!')
.NET
await client.GroupsManager.DeleteAsync("11111");
Node
client.groups.delete('11111')
	.then(() => {
		// deletion succeeded — no value returned
	});
iOS
client.groups.delete(groupId: "12345") { 
(result: Result<Void, BoxSDKError>) in
    guard case .success = result else {
        print("Error deleting group")
        return
    }

    print("Group was successfully deleted.")
}