From 7de65be756a8a5c4e4eabfb718578bdc72014eb3 Mon Sep 17 00:00:00 2001
From: Rob Zolkos <rob@zolkos.com>
Date: Wed, 7 Jan 2026 10:12:03 -0500
Subject: [PATCH] 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.