agency-board

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

Reorder a column in the board's strip.

Све agency-board крајње тачке

Сва документација за програмере →

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

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

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> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

⛔⛔ 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.

Параметри

НазивТипОбавезноШта је ово
boardId (path)UuidДаProject board ID (UUIDv7).
columnId (path)UuidДаBoard column ID (UUIDv7).

Тело захтева

НазивТипОбавезноШта је ово
positionintegerДа—

Одговор

НазивТипОбавезноШта је ово
itemsAgencyBoardColumn[]Да—

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422