agency-board

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

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

احراز هویت

یک کلید API را به عنوان یک توکن برbearer ارسال کنید. این نقطه پایانی مجوز خاصی را در مشخصات خود ذکر نمی‌کند، بنابراین به جای فرض کردن، حداقل نیازهای کلید خود را بدهید و پاسخ را بررسی کنید.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

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

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

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

پارامترها

نام	نوع	الزامی	چیست
`boardId (path)`	`Uuid`	بله	Project board ID (UUIDv7).
`columnId (path)`	`Uuid`	بله	Board column ID (UUIDv7).

بدنه درخواست

نام	نوع	الزامی	چیست
`name`	`string`	خیر	—
`visibility`	`AgencyBoardVisibility`	خیر	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`	خیر	—
`position`	`integer`	خیر	—
`is_intake`	`boolean`	خیر	—

پاسخ

نام	نوع	الزامی	چیست
`id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`board_id`	`Uuid`	بله	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`name`	`string`	بله	—
`position`	`integer`	بله	—
`visibility`	`AgencyBoardVisibility`	بله	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`	بله	The single column a client may raise a request in. At most one per board.
`wip_limit`	`integer`	خیر	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.

خطاهایی که این نقطه پایانی می‌تواند برگرداند

401 · 403 · 404 · 422

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