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

Choose what the AI may do for one kind of fix.

Tabbatar da Asali

Aika maɓallin API azaman alamar ɗauka (bearer token). Dole ne maɓallin ya kasance yana da izinin sites.view; idan babu shi, za a ƙi amfani da maɓallin tare da lambar 403, ba 404 ba.

Wannan wurin ƙarewa ba ya buƙatar ID na ƙungiya. Maɓallin ku ya riga ya gano ƙungiyar da yake ciki, kuma an iyakance amsa a kanta.

Gwada

May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.

curl -X PUT https://api.zinndigital.com/v1/ai/site-agent/preferences \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "action": <string>, "mode": <AiSiteAgentMode> }'

An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API

Bayani

Records the customer's wish. The **requested** value is stored, never the clamped one: a customer who asks for "just fix it" on a fix still earning its rung keeps that setting, and it takes effect on its own the day the fix is promoted. Storing the clamp instead would quietly downgrade them for ever with no way to see it had happened. An unknown action or remedy key is a `422` naming it, never a silently ignored write. Requires `sites.view`.

Jikin buƙata

Suna	Nau'i	Ana buƙata	Abin da yake
`action`	`string`	Eh	—
`mode`	`AiSiteAgentMode`	Eh	What the customer wants the AI to do about one kind of fix. `ask` proposes it and waits for a button; `canary` applies it to one site and checks the result; `auto` applies it an…

Martani

Suna	Nau'i	Ana buƙata	Abin da yake
`action`	`string`	Eh	The fix this row is about — an agent action key or a support remedy key.
`requested`	`AiSiteAgentMode`	Eh	What the customer chose, stored as they chose it.
`effective`	`AiSiteAgentMode`	Eh	What will actually happen — `requested` clamped to `ceiling`.
`ceiling`	`AiSiteAgentMode`	Eh	The highest mode the PLATFORM currently permits for this fix. The customer cannot raise it; it moves when the fix earns a higher rung.
`clamped`	`boolean`	Eh	True when the customer asked for more than the ceiling allows. The screen must say so — otherwise their choice looks as though it did not register.
`reason`	`string`	A'a	Why the ceiling is where it is, in words a customer reads.

Kuskuren da wannan matsaya za ta iya maido wa

401 · 403 · 422 · 429

PUT /v1/ai/site-agent/preferences