Delete a User Group

Delete an existing user group.

HTTP Request

DELETE/api/users/groups/:id

Authorization

Authorization

• Required: Yes
• Permission: Staff or Admin
• Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the user group to delete

Example Requests

🐍 Python

1import requests
2
3response = requests.delete('http://www.example.com/api/users/groups/123', 
4  headers={'Authorization': 'Token <your_api_key>'}
5)
6print(response.status_code)  # Should be 204 for successful deletion

🌐 Curl

1curl -X DELETE "http://www.example.com/api/users/groups/123" -H "Authorization: Token <your_api_key>"'

Status Codes

Code	Description
204	User group deleted successfully
401	Unauthorized — authentication required
403	Forbidden — insufficient permissions
404	Not found — user group does not exist
500	Internal server error

Response Fields

Field	Type	Description
None	None	No response body returned