Markalamayı geri al

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

Önceki bir sürümü yeniden yayımlar: anlık görüntüsü source: rollback ve rolled_back_from ile yeni bir sürüm olur. Taslaklar değişmez. Yalnız son 50 sürüm geri alınabilir.

İstek

Alan Tür Zorunlu Açıklama
version tamsayı evet Yeniden yayımlanacak sürüm numarası (en az 1).

Yanıt

200 OK; yeni sürümün üst verisi (anlık görüntünün kendisi dönmez).

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

Hatalar

HTTP code Ne zaman
400 unknown_field Gövdede bilinmeyen alan var ya da gövde JSON nesnesi değil.
404 not_found Sürüm yok ya da artık saklanmıyor.
422 validation_failed version yok (required) ya da 1'den küçük (out_of_range).
401 unauthenticated Kimlik bilgisi yok, geçersiz ya da iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinde gerekli izin yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Bir bağımlılık geçici olarak kullanılamıyor; Retry-After süresinden sonra yeniden deneyin.

Örnek

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