Delete a Recipient Group
Permanently deletes a group. The recipients within the group are not deleted — they remain in the dock’s catalog.
DELETE /v1/docks/:dockId/groups/:id
Path Parameters
| Parameter | Type | Description |
|---|
dockId | string | The dock ID |
id | string | The group ID |
Example Request
curl -X DELETE https://api.docyard.io/v1/docks/dock_01HQ3K.../groups/grp_01HQ3R... \
-H "Authorization: Bearer dk_live_a1b2c3d4..."
Response
Error Handling
| Status | Condition |
|---|
401 | Missing or invalid API key |
404 | Group or dock not found |
Policies assigned to the group are not automatically re-assigned. Review affected policies after deleting a group.