---
title: "Delete project milestone status"
method: DELETE
path: "/admin/project_milestone_statuses/{id}"
tags: ["Project milestone statuses"]
---

# Delete project milestone status

`DELETE /admin/project_milestone_statuses/{id}`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/project_milestone_statuses/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Delete a custom project milestone status. System statuses (Not Started, In Progress, Blocked, Done) cannot be deleted and will return HTTP 403.
If milestones currently use this status, supply `merge_into_project_milestone_status_id` so they can be reassigned before the status is removed.

## Path parameters

- `id` integer, required

## Query parameters

- `merge_into_project_milestone_status_id` integer

## Response `200`

Successful Response

## Other responses

- `403`: Forbidden - Cannot delete system statuses
- `404`: Not Found
- `422`: Unprocessable Entity - status is in use and no merge target provided

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)