agency-board
POST /v1/agency/boards/{boardId}/cards/{cardId}/restore
Take a card back out of the archive.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/agency/boards/{boardId}/cards/{cardId}/restore \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
⛔ A separate operation rather than PATCH {"archived_at": null}, because archived_at is a timestamp the server owns: a caller who may write it may also write a date in 2031, and the position reindex that has to happen alongside it would not. The card returns at the END of its column — the position it held was reindexed away when it was archived, and the bottom is where a person looks for something they have just restored.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
boardId (path) | Uuid | Да | Project board ID (UUIDv7). |
cardId (path) | Uuid | Да | Board card ID (UUIDv7). |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
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