agency-board

PATCH `/v1/agency/boards/{boardId}/ai/settings`

Turn auto-triage or the standup digest on or off.

Doğrulama

API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

curl -X PATCH https://api.zinndigital.com/v1/agency/boards/{boardId}/ai/settings \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

Both are **opt-in and off by default** — each is recurring billed work, so a board created for a test or an import must not start spending on a schedule nobody chose. Setting `digestCadence` to anything but `off` schedules the first digest; setting it to `off` clears the schedule.

Parametrlər

Ad	Tip	Tələb olunur	Nədir
`boardId (path)`	`Uuid`	Bəli	Project board ID (UUIDv7).

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`auto_triage`	`boolean`	Xeyr	—
`auto_triage_applies`	`boolean`	Xeyr	—
`digest_cadence`	`string<off, daily, weekdays, weekly>`	Xeyr	—
`digest_hour_utc`	`integer`	Xeyr	—
`preferred_provider`	`string`	Xeyr	—
`preferred_model`	`string`	Xeyr	—

Cavab

Ad	Tip	Tələb olunur	Nədir
`board_id`	`Uuid`	Bəli	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`auto_triage`	`boolean`	Bəli	Triage a card when it lands in the intake column. Off by default.
`auto_triage_applies`	`boolean`	Xeyr	Apply the triage suggestions, or only propose them. Separate from `auto_triage` because "tell me what you think" and "do it" are different appetites.
`digest_cadence`	`string<off, daily, weekdays, weekly>`	Bəli	—
`digest_hour_utc`	`integer`	Xeyr	—
`digest_next_at`	`string`	Xeyr	—
`digest_last_ok_at`	`string`	Xeyr	When a digest last SUCCEEDED. Kept separate from `digest_next_at` deliberately: one column cannot serve both a cursor and a staleness alarm.
`preferred_provider`	`string`	Xeyr	—
`preferred_model`	`string`	Xeyr	Blank means the cheapest model we can run, computed from the price table.
`entitled`	`boolean`	Xeyr	Whether this organisation's plan includes board AI at all, so a client can stop offering what the engine would refuse. `false` means every run on this board answers `200` with `…

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 422

PATCH /v1/agency/boards/{boardId}/ai/settings