agency-board

PATCH `/v1/agency/boards/{boardId}/cards/{cardId}`

Edit a card.

Санҷиши ҳаққоният

Kalitи API-ро ҳамчун token-и bearer фиристед. Ин нуқтаи ниҳоӣ дар мушаххасот иҷозати мушаххасеро нишон намедиҳад, бинобар ин ба калиди худ ҳадди ақали заруриро диҳед ва ба ҷои тахмин кардан, ҷавобро санҷед.

Ин нуқтаи поёнӣ ягон рақами мушаххаси созмонро талаб намекунад. Калиди шумо аллакай созмонеро, ки ба он тааллуқ дорад, муайян мекунад ва ҷавоб ба он маҳдуд карда мешавад.

Санҷидан

Ҳар чизро дар қаavски кунҷӣ бо қиматҳои худ ва ҷойи нигоҳдорандаи калидро бо калима аз панели идоракунии худ иваз кунед.

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

Воarid шудаед? Консоли API дар панели идоракунии шумо рақами мушаххаси ташкилоти воқеӣ ва калиди худро пур мекунад ва дархостро бар зидди API-и фаъол иҷро мекунад, то шумо посухи воқеиро бубинед. Ин нуқтаи ниҳоиро дар консоли API кушоед

Тафсилот

⭐ Sending assignee_id: null unassigns; omitting the field leaves the assignee alone. The two are different requests and the API distinguishes them, because a null-means-absent API cannot express "unassign" at all.

Параметрҳо

Ном	Намуд	Талаб карда мешавад	Ин чӣ аст
`boardId (path)`	`Uuid`	Бале	Project board ID (UUIDv7).
`cardId (path)`	`Uuid`	Бале	Board card ID (UUIDv7).

Ҷисми дархост

Ном	Намуд	Талаб карда мешавад	Ин чӣ аст
`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 that…
`assignee_id`	`string`	Не	—
`due_at`	`string`	Не	—
`cover_colour`	`string<neutral, info, violet, ok, warn, crit, >`	Не	A palette token, or the empty string to clear the cover. ⛔ The empty string is the CLEAR rather than `null`, so there is exactly one spelling of "no cover".

Ҷавоб

Ном	Намуд	Талаб карда мешавад	Ин чӣ аст
`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 that…
`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…
`created_at`	`string`	Не	—
`updated_at`	`string`	Не	—

Хатоҳое, ки ин нуқтаи ниҳоӣ метавонад баргардонад

401 · 403 · 404 · 422

PATCH /v1/agency/boards/{boardId}/cards/{cardId}