agency-board
POST /v1/agency/boards/{boardId}/columns/{columnId}/move
Reorder a column in the board's strip.
Authenticatie
Stuur een API-sleutel mee als bearer token. Dit eindpunt vermeldt geen specifieke toestemming in de specificatie, dus geef uw sleutel de minimale rechten die nodig zijn en controleer het antwoord in plaats van zomaar wat aan te nemen.
Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.
Probeer het
Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.
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> }'Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console
Details
⛔⛔ 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.
Parameters
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
boardId (path) | Uuid | Ja | Project board ID (UUIDv7). |
columnId (path) | Uuid | Ja | Board column ID (UUIDv7). |
Aanvraaglichaam
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
position | integer | Ja | — |
Reactie
| Naam | Type | Verplicht | Wat dit is |
|---|---|---|---|
items | AgencyBoardColumn[] | Ja | — |
Fouten die dit eindpunt kan retourneren
401 · 403 · 404 · 422