Kategoriyi Güncelle

Bir kategorinin düzenlenebilir durumunun tamamını yazar. Bu bir yama değil, değiştirmedir: düzenlenebilir her alan gönderildiği gibi yazılır.

• is_leaf ya da show_on_dashboard gönderilmezse false olur.
• Ne image_url ne image gönderilirse kayıtlı görsel silinir. İkisi birden gönderilirse yüklenen dosya geçerli olur.
• Alt kategorisi olan bir kategori yaprak yapılamaz, çünkü bu alt kategorileri sahipsiz bırakır. Bir yaprağı yeniden dala çevirmek her zaman serbesttir.

Üst kategori, path, int_id, image_svg ve tokenization_rules API üzerinden değiştirilemez.

Gerekli izin: category:update

İstek

PUT /v2/admin/categories/{category_id}

Parametreler

Ad	Tip	Konum	Açıklama
category_id	string	path	Zorunlu. Kategori ID'si (24 karakterlik hex)

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. multipart/form-data (HTTP istemciniz boundary ile birlikte ayarlar)

Gövde

Alan	Tip	Zorunlu	Açıklama
name_en	string	Evet	İngilizce ad
name_tr	string	Evet	Türkçe ad
is_leaf	boolean	Hayır	Kategori alt kategori yerine tokenize edilmiş varlık barındırıyorsa true. Gönderilmezse false
show_on_dashboard	boolean	Hayır	Kategoriyi panoda göster. Gönderilmezse false
image_url	string	Hayır	Zaten barındırdığınız bir görselin URL'si. Gönderilmezse (ve image de yoksa) kayıtlı görsel silinir
image	file	Hayır	2 MB'tan küçük görsel dosyası. Sunucuda görsel depolamanın yapılandırılmış olmasını gerektirir

Örnek

curl --request PUT \
  --url '{{baseUrl}}/v2/admin/categories/6911a3c2e4b0f51d2c8a7e41' \
  --header 'Authorization: Bearer <access_token>' \
  --form 'name_en=Venture Capital Funds' \
  --form 'name_tr=Girişim Sermayesi Fonları' \
  --form 'is_leaf=true' \
  --form 'show_on_dashboard=true' \
  --form 'image_url=https://s3.tokenizationtr.com/categories/image/6911a3c2e4b0f51d2c8a7e41.png'

Yanıt

Güncellenen kategoriyle birlikte 200 OK.

{
  "id": "6911a3c2e4b0f51d2c8a7e41",
  "parent_id": "667e9251ca818a2138ed4888",
  "name": {
    "en": "Venture Capital Funds",
    "tr": "Girişim Sermayesi Fonları"
  },
  "path": "1.4.117",
  "int_id": 117,
  "image_svg": null,
  "image_url": "https://s3.tokenizationtr.com/categories/image/6911a3c2e4b0f51d2c8a7e41.png",
  "is_leaf": true,
  "show_on_dashboard": true,
  "created_at": "2026-11-09T10:15:42.318Z"
}

Yanıt Alanları

Kategoriyi Getir sayfasında açıklanan yapıdaki kategori.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (name_en ya da name_tr eksik) — details alanına bakın. Görsel 2 MB ya da daha büyükse veya sunucuda görsel yükleme yapılandırılmamışsa da döner
400	10016	category_id geçerli bir 24 karakterlik hex ID değil
400	10001	Kategori bulunamadı ya da silinmiş (domain 4)
400	10006	Kategorinin alt kategorileri var; yaprak yapılamaz (domain 4)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.