# 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

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