---
title: "Delete a project"
method: DELETE
path: "/users/{user_id}/projects/{project_id}"
tags: ["Projects\\Essentials"]
---

# Delete a project

`DELETE /users/{user_id}/projects/{project_id}`

This method deletes a project and optionally also the videos that it contains.

## Path parameters

- `project_id` number, required
- `user_id` number, required

## Query parameters

- `should_delete_clips` boolean

## Response `204`

The project was deleted.

## Other responses

- `401` — Error code 8000: The user credentials are invalid.
- `403` — Error code 3200: The authenticated user can't delete the project.
- `404` — Error code 5000: No such project exists.

## Changes

- **2019-01-25** `4be4cdb8fdd1` — 1 breaking, 1 info
  - removed the request body
  - added the new optional `query` request parameter `should_delete_clips`
- **2018-12-05** `26f856a94041` — 1 warning, 1 info
  - deleted the `query` request parameter `should_delete_clips`
  - added optional request body

[Change history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/users/:user_id/projects/:project_id/delete.md)

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) · [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vimeo/vimeo-api/revisions/ea882e0224a4/schema)