Reanudar una aplicación
POST /v1/applications/{application_id}:resume · permiso applications:write
Devuelve el status de una aplicación suspendida a active, para que pueda volver a obtener tokens. Sus credenciales de cliente siguen funcionando, pero las familias de refresh tokens revocadas por la suspensión permanecen revocadas: los usuarios de la aplicación deben volver a iniciar sesión para obtener nuevos tokens. La solicitud no tiene cuerpo (vacío o {}). Reanudar una aplicación que ya está activa no cambia nada y devuelve la aplicación actual con la misma versión. El cambio se escribe en el registro de auditoría de gestión como application.updated y se publica como los eventos application_changed y application_status_changed.
Solicitud
Cabeceras: If-Match: "<version>" (opcional). Con If-Match, el cambio solo se aplica a esa versión (412 en caso contrario); sin ella, se usa la última versión y la solicitud se reintenta si otro escritor modifica la aplicación al mismo tiempo. Envía una cabecera Idempotency-Key para que los reintentos sean seguros.
| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
application_id |
path | sí | Identificador de la aplicación, con prefijo app_. |
Respuesta
200 OK con la aplicación ("status": "active") y su ETag.
Errores
Todo error es un cuerpo application/problem+json con un code estable.
| HTTP | code |
Cuándo |
|---|---|---|
| 400 | malformed_request, unknown_field |
Se envió un cuerpo que no es JSON válido o tiene un campo. |
| 401 | unauthenticated |
La clave de API falta, no es válida o ha sido revocada. |
| 403 | insufficient_permissions |
La clave no tiene el permiso applications:write. |
| 404 | not_found |
La aplicación no existe en este entorno (o el identificador está mal formado). |
| 412 | precondition_failed |
La versión en If-Match está desactualizada. |
| 429 | rate_limited |
Se superó el límite de frecuencia; respeta Retry-After. |
| 503 | service_unavailable |
Una dependencia no está disponible temporalmente; reintenta más tarde. |
Ejemplo
curl -X POST https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg:resume \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H 'If-Match: "4"'
CLI: keenauth applications resume app_6f8d0cjgbmf0gtn2rg6pscp3cg --if-match '"4"'