Saltar al contenido principal
DELETE
/
api
/
chat
/
deleteChat
/
:instance
Eliminar chat completo
curl --request DELETE \
  --url https://api.example.com/api/chat/deleteChat/:instance \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "number": "<string>",
  "deleteMedia": true
}
'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí Elimina un chat (conversación) de tu lista de WhatsApp. Opcionalmente también borra los archivos multimedia almacenados localmente.
Operación local únicamente. Los demás participantes (en grupos) o el destinatario (en DMs) seguirán viendo el historial de su lado. Para salir de un grupo, usa DELETE /api/group/leave.

​
Ejemplos

​
Mantener media local

Elimina el chat de la lista de WhatsApp pero preserva los archivos multimedia almacenados localmente (S3/disco). Útil cuando aún quieres conservar adjuntos para auditoría o reprocesamiento. 
curl -X DELETE "https://ryzeapi.cloud/api/chat/deleteChat/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{"number": "5511999999999"}'

​
Borrar también la media

Con deleteMedia: true, además de eliminar el chat el servidor borra los archivos multimedia almacenados localmente para esa conversación. Irreversible del lado de RyzeAPI. 
curl -X DELETE "https://ryzeapi.cloud/api/chat/deleteChat/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "deleteMedia": true
  }'

​
Respuesta exitosa

200 OK
{
  "success": true,
  "message": "Chat deleted successfully (including media)",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "delete_media": true
}
El message cambia según deleteMedia:
  • false → "Chat deleted successfully"
  • true → "Chat deleted successfully (including media)"

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

​
token
string
requerido
TokenAccount o TokenInstance.

​
Cuerpo de la solicitud

​
number
string
requerido
Número (5511999999999) o JID (5511999999999@s.whatsapp.net, ...@lid, 120363...@g.us) del chat.
​
deleteMedia
boolean
predeterminado:"false"
Si es true, también elimina los archivos multimedia almacenados localmente para este chat.

​
Notas

  • El chat desaparece de tu lista en cada dispositivo vinculado (sincronizado vía AppState).
  • En grupos, eliminar el chat no te saca del grupo, el vínculo con el grupo permanece.
  • WhatsApp del teléfono tiene almacenamiento independiente; deleteMedia aquí solo afecta los archivos multimedia guardados por RyzeAPI en S3/disco.

​
Respuestas de error

HTTPerror.messageCuándo
400Invalid request bodyJSON malformado.
400Number is requiredCampo faltante.
401Invalid token,
404Instance not found,
503Instance is not connected to WhatsAppSin sesión activa.