Skip to main content

PUT /cards/{id}/move

Description

Moves cards to a specified position

The route handles the HTTP PUT request made to the cards/{id}/move path.

Query parameters

The query parameter is sent in the request line:

NameTypeDescription
idnumberRequired. The ID of the card to be moved. In case multiple cards are requested to be moved, the id should be set to 0
info

When you move multiple cards, make sure that the id is set to 0, otherwise (if set to another value), only one card (with this specified id value) will be moved.

Payload

The server expects to receive a json object with the next properties:

NameTypeDescription
idnumberRequired. The ID of the moved card.
columnIdnumberRequired. The ID of the column where the card is moved to.
rowIdnumberRequired. The ID of the row where the card is moved to.
beforenumberOptional. The ID of the card before which the moved card should be placed.
batchobjectRequired for multiselect. An array of cards objects that are moved.

Example:

{
"id": 4,
"columnId": 2,
"rowId": 1,
"before": "7"
}

In case multiple cards are moved, the batch property should contain an array of all cards objects that are moved:

{
"batch": [
{
"id": 2,
"columnId": 1,
"rowId": 1,
"before": "1"
},
{
"id": 7,
"columnId": 1,
"rowId": 1,
"before": "1"
}
]
}

Response

The server returns a json object with a card ID (if one card is moved) or with the ID set to 0 for the operation on multiple cards.

Example:

Response to the request for the single card operation
{
"id": 4
}
Response to the request for the multiple cards operation
{
"id": 0
}

The HTTP status code shows whether the request succeeds (response.status == 200) or fails (response.status == 500).


Related articles: Working with server