ai
GET /v1/ai/site-agent/preferences
What this customer lets the AI do to their sites without asking.
Аутентификация
Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.view; ключ без него отклоняется с кодом 403, а не 404.
Идентификатор вашей организации
Этот эндпоинт принимает org_id в качестве параметра запроса. Оставьте его пустым, и вызов охватит все поддерево вашей аренды; передайте его, чтобы сузить область вызова до одной организации.
Идентификатор вашей организации находится на экране ключей API в вашей панели управления, рядом с самим ключом. Это один и тот же идентификатор для каждого вашего запроса.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
curl -X GET https://api.zinndigital.com/v1/ai/site-agent/preferences \
-H "Authorization: Bearer zdk_live_…"Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли
Подробнее
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.
Параметры
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
org_id (query) | Uuid | Нет | Which organization this is about. Required when the caller belongs to more than one; a caller in exactly one may omit it. |
Ответ
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
preferences | AiSiteAgentPreference[] | Да | — |
modes | object[] | Да | The available modes in increasing order of autonomy. |
Ошибки, которые может возвращать этот эндпоинт
401 · 403 · 422 · 429