Restaurer l'image de marque

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

Republie une version antérieure : son instantané devient une nouvelle version avec source: rollback et rolled_back_from renseigné. Les brouillons ne changent pas. Seules les 50 dernières versions peuvent être restaurées.

Requête

Champ	Type	Obligatoire	Description
`version`	entier	oui	Numéro de version à republier (au moins 1).

Réponse

200 OK avec les métadonnées de la nouvelle version (l'instantané lui-même n'est pas renvoyé).

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

Erreurs

HTTP	code	Quand
400	`unknown_field`	Le corps contient un champ inconnu ou n'est pas un objet JSON.
404	`not_found`	La version n'existe pas ou n'est plus conservée.
422	`validation_failed`	`version` est absent (`required`) ou inférieur à 1 (`out_of_range`).
401	`unauthenticated`	L'identifiant est absent, invalide ou révoqué.
403	`insufficient_permissions`	L'identifiant n'a pas la permission requise.
429	`rate_limited`	La limite de débit est dépassée ; réessayez après le délai `Retry-After`.
503	`service_unavailable`	Une dépendance est temporairement indisponible ; réessayez après le délai `Retry-After`.

Exemple

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