---
title: "Delete a phase"
method: DELETE
path: "/admin/phases/{id}"
tags: ["Task Phases"]
---

# Delete a phase

`DELETE /admin/phases/{id}`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/admin/phases/{id}`
- Auth: HTTP bearer

Soft delete a task phase (only if it has no templates)

## Path parameters

- `id` string, uuid, required

## Response `204`

Phase deleted successfully

## Other responses

- `401`: Unauthorized
- `404`: Phase not found
- `409`: Cannot delete phase with templates

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)