---
title: "Leave Group"
method: POST
path: "/v2/groups/leave"
tags: ["Groups"]
---

# Leave Group

`POST /v2/groups/leave`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/groups/leave`
- Auth: HTTP bearer

Leave a group you are a member of. Removes your membership from the group. If you are the last member, the group is deleted. Admins must remove all other members before leaving.

## Request body

- LeaveGroupRequest: Request body for leaving a group
  - `group_id` string, required

## Response `200`

Successfully left group

- object
  - `data` LeaveGroupResponse, required: Response after leaving a group
    - `success` boolean, required
    - `message` string, required
    - `warnings` string[]
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Admin must remove all other members before leaving
- `401`: Unauthorized - missing or invalid authentication
- `404`: User is not a member of this group

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)