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