Skip to main content
DELETE
/
v1
/
groups
/
{groupId}
Delete a group
curl --request DELETE \
  --url https://api.prod.getdex.com/v1/groups/{groupId} \
  --header 'Authorization: Bearer <token>'
{
  "error": true,
  "message": "<string>"
}

​
Use cases

  • Remove a group that is no longer needed
  • Clean up empty or unused groups
  • Delete a group as part of a reorganization
Deleting a group does not delete the contacts in it. The contacts remain in your account and can still be found in other groups or the main contact list.

Authorizations

​
Authorization
string
header
required

Use your Dex API key (e.g. dex_abc123...) as the Bearer token.

Path Parameters

​
groupId
string<uuid>
required

Response

Successful response

​
error
boolean
required
​
message
string
required