---
title: "Delete an existing task or farm record"
method: DELETE
path: "/tasks/{id}"
tags: ["Tasks"]
---

# Delete an existing task or farm record

`DELETE /tasks/{id}`

## Request

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

Delete the task identified by id. A task may be pending work or a completed farm record, so deleting it removes that record rather than marking work complete. Read the task first to identify it and obtain the person's explicit confirmation before deletion. The caller must have permission to act for the task's producer or provider, and an MCP connection must allow writes. Returns 204 with no response body on success. Use updateTask to change a task or its status without deleting it.

## Path parameters

- `id` string, required

## Response `204`

Delete

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `404`: NotFound

---

[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)