Revertir la marca

POST /v1/branding:rollback · permiso branding:write

Vuelve a publicar una versión anterior: su instantánea pasa a ser una nueva versión con source: rollback y rolled_back_from. Los borradores no cambian. Solo se pueden restaurar las últimas 50 versiones.

Solicitud

Campo	Tipo	Requerido	Descripción
`version`	entero	sí	Número de la versión que volver a publicar (al menos 1).

Respuesta

200 OK con los metadatos de la nueva versión (la instantánea en sí no se devuelve).

{
  "version": 4,
  "snapshot_sha256": "3f1c…",
  "source": "publish",
  "rolled_back_from": null,
  "actor_type": "api_key",
  "actor_id": "key_01jb…",
  "published_at": "2026-10-05T09:31:00Z"
}

Errores

HTTP	código	Cuándo
400	`unknown_field`	El cuerpo tiene un campo desconocido o no es un objeto JSON.
404	`not_found`	La versión no existe o ya no se conserva.
422	`validation_failed`	`version` falta (`required`) o es menor que 1 (`out_of_range`).
401	`unauthenticated`	La credencial falta, no es válida o se ha revocado.
403	`insufficient_permissions`	La credencial no tiene el permiso necesario.
429	`rate_limited`	Se superó el límite de frecuencia; vuelva a intentarlo tras el periodo `Retry-After`.
503	`service_unavailable`	Una dependencia no está disponible temporalmente; vuelva a intentarlo tras el periodo `Retry-After`.

Ejemplo

curl -X POST https://api.eu.keenauth.com/v1/branding:rollback \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":3}'