Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Account

Change or move a column of your board

Changes the name or the colour of a column, or moves it before another column. Send only what changes. The answer is the whole board.

patch/api/v1/me/board/columns/{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-column
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.

Path parameters

id*string

A 24-character id

Body

application/json
namestring

At least 1 characters ยท At most 40 characters

colorenum<string>

noneskymintsandroseorangecyan

beforestring | null

The column that it goes before. null puts it after the last column

Response

200 ยท application/json
data*object
2 properties
columns*array<object>

The columns, in their order

3 properties
id*string

A 24-character id

name*string
color*enum<string>

noneskymintsandroseorangecyan

cards*array<object>

The cards, by column and then from the top of each column

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.