Skip to main content
POST
/
api
/
group
/
resetLink
/
:instance
Reset Invite Link
curl --request POST \
  --url https://api.example.com/api/group/resetLink/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "identifier": "<string>"
}
'
Auth: TokenAccount or TokenInstance • Rate-limit: Global (100/min) • Idempotent: no (each call generates a different code)

​
Description

Revokes the group’s current invite link and generates a new one. Only admins can call. Use it whenever you suspect the link has leaked or after removing a member you do not want back.

​
Examples

Revokes the current invite link of the group 120363406289005073@g.us and generates a new code. The old link stops working immediately. 
curl -X POST "https://ryzeapi.cloud/api/group/resetLink/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "120363406289005073@g.us"
  }'

​
Success response

Returns the new inviteCode and inviteLink, both already active. The old link stops working immediately, replace any copies in onboarding flows, marketing materials, or printed QR codes.
200 OK
{
  "success": true,
  "message": "Group invite link reset successfully",
  "groupJid": "120363406289005073@g.us",
  "inviteCode": "NEW123XYZ",
  "inviteLink": "https://chat.whatsapp.com/NEW123XYZ"
}

​
Path parameters

​
instance
string
required
Instance name.

​
Headers

​
token
string
required
TokenAccount or TokenInstance.
​
Content-Type
string
required
application/json

​
Request body

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

​
Notes

  • The old link stops working immediately, anyone who has not yet joined receives Invite link has been revoked or expired.
  • To just query the current link without revoking it, use GET /info and read group.inviteLink.
  • For more severe compromise scenarios (compromised admin), also revoke admin from anyone who should not have it via /participants with action=demote.

​
Errors

HTTPMessage
400Identifier is required
403Not authorized to reset group invite link (must be admin)
404Group not found or you are not a member of this group
Envelope: 
{
  "success": false,
  "error": { "message": "Not authorized to reset group invite link (must be admin)" }
}