Skip to main content
DELETE
/
api
/
group
/
leave
/
:instance
Leave Group
curl --request DELETE \
  --url https://api.example.com/api/group/leave/:instance \
  --header 'token: <token>'
Auth: TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: yes (leaving a group you have already left returns 404)

​
Description

Makes the instance leave a group. The identifier goes in the query string (not in the body) since this is a DELETE.

​
Examples

​
Leave (by JID)

Removes the instance from the group 120363406289005073@g.us by passing the JID in the query string. This is the most direct format when you already have the JID at hand. 
curl -X DELETE "https://ryzeapi.cloud/api/group/leave/$Instance_Name?identifier=120363406289005073@g.us" \
  -H "token: $Token_Instance"
Leaves the group by passing the invite link (https://chat.whatsapp.com/ABC123XYZ) in identifier. The service extracts the code, resolves the JID, and performs the leave. 
curl -X DELETE -G "https://ryzeapi.cloud/api/group/leave/$Instance_Name" \
  --data-urlencode "identifier=https://chat.whatsapp.com/ABC123XYZ" \
  -H "token: $Token_Instance"

​
Success response

Confirms the leave by returning the groupJid of the group you left. Leaving a community (parent group) also unlinks the instance from the subgroups linked through that community. To return to the group, you will need a new invite.
200 OK
{
  "success": true,
  "message": "Successfully left the group",
  "groupJid": "120363406289005073@g.us"
}

​
Path parameters

​
instance
string
required
Instance name.

​
Headers

​
token
string
required
TokenAccount or TokenInstance.

​
Query

​
identifier
string
required
Group JID, invite code, or link.

​
Notes

  • Leaving a community (parent group) also unlinks the instance from the subgroups linked through that community.
  • To return to the group, you must obtain a new invite.

​
Errors

HTTPMessage
400Identifier is required
403Not allowed to leave this group
404Group not found or you are not a member of this group
Envelope: 
{
  "success": false,
  "error": { "message": "Group not found or you are not a member of this group" }
}