Borrar un contacto

DELETE 
/contacts/:id

Borra el contacto de forma definitiva, con sus conversaciones, mensajes, etiquetas e historial — es la solicitud de supresión de datos. Las filas de la lista de supresión quedan, sin la identidad, y los destinatarios de campañas se anonimizan.

Una API key restringida a algunos números recibe 403: esta operación es de toda la base.

Request

Responses

200

Contacto borrado.

401

Token ausente, mal formado, desconocido o revocado (authentication), o cuenta suspendida (tenant_inactive).

402

Sin derecho de uso (payment_required). El cuerpo trae el motivo en reason y la salida en action: qué hacer (kind) y la página del panel donde se hace (url).

403

El recurso no pertenece a tu cuenta (forbidden), o la ruta está en la lista de bloqueo del espejo (forbidden_endpoint), o tu API key está restringida a algunos números y la operación es de toda la cuenta (forbidden).

404

El recurso no existe (not_found).

429

Límite de peticiones superado (rate_limit).

Response Headers

Retry-After

Segundos a esperar antes de reintentar.

X-RateLimit-Category

Categoría de límite aplicada — send, media o default.

X-RateLimit-Scope

Qué cubo describen las otras cabeceras — key (la API key), session (el panel) o account (el techo de la cuenta).

X-RateLimit-Limit

Techo de peticiones de la categoría en la ventana actual.

X-RateLimit-Remaining

Peticiones restantes en la ventana actual.