agency-board

PATCH `/v1/agency/boards/{boardId}/columns/{columnId}`

Rename a column, change what the client sees, or make it the intake column.

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}/columns/{columnId} \
  -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

⛔ Setting `visibility` to `internal` hides **every card in the column** from the client at once, by the AND rule — nothing is rewritten on the cards, so setting it back to `client` restores exactly the previous state rather than a guess at it. `is_intake: true` moves the client's "raise a request" column here; at most one column per board holds it, and the previous one is cleared in the same transaction.

Parametrlər

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

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`name`	`string`	Xeyr	—
`visibility`	`AgencyBoardVisibility`	Xeyr	Who may see this object. `internal` is always the default. A card reaches the client only when it is `client` and its column is too — an AND, not inheritance, because th…
`wip_limit`	`integer`	Xeyr	—
`position`	`integer`	Xeyr	—
`is_intake`	`boolean`	Xeyr	—

Cavab

Ad	Tip	Tələb olunur	Nədir
`id`	`Uuid`	Bəli	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`board_id`	`Uuid`	Bəli	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`name`	`string`	Bəli	—
`position`	`integer`	Bəli	—
`visibility`	`AgencyBoardVisibility`	Bəli	Who may see this object. `internal` is always the default. A card reaches the client only when it is `client` and its column is too — an AND, not inheritance, because th…
`is_intake`	`boolean`	Bəli	The single column a client may raise a request in. At most one per board.
`wip_limit`	`integer`	Xeyr	Advisory only, shown in the UI. ⛔ It never refuses a move: a WIP limit that blocks work turns a management convention into an outage on a Friday evening.

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

401 · 403 · 404 · 422

PATCH /v1/agency/boards/{boardId}/columns/{columnId}