Skip to main content
TroopyDocs
Open Troopy
Troopy

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.

patch/api/v1/me/board/cards/{id}

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy board update-card
MCP toolNone. Call it over REST or with the CLI.
Rate limit240 calls in 60 seconds, for each key
RetriesSend an Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.

Path parameters

id*string

A 24-character id

Body

application/json
titlestring

At least 1 characters ยท At most 200 characters

notesstring

At most 5000 characters

duestring | null

null takes the due day away

workspaceIdstring | null

null takes the tag away

emojistring | null

The thumbnail of the card: one emoji, as its character. null takes the emoji away

imagestring | null

The thumbnail of the card: a PNG, JPEG or WebP image of at most 1 MB, base64-encoded. null takes the image away

columnIdstring

The column to move it to

beforestring | null

The card that it goes above, in the column where it lands. null puts it under the last card

Response

200 ยท application/json
data*object
10 properties
id*string

A 24-character id

columnId*string

The column that it is in

title*string
notes*string

Plain text. Empty when the card has none

due*string | null

The day it is due, as YYYY-MM-DD

emoji*string | null

The emoji that is its thumbnail. Null with an image, and with no thumbnail

imageUrl*string | null

The address of the image that is its thumbnail. Null with an emoji, and with no thumbnail

workspace*object | null

The workspace that the card is about. Null with no tag, and for a workspace that you no longer reach

3 properties
id*string

A 24-character id

name*string
logoUrl*string | null
createdAt*string

ISO 8601 date and time

updatedAt*string

ISO 8601 date and time

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask a company owner or admin.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.