---
title: "Delete a task"
description: "Deletes a task for good, with every run it made, their transcripts and their approval requests. Mail it sent or sorted stays as it is."
url: "https://openemail.uk/docs/api/tasks/delete"
area: "API"
category: "Mailbox"
---

# Delete a task

Deletes a task for good, with every run it made, their transcripts and their approval requests. Mail it sent or sorted stays as it is.

`DELETE /tasks/{id}`

## DELETE /tasks/{id}

Deletes a task for good, with every run it made, their transcripts and their approval requests. Mail it sent or sorted stays as it is.

## Example

Needs `tasks:write`.

**curl**

```
curl -X DELETE "$OE/tasks/tsk_4b9e2c7a1f3d86e05a9c2b7d" -H "$AUTH"
```

**Response**

```
{
  "object": "task",
  "id": "tsk_4b9e2c7a1f3d86e05a9c2b7d",
  "deleted": true
}
```

> A run that is going when its task is deleted stops before its next step and leaves no record.

> To stop a task and keep its history, pause it instead.

## Reference

- [`DELETE /tasks/{id}`](https://openemail.uk/docs/api/reference/tasks#delete-tasks-id): full reference