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

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

Wszystkie dokumentacje dla programistów →

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie sites.view; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Miejsce na identyfikator organizacji

Ten punkt końcowy przyjmuje org_id jako parametr zapytania. Pomiń go, a wywołanie obejmie całe drzewo dzierżawy; prześlij go, aby ograniczyć wywołanie do jednej organizacji.

Identyfikator Twojej organizacji znajduje się na ekranie kluczy API w Twoim panelu, obok samego klucza. Jest to ten sam identyfikator w każdym wywołaniu, które wykonujesz.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

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

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

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.

Parametry

Nazwa	Typ	Wymagane	Co to jest
`org_id (query)`	`Uuid`	Nie	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`preferences`	`AiSiteAgentPreference[]`	Tak	—
`modes`	`object[]`	Tak	The available modes in increasing order of autonomy.

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 422 · 429