---
title: "Deletes the task status with the specified id."
method: POST
path: "/projects/{projectId}/taskstatuses/{taskStatusId}/delete"
tags: ["taskStatuses"]
---

# Deletes the task status with the specified id.

`POST /projects/{projectId}/taskstatuses/{taskStatusId}/delete`

If the status to delete is still used by tasks, another task status to move the tasks to must be provided.
            The last status of type 'todo' or 'done' cannot be deleted.
            <Check title="Required Permissions" icon="key">The user must either have `project-planning-data:write` permissions or must be creator of the project.</Check>

## Path parameters

- `projectId` string, uuid, required
- `taskStatusId` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- TaskStatusDeleteForm
  - `taskStatusId` string, uuid, nullable — The id of the task status all related tasks will be changed to.

## Response `204`

No Content

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/awork-io/apis/api-v1-reference.md) · [All operations](https://skmtc.net/awork-io/apis/api-v1-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/awork-io/api-v1-reference/versions/f784a53f60df/schema)