agency-board

PUT `/v1/agency/boards/{boardId}/cards/{cardId}/labels`

Set the labels on a card.

Аутентификация

API кілтін bearer токені ретінде жіберіңіз. Бұл соңғы нүкте сипаттамада арнайы рұқсатты көрсетпейді, сондықтан болжағаннан гөрі кілтіңізге қажетті ең аз рұқсатты беріп, жауапты тексеріңіз.

Бұл соңғы нүкте ұйым идентификаторын қабылдамайды. Сіздің кілтіңіз оның қай ұйымға тиесілі екенін өзі анықтайды және жауап соған шектеледі.

Әрекет етіп көру

Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.

curl -X PUT https://api.zinndigital.com/v1/agency/boards/{boardId}/cards/{cardId}/labels \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "label_ids": <string[]> }'

Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені API консолінде ашыңыз

Мәліметтер

Replaces the card's whole label set. Every id is re-checked against **this board**, so a label from another board is refused rather than quietly attached.

Параметрлер

Аты	Tүрі	Міндетті	Мазмұны
`boardId (path)`	`Uuid`	Иә	Project board ID (UUIDv7).
`cardId (path)`	`Uuid`	Иә	Board card ID (UUIDv7).

Сұрау денесі

Аты	Tүрі	Міндетті	Мазмұны
`label_ids`	`string[]`	Иә	The COMPLETE set the card should wear afterwards — this replaces, it does not add. An empty array takes every label off, which is why the array may be empty: an add/remove pair…
`created_by`	`AgencyBoardActor`	Жоқ	—
`updated_by`	`AgencyBoardActor`	Жоқ	Who last edited this card. Moves exactly when `updated_at` does.
`assignee`	`AgencyBoardActor`	Жоқ	The resolved form of `assignee_id`.

Жауап

Аты	Tүрі	Міндетті	Мазмұны
`id`	`Uuid`	Иә	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`board_id`	`Uuid`	Иә	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`column_id`	`Uuid`	Иә	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`title`	`string`	Иә	—
`body`	`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…
`position`	`integer`	Иә	—
`assignee_id`	`string`	Жоқ	—
`due_at`	`string`	Жоқ	—
`created_by_client`	`boolean`	Жоқ	Whether the client raised this card themselves.
`archived_at`	`string`	Жоқ	—
`cover_colour`	`AgencyBoardLabelColour`	Жоқ	A colour band across the top of the card, or the empty string for none. ⛔ Shares the label palette rather than declaring a second one: two palettes on one screen is how a cover…
`labels`	`AgencyBoardLabel[]`	Жоқ	The labels this card wears, in the board's label order. ⛔ Agency-only — the client's projection of a card carries no labels at all, because a label is the agency's private vocab…
`created_at`	`string`	Жоқ	—
`updated_at`	`string`	Жоқ	—

Бұл соңғы нүкте қайтара алатын қателер

401 · 403 · 404 · 422

PUT /v1/agency/boards/{boardId}/cards/{cardId}/labels