agency-board

POST /v1/agency/boards/{boardId}/columns/{columnId}/move

Reorder a column in the board's strip.

Bütün agency-board nöqtələri

Doğrulama

API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

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

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

⛔⛔ A separate operation, because `PATCH` on a column no longer accepts `position` at all. It used to: it wrote the value and shifted no neighbour, so dragging the last column to the front left two columns claiming position 0 and the board fell back to `created_at` order — the write succeeded, the response was 200, and the column appeared not to have moved. This opens a gap and reindexes the strip, exactly as a card move does. ⭐ It returns the WHOLE strip rather than the moved column: a reorder renumbers every neighbour, so a response carrying one column would leave the caller holding stale positions for the rest.

Parametrlər

AdTipTələb olunurNədir
boardId (path)UuidBəliProject board ID (UUIDv7).
columnId (path)UuidBəliBoard column ID (UUIDv7).

Sorğu gövdəsi

AdTipTələb olunurNədir
positionintegerBəli

Cavab

AdTipTələb olunurNədir
itemsAgencyBoardColumn[]Bəli

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 422