Eliminar un dominio remitente de correo electrónico

DELETE /v1/email-sender-domains/{sender_domain_id} · permiso email-sender-domains:write · todos los planes

Elimina un dominio remitente. No se puede eliminar un dominio que la configuración de entrega de correo sigue usando: primero cambie el proveedor de correo electrónico a otro modo. Después de eliminarlo, puede retirar los registros DNS del dominio.

Solicitud

Campo	Tipo	Obligatorio	Descripción
`sender_domain_id`	string	sí	Identificador del dominio remitente (`sdom_…`).
`If-Match`	cabecera	sí	El `ETag` del dominio; `*` coincide con cualquier versión. `428` si falta, `412` si no coincide.

Sin cuerpo de solicitud.

Respuesta

204 No Content.

Errores

HTTP	code	Cuándo
404	`not_found`	El dominio remitente no existe, pertenece a otro entorno o el identificador tiene un formato incorrecto.
409	`conflict`	La configuración de entrega de correo usa el dominio (`platform_managed_domain`). Cambie primero el proveedor de correo electrónico a otro modo o dominio.
412	`precondition_failed`	`If-Match` no coincide con la versión actual del dominio.
428	`precondition_required`	Falta `If-Match`.
401	`unauthenticated`	La credencial falta, no es válida o ha sido revocada.
403	`insufficient_permissions`	La credencial no tiene el permiso necesario.
429	`rate_limited`	Se superó el límite de frecuencia; reintente después del tiempo indicado en `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente después del tiempo indicado en `Retry-After`.

Ejemplo

curl -X DELETE https://api.eu.keenauth.com/v1/email-sender-domains/sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "2"'

CLI: keenauth email-sender-domains delete sdom_01k7r9m3q5t8v2w4x6y8z0a2b4 --if-match '"2"'