Eliminar un suscriptor
Elimina permanentemente un suscriptor de la marca.
DELETE /v1/subscribers/:id
Requiere el permiso subscribers:write o full. Los permisos se comprueban en el servidor. Las claves test se rechazan con 403 test_mode_unavailable; no existe un sandbox aislado.
Elimina de la base activa el suscriptor, incluidos identidad, propiedades, pertenencia a listas y etiquetas.
Parámetro de ruta
id es el identificador sub_… del suscriptor. También se admite el UUID sin prefijo, con o sin guiones. Cualquier otro formato devuelve 400 invalid_param.
La eliminación es irreversible. Si una persona solo quiere dejar de recibir mensajes, usa unsubscribe con channel: "all" para conservar la baja. Utiliza DELETE cuando necesites eliminar el registro; revisa también las copias que mantengas en otros sistemas.
No hay parámetros de consulta.
Respuesta
Confirmación con 200 OK; id devuelve el identificador enviado.
Ejemplo
curl -X DELETE https://fluyio.com/api/v1/subscribers/sub_9f1c2b3a4d5e6f708192a3b4c5d6e7f8 \
-H "Authorization: Bearer $FLUYIO_API_KEY" \
-H "Fluyio-Version: 2026-05-15"Respuesta
{
"id": "sub_9f1c2b3a4d5e6f708192a3b4c5d6e7f8",
"object": "subscriber",
"deleted": true
}Un GET posterior devuelve 404 resource_not_found.
Errores
| HTTP | code | Descripción |
|---|---|---|
| 401 | missing_api_key / invalid_api_key | Falta la clave, no es válida, ha caducado o está revocada. |
| 403 | missing_scope | La clave no permite esta operación. |
| 403 | test_mode_unavailable | El modo de pruebas no está disponible. |
| 400 | invalid_param | El ID no es válido (param: id). |
| 404 | resource_not_found | El suscriptor no existe en la marca. |