---
title: "Delete Property"
method: DELETE
path: "/properties/{id}"
tags: ["Properties"]
---

# Delete Property

`DELETE /properties/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/properties/{id}`
- Auth: HTTP bearer

Removes the property for good. This cannot be undone. It also removes
every paddock and mob on it, live or archived.

Unlike `deletePaddock` and `deleteMob`, this is not refused while
records exist: the tasks and records filed on the property, its
paddocks and its mobs are kept on the owner's board, but their
property, paddock and mob links are cleared. To keep that history
attached, archive the paddocks and mobs instead. Requires edit rights
on the owner.

## Path parameters

- `id` string, required

## Response `204`

Deleted

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-10-30** `92c4663a1266`: 6 warning, 6 info
  - removed the optional property `_meta` from the response with the `404` status (media type: application/json)
  - removed the optional property `_meta` from the response with the `404` status (media type: application/vnd.api+json)
  - removed the optional property `errors/items/onboarding` from the response with the `404` status (media type: application/json)
  - removed the optional property `errors/items/onboarding` from the response with the `404` status (media type: application/vnd.api+json)
  - …8 more
- **2026-10-24** `e285768a8f1d`: 12 warning
  - added the new `map_boundaries` enum value to the `_meta/onboarding/completed_steps/items/` response property for the response status `404` (media type: application/json)
  - added the new `map_boundaries` enum value to the `_meta/onboarding/completed_steps/items/` response property for the response status `404` (media type: application/vnd.api+json)
  - added the new `map_boundaries` enum value to the `_meta/onboarding/next_step` response property for the response status `404` (media type: application/json)
  - added the new `map_boundaries` enum value to the `_meta/onboarding/next_step` response property for the response status `404` (media type: application/vnd.api+json)
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/purplegrain/apis/purple-grain-api/changes/properties/:id/delete.md)

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) - [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/e32f34ba218b?raw)