Move a list
Moves the list to a new place on its board, between the neighbours
named in placement.
Requires the board:list:write scope.
Authorization
Parameters
Path parameters
listIDstring requiredThe list's ID.
Request body required
placementPlacementShow Placement properties
afterstringThe ID of the item it should follow. Empty means the top.beforestringThe ID of the item it should precede. Empty means the bottom.tostringAn end of the list. Any other value is ignored.
Responses
204
The list was moved.
400
The body is not JSON for this endpoint, or carries a field it does not
know (INVALID_BODY), or a field breaks a rule (VALIDATION_ERROR;
the message says which).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
404
It does not exist, or it is on a board the caller cannot see (NOT_FOUND).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
409
The neighbours named in placement are no longer next to each other (STALE_PLACEMENT). Read the board again and retry.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X POST 'https://evohub.io/api/v1/board/lists/lst_2b3c4d5e6f7a48b9c0d1e2f3a4b5c6d7/move' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"placement": {
"to": "top"
}
}'
