---
title: "DeleteProjects"
method: POST
path: "/gitpod.v1.ProjectService/DeleteProjects"
tags: ["gitpod.v1.ProjectService"]
---

# DeleteProjects

`POST /gitpod.v1.ProjectService/DeleteProjects`

Deletes multiple projects in a single request.

 Use this method to:
 - Remove multiple unused projects at once
 - Clean up projects in batch

 Returns successfully deleted project IDs and details about any failures.
 Each project in the request is processed independently — partial success
 is possible.

 ### Examples

 - Delete multiple projects:

   Permanently removes several projects in one request.

   ```yaml
   projectIds:
     - "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
     - "c1f23g7d-5d78-430e-b5b7-e0949c6eb158"
   ```

## Request body

- GitpodV1DeleteProjectsRequest
  - `projectIds` string[]

## Response `200`

Success

- GitpodV1DeleteProjectsResponse
  - `deletedProjectIds` string[] — deleted_project_ids contains the IDs of successfully deleted projects
  - `failedProjects` GitpodV1DeleteProjectsResponseFailure[] — failed_projects contains details about projects that failed to delete
    - `error` string — error describes why the project deletion failed
    - `index` integer — index is the position in the request array (0-based)
    - `projectId` string — project_id is the project ID that failed

## Other responses

- `default` — Error

---

[API](https://skmtc.net/gitpod-io/apis/gitpod-v1.md) · [All operations](https://skmtc.net/gitpod-io/apis/gitpod-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitpod-io/gitpod-v1/revisions/44d50c2ac284/schema)