Saltar al contenido principal
DELETE
/
api
/
chat
/
assignTag
/
:instance
Desasignar etiqueta
curl --request DELETE \
  --url https://api.example.com/api/chat/assignTag/:instance
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Quita una etiqueta de un chat. Si el chat no tiene esa etiqueta, la operación se considera exitosa (idempotente). La etiqueta en sí no se elimina, para eliminarla, usa Eliminar etiqueta.

​
Ejemplo

curl -X DELETE "https://ryzeapi.cloud/api/chat/assignTag/$Instance_Name?number=5511999999999&tagId=2" \
  -H "token: $Token_Instance"

​
Respuesta exitosa

La respuesta confirma la eliminación devolviendo el tag_id. El envoltorio reutiliza la misma forma que tags-assign, solo con message: "Tag removed successfully".
200 OK
{
  "success": true,
  "message": "Tag removed successfully",
  "tag_id": "2"
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Parámetros de consulta

​
number
string
requerido
Número de teléfono, JID privado (...@s.whatsapp.net o ...@lid), JID de grupo (...@g.us) o newsletter.
​
tagId
string
requerido
ID de la etiqueta a quitar.

​
Cabeceras

NombreRequeridoEjemploDescripción
tokensí (o Authorization)a1b2c3d4-...TokenAccount o TokenInstance.

​
Respuestas de error

HTTPerror.messageCuándo ocurre
400Instance name is required,
400number query parameter is required,
400tagId query parameter is required,
401Invalid token,
404Instance not found,
404Tag not found,
503Instance is not connected to WhatsApp,
Error 400
{
  "success": false,
  "error": { "message": "tagId query parameter is required" }
}

​
Relacionados

Asignar etiqueta

Reasigna la etiqueta a otro chat.

Eliminar etiqueta

Elimina la etiqueta de toda la instancia.