agency-board

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

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

تصدیق‌هویت

د بیارر ټوکن په توګه یو API کي وسپارئ. دا پای ټکی په مشخصاتو کې کوم ځانګړی اجازه لیک نه بیانوي، نو خپل کیلي ته لږترلږه هغه څه ورکړئ چې ورته اړتیا لري او د فرض کولو پر ځای ځواب وپلټئ.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

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

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

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.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`boardId (path)`	`Uuid`	هو	Project board ID (UUIDv7).

د غوښتنې بدن

نوم	ډول	اړین	دا څه شی دی
`auto_triage`	`boolean`	نه	—
`auto_triage_applies`	`boolean`	نه	—
`digest_cadence`	`string<off, daily, weekdays, weekly>`	نه	—
`digest_hour_utc`	`integer`	نه	—
`preferred_provider`	`string`	نه	—
`preferred_model`	`string`	نه	—

ځواب

نوم	ډول	اړین	دا څه شی دی
`board_id`	`Uuid`	هو	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`auto_triage`	`boolean`	هو	Triage a card when it lands in the intake column. Off by default.
`auto_triage_applies`	`boolean`	نه	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>`	هو	—
`digest_hour_utc`	`integer`	نه	—
`digest_next_at`	`string`	نه	—
`digest_last_ok_at`	`string`	نه	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`	نه	—
`preferred_model`	`string`	نه	Blank means the cheapest model we can run, computed from the price table.
`entitled`	`boolean`	نه	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 `…

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404 · 422

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