Delete Plot
Delete a single plot from your organization's view.
This is a visibility delete, not a data delete (see Delete Facility for
the full semantics โ preservation, revival-on-re-upload, and cross-org
behavior all apply identically).
โถCascade
None โ a plot has no descendants, so only that plot is removed. Its parent shed and facility are untouched.
โถRequest
โถMethod & Path
DELETE /locations/plots/:id
:id is the plot's public location id (as returned by GET /locations/:id).
โถQuery parameters
detach_from_pending_dds(boolean, defaulttrue) โ if this plot is pinned by a pending (unfrozen) DDS version, detach it (true) or block the delete with 409 (false). A frozen DDS version (submitted / version-cut) is never touched and the plot stays pinned to it.
โถResponse
- 204 No Content โ deleted.
- 403 โ the key lacks the
locations:deletescope. - 404 โ no plot with that id is visible to your organization.
- 409
CONFLICTโdetach_from_pending_dds=falseand the plot is pinned by a pending DDS version (details.pending_dds_version_ids).
See error-codes.md for the shared error envelope.
Required scope:
locations:delete