Pular para o conteúdo principal
POST
/
api
/
group
/
resetLink
/
:instance
Resetar Link de Convite
curl --request POST \
  --url https://api.example.com/api/group/resetLink/:instance \
  --header 'Content-Type: <content-type>' \
  --header 'token: <token>' \
  --data '
{
  "identifier": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.ryzeapi.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Auth: TokenAccount ou TokenInstance • Rate-limit: Global (100/min) • Idempotente: não (cada chamada gera um código diferente)

​
Descrição

Revoga o link de convite atual do grupo e gera um novo. Apenas admins podem chamar. Use sempre que suspeitar que o link vazou ou ao remover um membro que você não quer que volte.

​
Exemplos

Revoga o link de convite atual do grupo 120363406289005073@g.us e gera um novo código. O link antigo para de funcionar imediatamente. 
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"
  }'

​
Resposta de sucesso

Retorna o novo inviteCode e o inviteLink recém-gerados, ambos já ativos. O link antigo deixa de funcionar imediatamente, substitua qualquer cópia em fluxos de onboarding, materiais de divulgação ou QR codes impressos.
200 OK
{
  "success": true,
  "message": "Group invite link reset successfully",
  "groupJid": "120363406289005073@g.us",
  "inviteCode": "NEW123XYZ",
  "inviteLink": "https://chat.whatsapp.com/NEW123XYZ"
}

​
Parâmetros de rota

​
instance
string
obrigatório
Nome da instância.

​
Headers

​
token
string
obrigatório
TokenAccount ou TokenInstance.
​
Content-Type
string
obrigatório
application/json

​
Request body

​
identifier
string
obrigatório
JID, código de convite ou link do grupo.

​
Notas

  • O link antigo deixa de funcionar imediatamente, quem ainda não entrou recebe Invite link has been revoked or expired.
  • Para apenas consultar o link atual sem revogá-lo, use GET /info e leia group.inviteLink.
  • Para casos de comprometimento mais grave (admin comprometido), também revogue admin de quem não deveria ter através de /participants com action=demote.

​
Erros

HTTPMensagem
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)" }
}