Skip to main content

POST /cards

Description

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

This route processes an HTTP POST request sent to the /cards endpoint.

Payload

The server expects a json object with the following properties:

NameTypeDescription
labelstringRequired. The title for the new card.
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 response returns a json object containing the newly created card ID.

Example:

{ 
"id": 1
}

The HTTP status code indicates if the request was successful (response.status == 200) or if it failed (response.status == 500).


Related articles: Working with server