Skip to main content
TroopyDocs
Open Troopy
Troopy

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.

post/api/v1/me/board/cards

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 add-card
MCP toolNone. Call it over REST or with the CLI.
Rate limit120 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.

Body

application/json
title*string

At least 1 characters ยท At most 200 characters

notesstring

Plain text, 5,000 characters at most

At most 5000 characters

columnIdstring

The column to put it in, from GET /me/board

duestring | null

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

workspaceIdstring | null

Tags the card with one of your workspaces, from GET /workspaces

emojistring | null

The thumbnail of the card: one emoji, as its character

imagestring | null

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

Response

201 ยท 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.
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.