---
title: "Delete a subproject"
method: DELETE
path: "/api/projects/{id}"
tags: ["Projects"]
---

# Delete a subproject

`DELETE /api/projects/{id}`

Deletes a subproject.

Only subprojects can be deleted through this API. Deleting the root/parent project
returns `422 only_subprojects_can_be_deleted`. A project must have no phone numbers
before it can be deleted; otherwise the request returns `422 phone_numbers_must_be_removed`.

On a successful delete, the subproject's registry brands and campaigns are migrated up
to the parent project.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Management_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `id` string, uuid, required — Universal Unique Identifier.

## Response `204`

There is no content to send for this request, but the headers may be useful.

## Other responses

- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — The request could not be processed. Deleting a root/parent project returns `only_subprojects_can_be_deleted`, and deleting a project that still has phone numbers assigned returns `phone_numbers_must_be_removed`.
- `500` — An internal server error occurred.

---

[API](https://skmtc.net/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.net/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/versions/05c5164b85c7/schema)