Lister les versions d'image de marque

GET /v1/branding/versions · permission branding:read

Liste les versions publiées de la plus récente à la plus ancienne, avec pagination par curseur (limit, after). Seule la pagination vers l'avant est prise en charge ; before et order sont rejetés avec 422. Aucun total n'est renvoyé.

Requête

Champ	Type	Obligatoire	Description
`limit`	query	non	1 à 100 éléments par page.
`after`	query	non	Curseur issu de `list_metadata.after`.

Réponse

200 OK avec data[] (métadonnées des versions) et list_metadata.

{"data": [{"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"}],
 "list_metadata": {"before": null, "after": "eyJ2Ijo…"}}

Erreurs

HTTP	code	Quand
400	`invalid_cursor`	Le curseur est mal formé ou appartient à un autre environnement.
422	`validation_failed`	`limit` est hors plage, ou `before`/`order` a été fourni (`unsupported`).
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 "https://api.eu.keenauth.com/v1/branding/versions?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"