# Delete a project

> Delete a project you own. It is emptied first, and there is no undo.

Source: https://docs.generalinput.com/api/projects/delete



<Endpoint method="POST" path="/v1/projects/:id/delete" />

<Access scope="projects:manage" />

The project is emptied before it goes. What happens to its contents is your call:

| `contents` | Resources you own               | Resources a teammate owns       |
| ---------- | ------------------------------- | ------------------------------- |
| `archive`  | Taken down with the project.    | Released to the workspace root. |
| `release`  | Released to the workspace root. | Released to the workspace root. |

Taking down a teammate's resource is an owner action on each resource, so theirs are always released.

## Body [#body]

| Field      | Type   | Required | Notes                   |
| ---------- | ------ | -------- | ----------------------- |
| `contents` | string | yes      | `archive` or `release`. |

## Response [#response]

`204 No Content`.

## Errors [#errors]

| Status | When                                   |
| ------ | -------------------------------------- |
| `403`  | The member is not the project's owner. |
