---
title: "DeleteMembership"
method: POST
path: "/gitpod.v1.GroupService/DeleteMembership"
tags: ["gitpod.v1.GroupService"]
---

# DeleteMembership

`POST /gitpod.v1.GroupService/DeleteMembership`

Deletes a membership for a user in a group.

 Use this method to:
 - Remove users from groups
 - Revoke group-based permissions

 ### Examples

 - Remove a user from a group:

   Deletes a membership by its ID.

   ```yaml
   membershipId: "a1b2c3d4-5678-90ab-cdef-1234567890ab"
   ```

 ### Authorization

 Requires `org:admin` permission on the organization or `group:admin` permission on the specific group.

## Request body

- GitpodV1DeleteMembershipRequest — DeleteMembership messages
  - `membershipId` string, uuid — The membership to delete

## Response `200`

Success

- GitpodV1DeleteMembershipResponse — Empty response

## 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)