Skip to main content

POST /cards

Description

Adds a new card and responds with a json object containing the card's ID.

This endpoint processes HTTP POST requests sent to the /cards URL.

Payload

The server requires a json object with the following fields:

NameTypeDescription
labelstringRequired. The title of the card to create.
columnnumberRequired. The ID of the column where the card will be placed.
rownumberRequired. The ID of the row where the card will be positioned.

Example:

{
"label": "New card",
"column": 2,
"row": 1,
}

Response

The endpoint responds with a json object containing the ID of the newly created card.

Example:

{ 
"id": 1
}

The HTTP status code indicates if the request was successful (response.status == 200) or if there was an error (response.status == 500).


Related articles: Working with server