GET `/v1/ai/site-agent/preferences`

What this customer lets the AI do to their sites without asking.

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar sites.view iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Kurum kimliğinizin yazılacağı yer

Bu uç nokta, org_id parametresini bir sorgu parametresi olarak alır. Bu parametreyi dışarıda bırakırsanız çağrı tüm kiracı alt ağacınızı kapsar; çağrıyı tek bir kuruluşa daraltmak için gönderin.

Kuruluş kimliğiniz (id), kontrol panelinizdeki API anahtarları ekranında, anahtarın hemen yanında yer alır. Yaptığınız her çağrıda aynı kimlik kullanılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

curl -X GET https://api.zinndigital.com/v1/ai/site-agent/preferences \
  -H "Authorization: Bearer zdk_live_…"

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

One row per fix the AI knows how to apply, carrying **three** values and not one: what the customer asked for (`requested`), what will actually happen (`effective`), and the highest mode the platform currently permits (`ceiling`). They differ when a customer has chosen more autonomy than a fix has earned. A response carrying only `effective` would misreport the customer's own setting back to them — they chose "just fix it", the page shows "ask me first", and it looks as though their click did not register. `clamped` is true in exactly that case and `reason` says why in words a customer can read. The ceiling is the platform's, not the customer's: a brand-new fix nobody has watched work cannot be set to unattended by anybody. Requires `sites.view`.

Parametreler

Ad	Tür	Zorunlu	Ne olduğu
`org_id (query)`	`Uuid`	Hayır	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`preferences`	`AiSiteAgentPreference[]`	Evet	—
`modes`	`object[]`	Evet	The available modes in increasing order of autonomy.

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 422 · 429