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

### Body Parameters

- `membershipId: optional string`

  The membership to delete

### Example

```http
curl https://app.gitpod.io/api/gitpod.v1.GroupService/DeleteMembership \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $GITPOD_API_KEY" \
    -d '{}'
```

#### Response

```json
{}
```