---
title: "Delete Farm"
method: DELETE
path: "/farms/{id}"
tags: ["Farms"]
---

# Delete Farm

`DELETE /farms/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/farms/{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

---

[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/4bedbc1c784c?raw)