From 9b47269349ff28f4a481d1de3cd5d01210b237a3 Mon Sep 17 00:00:00 2001 From: Rob Zolkos Date: Wed, 7 Jan 2026 10:05:46 -0500 Subject: [PATCH 1/3] Document closed and column fields in card API response Add missing fields to the GET card endpoint documentation: - closed: indicates whether the card is in "Done" state - column: present only when card is triaged into a column --- docs/API.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/API.md b/docs/API.md index ee1820f28..c43d23477 100644 --- a/docs/API.md +++ b/docs/API.md @@ -574,6 +574,7 @@ __Response:__ "description_html": "

Hello, World!

", "image_url": null, "tags": ["programming"], + "closed": false, "golden": false, "last_active_at": "2025-12-05T19:38:48.553Z", "created_at": "2025-12-05T19:38:48.540Z", @@ -594,6 +595,15 @@ __Response:__ "url": "http://fizzy.localhost:3006/897362094/users/03f5v9zjw7pz8717a4no1h8a7" } }, + "column": { + "id": "03f5v9zkft4hj9qq0lsn9ohcn", + "name": "In Progress", + "color": { + "name": "Lime", + "value": "var(--color-card-4)" + }, + "created_at": "2025-12-05T19:36:35.534Z" + }, "creator": { "id": "03f5v9zjw7pz8717a4no1h8a7", "name": "David Heinemeier Hansson", @@ -619,6 +629,8 @@ __Response:__ } ``` +> **Note:** The `closed` field indicates whether the card is in the "Done" state. The `column` field is only present when the card has been triaged into a column; cards in "Maybe?", "Not Now" or "Done" will not have this field. + ### `POST /:account_slug/boards/:board_id/cards` Creates a new card in a board. From 7de65be756a8a5c4e4eabfb718578bdc72014eb3 Mon Sep 17 00:00:00 2001 From: Rob Zolkos Date: Wed, 7 Jan 2026 10:12:03 -0500 Subject: [PATCH 2/3] Document goldness endpoints for marking cards as golden Add POST and DELETE endpoints for /:account_slug/cards/:card_number/goldness --- docs/API.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/API.md b/docs/API.md index c43d23477..0fe71404a 100644 --- a/docs/API.md +++ b/docs/API.md @@ -779,6 +779,22 @@ __Response:__ Returns `204 No Content` on success. +### `POST /:account_slug/cards/:card_number/goldness` + +Marks a card as golden. + +__Response:__ + +Returns `204 No Content` on success. + +### `DELETE /:account_slug/cards/:card_number/goldness` + +Removes golden status from a card. + +__Response:__ + +Returns `204 No Content` on success. + ## Comments Comments are attached to cards and support rich text. From 562d340b84131c95771bc9b3b409f06a1199a64c Mon Sep 17 00:00:00 2001 From: Rob Zolkos Date: Wed, 7 Jan 2026 10:17:34 -0500 Subject: [PATCH 3/3] Document DELETE endpoint for removing card header image --- docs/API.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/API.md b/docs/API.md index 0fe71404a..bd4488127 100644 --- a/docs/API.md +++ b/docs/API.md @@ -695,6 +695,14 @@ __Response:__ Returns `204 No Content` on success. +### `DELETE /:account_slug/cards/:card_number/image` + +Removes the header image from a card. + +__Response:__ + +Returns `204 No Content` on success. + ### `POST /:account_slug/cards/:card_number/closure` Closes a card.