Split API docs into per-resource sections under docs/api/ (#2793)

* Split docs/API.md into per-resource sections under docs/api/ * Move API endpoints index above authentication in docs/api/README.md * Fix trailing comma in boards.md JSON example * Fix trailing comma in cards.md, add Response label to identity.md, add Rich Text to endpoint index
2026-04-06 14:00:17 -04:00
parent 00a5c6ef14
commit cdd13c1a61
17 changed files with 1803 additions and 1779 deletions
@@ -0,0 +1,46 @@
+# Identity
+
+An Identity represents a person using Fizzy.
+
+## `GET /my/identity`
+
+Returns a list of accounts the identity has access to, including the user for each account.
+
+__Response:__
+
+```json
+{
+  "accounts": [
+    {
+      "id": "03f5v9zjskhcii2r45ih3u1rq",
+      "name": "37signals",
+      "slug": "/897362094",
+      "created_at": "2025-12-05T19:36:35.377Z",
+      "user": {
+        "id": "03f5v9zjw7pz8717a4no1h8a7",
+        "name": "David Heinemeier Hansson",
+        "role": "owner",
+        "active": true,
+        "email_address": "david@example.com",
+        "created_at": "2025-12-05T19:36:35.401Z",
+        "url": "http://fizzy.localhost:3006/users/03f5v9zjw7pz8717a4no1h8a7"
+      }
+    },
+    {
+      "id": "03f5v9zpko7mmhjzwum3youpp",
+      "name": "Honcho",
+      "slug": "/686465299",
+      "created_at": "2025-12-05T19:36:36.746Z",
+      "user": {
+        "id": "03f5v9zppzlksuj4mxba2nbzn",
+        "name": "David Heinemeier Hansson",
+        "role": "owner",
+        "active": true,
+        "email_address": "david@example.com",
+        "created_at": "2025-12-05T19:36:36.783Z",
+        "url": "http://fizzy.localhost:3006/users/03f5v9zppzlksuj4mxba2nbzn"
+      }
+    }
+  ]
+}
+```