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

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

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) sites.view jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.

A szervezet azonosítójának helye

Ez a végpont a(z) org_id paramétert lekérdezési paraméterként várja. Hagyja ki, ha a hívás az Ön teljes bérlői részfáját lefedje; küldje el a hívás egyetlen szervezetre történő szűkítéséhez.

A szervezeted azonosítója a vezérlőpult API-kulcsok képernyőjén található, közvetlenül a kulcs mellett. Ez ugyanaz az azonosító minden indított hívásban.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

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

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

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`.

Paraméterek

Név	Típus	Kötelező	Mi ez
`org_id (query)`	`Uuid`	Nem	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Válasz

Név	Típus	Kötelező	Mi ez
`preferences`	`AiSiteAgentPreference[]`	Igen	—
`modes`	`object[]`	Igen	The available modes in increasing order of autonomy.

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 422 · 429