API reference / Account
Add a card to your board
Adds a card under the last card of a column of your board. Without columnId, the card goes in the first column. A card can have a thumbnail: one emoji, or an image. Send emoji or image, not the two. A board holds 1,000 cards at most.
/api/v1/me/board/cardsOther ways to call it
troopy board add-cardIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsontitle*stringAt least 1 characters ยท At most 200 characters
notesstringPlain text, 5,000 characters at most
At most 5000 characters
columnIdstringThe column to put it in, from GET /me/board
duestring | nullThe day it is due, as YYYY-MM-DD
workspaceIdstring | nullTags the card with one of your workspaces, from GET /workspaces
emojistring | nullThe thumbnail of the card: one emoji, as its character
imagestring | nullThe thumbnail of the card: a PNG, JPEG or WebP image of at most 1 MB, base64-encoded
Response
201 ยท application/jsondata*object10 properties
id*stringA 24-character id
columnId*stringThe column that it is in
title*stringnotes*stringPlain text. Empty when the card has none
due*string | nullThe day it is due, as YYYY-MM-DD
emoji*string | nullThe emoji that is its thumbnail. Null with an image, and with no thumbnail
imageUrl*string | nullThe address of the image that is its thumbnail. Null with an emoji, and with no thumbnail
workspace*object | nullThe workspace that the card is about. Null with no tag, and for a workspace that you no longer reach
3 properties
id*stringA 24-character id
name*stringlogoUrl*string | nullcreatedAt*stringISO 8601 date and time
updatedAt*stringISO 8601 date and time