---
title: "Soft Delete Polygon"
method: DELETE
path: "/api/admin/polygons/{polygon_id}"
tags: ["admin-polygons"]
---

# Soft Delete Polygon

`DELETE /api/admin/polygons/{polygon_id}`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/admin/polygons/{polygon_id}`
- Auth: none declared

Two-tier soft delete:
  - scope='full'     → status INACTIVE + is_enabled=false (current behaviour;
                        also clears geom so the polygon stops appearing on the map)
  - scope='geometry' → wipe geom + centroid only; metadata + status untouched
                        (used when a polygon's shape is wrong but its identity is correct)
`reason` is mandatory in both cases and prepended into notes.

## Path parameters

- `polygon_id` integer, required

## Query parameters

- `reason` string, required
- `scope` string: full = soft-delete entire polygon (status INACTIVE); geometry = clear geom only, keep metadata

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)