API reference / Account
Change or move a card of your board
Changes the title, the notes, the due day, the thumbnail or the workspace tag of a card. Send only what changes. An emoji takes the place of an image, and an image takes the place of an emoji. Send emoji or image, not the two. To move the card, send columnId, before, or both. Without before, a card that changes column goes under the last card there.
/api/v1/me/board/cards/{id}Other ways to call it
troopy board update-cardIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
id*stringA 24-character id
Body
application/jsontitlestringAt least 1 characters ยท At most 200 characters
notesstringAt most 5000 characters
duestring | nullnull takes the due day away
workspaceIdstring | nullnull takes the tag away
emojistring | nullThe thumbnail of the card: one emoji, as its character. null takes the emoji away
imagestring | nullThe thumbnail of the card: a PNG, JPEG or WebP image of at most 1 MB, base64-encoded. null takes the image away
columnIdstringThe column to move it to
beforestring | nullThe card that it goes above, in the column where it lands. null puts it under the last card
Response
200 ยท 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