Delete a Recipient
Permanently removes a recipient from the dock. The recipient loses access to all artifacts governed by the dock’s policies.
DELETE /v1/docks/:dockId/recipients/:id
Path Parameters
| Parameter | Type | Description |
|---|
dockId | string | The dock ID |
id | string | The recipient ID |
Example Request
curl -X DELETE https://api.docyard.io/v1/docks/dock_01HQ3K.../recipients/rcp_01HQ3N... \
-H "Authorization: Bearer dk_live_a1b2c3d4..."
Response
Error Handling
| Status | Condition |
|---|
401 | Missing or invalid API key |
404 | Recipient or dock not found |
Deleting a recipient also removes them from all groups they belong to and revokes any active secrets. Audit log entries for the recipient are preserved.
