Skip to main content

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

ParameterTypeDescription
dockIdstringThe dock ID
idstringThe 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

{ "success": true }

Error Handling

StatusCondition
401Missing or invalid API key
404Group or dock not found
Policies assigned to the group are not automatically re-assigned. Review affected policies after deleting a group.