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

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

Autenticación

Envía una clave de API como token de portador. La clave debe tener el permiso sites.view; una clave que no lo tenga se rechazará con un código 403, no 404.

Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.

Pruébalo

Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.

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> }'

¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API

Detalles

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

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	¿Qué es esto?
`action`	`string`	Sí	—
`mode`	`AiSiteAgentMode`	Sí	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…

Respuesta

Nombre	Tipo	Obligatorio	¿Qué es esto?
`action`	`string`	Sí	The fix this row is about — an agent action key or a support remedy key.
`requested`	`AiSiteAgentMode`	Sí	What the customer chose, stored as they chose it.
`effective`	`AiSiteAgentMode`	Sí	What will actually happen — `requested` clamped to `ceiling`.
`ceiling`	`AiSiteAgentMode`	Sí	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`	Sí	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`	No	Why the ceiling is where it is, in words a customer reads.

Errores que este endpoint puede devolver

401 · 403 · 422 · 429

PUT /v1/ai/site-agent/preferences