# Eliminar un certificado de firma del IdP de una conexión

`DELETE /v1/connections/{connection_id}/certificates/{certificate_id}` · permiso `connections:write`

Elimina de una conexión SAML empresarial un certificado de firma del proveedor de identidad. La eliminación surte efecto de inmediato: a partir de ese momento el certificado no verifica ninguna firma, deja de listarse y no se puede volver a añadir. Eliminar un certificado que ya está eliminado también devuelve `204`.

El último certificado que está actualmente válido no se puede eliminar, porque la conexión rechazaría todos los inicios de sesión; [añade](add.md) primero el certificado nuevo. La solicitud no admite la cabecera `If-Match`. Las eliminaciones se auditan como `connection.idp_certificate_retired`.

## Solicitud

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `connection_id` | ruta | sí | ID de la conexión SAML empresarial (`conn_…`). |
| `certificate_id` | ruta | sí | ID del certificado (`conncert_…`) de [Listar certificados](list.md). |

## Respuesta

`204 No Content`.

## Errores

| HTTP | code | Cuándo |
|---|---|---|
| 404 | `not_found` | La conexión o el certificado no existen en este entorno, el ID está mal formado o la conexión no es una conexión empresarial. |
| 409 | `conflict` | La conexión no es una conexión SAML, o el certificado es el último que está actualmente válido. |
| 401 | `unauthenticated` | La credencial falta, no es válida o está revocada. |
| 403 | `insufficient_permissions` | La credencial no tiene el permiso necesario. |
| 429 | `rate_limited` | Se superó el límite de solicitudes; reintenta tras el periodo indicado en `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintenta tras el periodo indicado en `Retry-After`. |

## Ejemplo

```bash
curl -X DELETE "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/certificates/conncert_01j9xq2m4n6p8r0s2t4v6w8y0a" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth connections certificates delete conn_01j9xp6q0r1s5t7v9w1x3y5z7b conncert_01j9xq2m4n6p8r0s2t4v6w8y0a
```