agency-board

POST /v1/agency/boards/{boardId}/cards/{cardId}/restore

Take a card back out of the archive.

همه نقاط پایانی agency-board

احراز هویت

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

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

امتحان کنید

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

curl -X POST https://api.zinndigital.com/v1/agency/boards/{boardId}/cards/{cardId}/restore \
  -H "Authorization: Bearer zdk_live_…"

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی 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).

پاسخ

نامنوعالزامیچیست
idUuidبلهUUIDv7 identifier — sortable by creation time (docs/02 §8).
board_idUuidبلهUUIDv7 identifier — sortable by creation time (docs/02 §8).
column_idUuidبلهUUIDv7 identifier — sortable by creation time (docs/02 §8).
titlestringبله
bodystringخیر
visibilityAgencyBoardVisibilityبله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…
positionintegerبله
assignee_idstringخیر
due_atstringخیر
created_by_clientbooleanخیرWhether the client raised this card themselves.
archived_atstringخیر
cover_colourAgencyBoardLabelColourخیر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…
labelsAgencyBoardLabel[]خیر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_atstringخیر
updated_atstringخیر

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

401 · 403 · 404