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

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

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung sites.view verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.

Hier kommt Ihre Organisations-ID hin

Dieser Endpunkt akzeptiert org_id als Abfrageparameter. Lassen Sie ihn weg, erfasst der Aufruf Ihren gesamten Mandanten-Unterbaum; übergeben Sie ihn, um den Aufruf auf eine Organisation einzugrenzen.

Die ID Ihrer Organisation finden Sie im Dashboard auf dem Bildschirm für API-Schlüssel direkt neben dem Schlüssel selbst. Sie ist bei jedem Ihrer Aufrufe dieselbe.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

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

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

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

Parameter

Name	Typ	Erforderlich	Was es ist
`org_id (query)`	`Uuid`	Nein	Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it.

Antwort

Name	Typ	Erforderlich	Was es ist
`preferences`	`AiSiteAgentPreference[]`	Ja	—
`modes`	`object[]`	Ja	The available modes in increasing order of autonomy.

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 422 · 429