ai
GET /v1/ai/site-agent/preferences
What this customer lets the AI do to their sites without asking.
認証
ベアラー トークンとして API キーを送信します。キーには sites.view 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
組織 ID を入力する場所
このエンドポイントはクエリパラメータとして org_id を受け取ります。省略した場合はテナントサブツリー全体が対象になり、指定した場合は特定の組織のみに絞り込まれます。
組織IDは、ダッシュボードのAPIキー画面にキーのすぐ横に表示されています。これは、実行するすべての呼び出しで同じIDになります。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X GET https://api.zinndigital.com/v1/ai/site-agent/preferences \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブ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