Eliminar una conexión

DELETE /v1/connections/{connection_id} · permiso connections:write

Elimina una conexión. Los datos de usuario no se eliminan. If-Match es requerido. Si los usuarios tienen identidades de una conexión activa, la eliminación falla con connection_in_use; desactive la conexión primero. La conexión también se elimina de las listas de conexiones de aplicaciones. Una conexión eliminada puede restaurarse como inactive dentro de 30 días con :restore; después se elimina de forma permanente.

Solicitud

Campo	Tipo	Requerido	Descripción
`connection_id`	string	sí	Identificador de conexión (`conn_…`).
`If-Match`	header	sí	El `ETag` de la conexión como se leyó por última vez. Falta: `428`; obsoleto: `412`.

Respuesta

204 No Content, sin cuerpo.

Errores

HTTP	código	Cuándo
404	`not_found`	La conexión no existe o pertenece a otro entorno.
409	`connection_in_use`	Los usuarios aún tienen identidades de esta conexión activa; desactívela primero.
412	`precondition_failed`	`If-Match` no coincide con la versión actual.
428	`precondition_required`	Falta el encabezado `If-Match`.
401	`unauthenticated`	La credencial falta, es inválida o ha sido revocada.
403	`insufficient_permissions`	La credencial carece del permiso requerido.
429	`rate_limited`	Se superó el límite de velocidad; reintente después del período `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; reintente después del período `Retry-After`.

Ejemplo

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