Eliminar un dominio personalizado

DELETE /v1/custom-domains/{custom_domain_id} · permiso custom-domains:write

Elimina un dominio personalizado: pasa a released, el inicio de sesión a través de él se detiene y el nombre queda en cuarentena durante 30 días (ningún otro entorno puede añadirlo). El dominio principal y el dominio usado como emisor del entorno no se pueden eliminar; haga antes principal otro dominio. Eliminar un dominio que ya está liberado solo repite la liberación en el registro de la plataforma.

Solicitud

Campo Tipo Obligatorio Descripción
custom_domain_id string sí Identificador del dominio personalizado (cdom_…).
If-Match header sí Obligatorio. El ETag del dominio; 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 personalizado no existe o pertenece a otro entorno.
409 custom_domain_in_use El dominio es el dominio principal o el emisor del entorno.
409 domain_in_use_by_rp_id El dominio es el rpId de clave de acceso de una conexión, o el rpId anterior de una migración de rpId en curso; cambie primero el rpId con Cambiar el rpId de la clave de acceso.
412 precondition_failed If-Match no coincide con la versión actual del dominio.
428 precondition_required Falta If-Match.
503 service_unavailable El registro de dominios de la plataforma o la información del emisor del entorno no están disponibles temporalmente.
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 ha superado el límite de uso; reintente después del periodo indicado en Retry-After.

Ejemplo

curl -X DELETE https://api.eu.keenauth.com/v1/custom-domains/cdom_01j9xk3m7q8r2s4t6v8w0y2z4a \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "3"'