DELETE /api/docks/{id}
- Gate:
session - Read-only:
false - Destructive:
true - Idempotent:
false
Permanently deletes a Dock resource. Use with care — this is a hard delete with no soft-undo, intended for removing a mis-created or decommissioned dock, not for temporarily taking it offline (use dock_update’s status/access-mode fields for that once exposed). Only an admin of the owning org may call it; demo sessions are rejected.
DELETE /api/docks/{id}sessionfalsetruefalse204 — Deleted.401 — Not signed in.403 — Demo mode is read-only, or the caller is not an admin of the owning org.404 — No dock matches that slug/id.429 — Too many requests from this IP.