---
title: "Deleting an existing Custom Task Status"
method: DELETE
path: "/custom_task_statuses/{id}"
tags: ["Task Statuses"]
---

# Deleting an existing Custom Task Status

`DELETE /custom_task_statuses/{id}`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/custom_task_statuses/{id}`
- Auth: none declared

Deletes a custom task status within a task status set. If assigned to a task (story), the task’s `status` will default to the status type (category)—`not started`, `started`, `needs info`, or `completed`.
- This will delete the task status from this set. If this status is currently being used by a task in a project, the status will reset to its default status type: Not Started, Started, Needs Info, or Completed.


The response will contain no content and an HTTP 204 status code if the request was
successful, or a [standard Kantata OX error message](#section/Errors) explaining why the object could not be deleted.

## Path parameters

- `id` integer, required

## Response `204`

Custom Task Status has been deleted.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)