Ripristinare il branding

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

Ripubblica una versione precedente: il suo snapshot diventa una nuova versione con source: rollback e rolled_back_from impostato. Le bozze non cambiano. Si possono ripristinare solo le ultime 50 versioni.

Richiesta

Campo	Tipo	Obbligatorio	Descrizione
`version`	intero	sì	Numero della versione da ripubblicare (almeno 1).

Risposta

200 OK con i metadati della nuova versione (lo snapshot non viene restituito).

{
  "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"
}

Errori

HTTP	code	Quando
400	`unknown_field`	Il corpo contiene un campo sconosciuto o non è un oggetto JSON.
404	`not_found`	La versione non esiste o non è più conservata.
422	`validation_failed`	`version` è assente (`required`) o minore di 1 (`out_of_range`).
401	`unauthenticated`	La credenziale manca, non è valida o è stata revocata.
403	`insufficient_permissions`	La credenziale non ha il permesso richiesto.
429	`rate_limited`	Il limite di frequenza è stato superato; riprovare dopo il periodo `Retry-After`.
503	`service_unavailable`	Una dipendenza è temporaneamente non disponibile; riprovare dopo il periodo `Retry-After`.

Esempio

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}'