v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
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.

    projectIds:
      - "b0e12f6c-4c67-429d-a4a6-d9838b5da047"
      - "c1f23g7d-5d78-430e-b5b7-e0949c6eb158"
    
post/gitpod.v1.ProjectService/DeleteProjects

Request body

projectIdsstring[]

Response

Success

deletedProjectIdsstring[]

deleted_project_ids contains the IDs of successfully deleted projects