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, default true) โ€” 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:delete scope.
  • 404 โ€” no plot with that id is visible to your organization.
  • 409 CONFLICT โ€” detach_from_pending_dds=false and 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