Eliminar una API

DELETE /v1/apis/{api_id}?confirm=true · permiso apis:write

Elimina suavemente una API. confirm=true e If-Match son requeridos. Los permisos de aplicación para esta API y la configuración de API predeterminada de las aplicaciones que apuntan a ella se eliminan en la misma operación, el identificador no se puede reutilizar durante 90 días, y las sesiones de actualización emitidas para esta audiencia se revocan. La API del sistema no se puede eliminar.

Solicitud

Parámetro	En	Descripción
`api_id`	path	El id de la API.
`confirm`	query	Debe ser `true`.
`If-Match`	header	El `ETag` de la última lectura (requerido).

Respuesta

204 No Content, sin cuerpo.

Errores

HTTP	código	Cuándo
404	`not_found`	No existe tal API en este entorno.
409	`conflict`	La API es la API del sistema.
412	`precondition_failed`	`If-Match` no coincide con la versión actual.
422	`validation_failed`	`confirm` está faltando o no es `true` (`/confirm`).
428	`precondition_required`	`If-Match` está faltando.

Ejemplo

curl -X DELETE "https://api.eu.keenauth.com/v1/apis/api_01h455vb4pex5vsknk084sn02q?confirm=true" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H 'If-Match: "1"'