v18

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014211,6201.8 MB
gitpod.v1.GroupService

DeleteGroup

Deletes a group and removes all its resource assignments.

When a group is deleted, all resource assignments revert to org-level scope.

Use this method to:

  • Remove unused groups
  • Clean up after team reorganization

Examples

  • Delete a group:

    Permanently removes a group.

    groupId: "d2c94c27-3b76-4a42-b88c-95a85e392c68"
    

Authorization

Requires org:admin role on the organization.

post/gitpod.v1.GroupService/DeleteGroup

Request body

groupIdstring uuid

Response

Success

GitpodV1DeleteGroupResponse required

Empty response