Skip to Content
WalidoDocs
Public APIGroups

Delete a group

DELETE
/groups/{group_id}

Permanently deletes the group and all contacts, knowledge items, forwardings, glossary entries, or pronunciation rules it contains. Knowledge chunks are also removed. This operation is not reversible.

Fails with 409 conflict if the group is assigned to an assistant or is the organization's last group of that type.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the Walido dashboard (Settings → API Keys).

Path Parameters

group_id*string
Match^[a-f0-9]{24}$

Response Body

Deleted.

application/json
  1. response
data?

Empty - present for envelope consistency.

Example Request
curl -X DELETE 'https://api.walido.it/api/v1/groups/65f8fa6f1a9d8e0012ab34cd'
Example Response
{  "data": {}}