From 842398ddc437fea8f37b6cf89ef89a2211dcb0c3 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 14:55:57 -0700
Subject: [PATCH 01/16] spec(bc5): forward-compat additions + parallel BC4/BC5
 provenance
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add optional fields to existing Smithy structures for BC5 read paths,
keeping BC4 readers fully compatible. All additions are opt-in: absent
fields are tolerated, present fields decode through the existing types.

* Notification: bubble_up_url, bubble_up_at (eligibility-gated)
* GetMyNotificationsOutput: bubble_ups, scheduled_bubble_ups; document
  current memories[] behavior pending BC team's back-compat decision
* Person: tagline (alias of bio in BC5)
* Todo: steps (reuses existing CardStep wire shape)
* Todoset: todos_count, completed_loose_todos_count, todos_url, app_todos_url

Restructure spec/api-provenance.json for parallel branch tracking — .bc3
keeps the active-branch baseline (now five), .compatibility.bc3-master
records the BC4 baseline for compatibility tracking. Existing tooling
(sync-spec-version, sync-api-version, Go provenance.go) reads the same
.bc3 keys and works unchanged.

Seed spec/bucket-scoped-allowlist.txt with the only existing bucket-only
list endpoint (webhooks) for the new parity lint.
---
 behavior-model.json                 |   1 +
 go/pkg/basecamp/api-provenance.json |   8 ++
 openapi.json                        | 188 +++++++++++++++++-----------
 spec/api-provenance.json            |   8 ++
 spec/basecamp.smithy                |  48 +++++++
 spec/bucket-scoped-allowlist.txt    |   8 ++
 6 files changed, 191 insertions(+), 70 deletions(-)
 create mode 100644 spec/bucket-scoped-allowlist.txt

diff --git a/behavior-model.json b/behavior-model.json
index feb0afc6b..7ff08ace4 100644
--- a/behavior-model.json
+++ b/behavior-model.json
@@ -2601,6 +2601,7 @@
       "$.email_address",
       "$.title",
       "$.bio",
+      "$.tagline",
       "$.location",
       "$.avatar_url"
     ],
diff --git a/go/pkg/basecamp/api-provenance.json b/go/pkg/basecamp/api-provenance.json
index a4a62cea1..ad2ef0b78 100644
--- a/go/pkg/basecamp/api-provenance.json
+++ b/go/pkg/basecamp/api-provenance.json
@@ -1,6 +1,14 @@
 {
   "bc3": {
+    "branch": "master",
     "revision": "e52453ff35a6292473eb095a8568649aa132fef9",
     "date": "2026-07-17"
+  },
+  "compatibility": {
+    "bc3-four": {
+      "branch": "four",
+      "revision": "9d73959a62538bbd2d474fbf806ce386bb4092a8",
+      "date": "2026-06-12"
+    }
   }
 }
diff --git a/openapi.json b/openapi.json
index 57fbadf0c..876bf8a56 100644
--- a/openapi.json
+++ b/openapi.json
@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-07-17",
+    "version": "2026-05-01",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -18362,17 +18362,16 @@
         }
       },
       "put": {
-        "description": "Replace a todo with a new complete representation.\nThe request body is the todo's full writable state: any writable field\nomitted from the request is cleared server-side (empty/missing\nassignee_ids clears assignees, missing description clears it, and so\non). content is required — a request without it is rejected.\nTo set some fields while preserving the rest, use the SDK's merge-safe\nupdate or edit methods, which GET the current todo and PUT the full\nrepresentation back. Those read-modify-write helpers are not atomic:\na concurrent write between the GET and PUT is overwritten (last write\nwins for the whole representation; the window is one round-trip).",
-        "operationId": "ReplaceTodo",
+        "description": "Update an existing todo",
+        "operationId": "UpdateTodo",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/ReplaceTodoRequestContent"
+                "$ref": "#/components/schemas/UpdateTodoRequestContent"
               }
             }
-          },
-          "required": true
+          }
         },
         "parameters": [
           {
@@ -18398,11 +18397,11 @@
         ],
         "responses": {
           "200": {
-            "description": "ReplaceTodo 200 response",
+            "description": "UpdateTodo 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ReplaceTodoResponseContent"
+                  "$ref": "#/components/schemas/UpdateTodoResponseContent"
                 }
               }
             }
@@ -18472,10 +18471,6 @@
             429,
             503
           ]
-        },
-        "x-basecamp-write-semantics": {
-          "mode": "replace",
-          "clearsOmitted": true
         }
       }
     },
@@ -23584,7 +23579,22 @@
             "type": "array",
             "items": {
               "$ref": "#/components/schemas/Notification"
-            }
+            },
+            "description": "Legacy \"save forever\" collection. Observed BC5 behavior: emits `[]`\nwhile BC4 still populates with real items — the BC team has not yet\nresolved whether to keep BC4-shaped data on BC5 (back-compat) or to\naccept the empty-array break with a documented BC5 changelog entry.\nSee COORDINATION.md for the open decision. The conceptual\nreplacement is `bubble_ups` (with optional scheduling via\n`scheduled_bubble_ups`), though wire shapes are not interchangeable\nper-item, so cross-version readers should consume both."
+          },
+          "bubble_ups": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Notification"
+            },
+            "description": "Items the user has saved with Bubble Up (BC5 addition). Roughly the\nsuccessor to `memories` but with optional scheduling — see\n`scheduled_bubble_ups` for the time-deferred subset."
+          },
+          "scheduled_bubble_ups": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Notification"
+            },
+            "description": "Bubble Ups scheduled to resurface in the future (BC5 addition)."
           }
         }
       },
@@ -24694,6 +24704,19 @@
           "memory_url": {
             "type": "string"
           },
+          "bubble_up_url": {
+            "type": "string",
+            "description": "URL for the Bubble Up record covering this notification (BC5 addition).\nEligibility-gated — only present on items the current user can bubble up."
+          },
+          "bubble_up_at": {
+            "type": "string",
+            "description": "Scheduled resurfacing time when this item is queued as a scheduled\nBubble Up (BC5 addition). Absent when there is no scheduled time.",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
           "subscription_url": {
             "type": "string"
           },
@@ -24840,6 +24863,15 @@
               "redact": false
             }
           },
+          "tagline": {
+            "type": "string",
+            "description": "Alias of `bio` introduced in BC5. BC3 emits both keys with identical content;\nolder BC4 responses may omit `tagline`. Prefer `bio` for cross-version reads.",
+            "format": "password",
+            "x-basecamp-sensitive": {
+              "category": "pii",
+              "redact": false
+            }
+          },
           "location": {
             "type": "string",
             "format": "password",
@@ -25037,12 +25069,6 @@
           "purpose": {
             "type": "string"
           },
-          "start_date": {
-            "type": "string"
-          },
-          "end_date": {
-            "type": "string"
-          },
           "clients_enabled": {
             "type": "boolean"
           },
@@ -25659,57 +25685,6 @@
           "url"
         ]
       },
-      "ReplaceTodoRequestContent": {
-        "type": "object",
-        "properties": {
-          "content": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "assignee_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "completion_subscriber_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "notify": {
-            "type": "boolean",
-            "x-go-type-skip-optional-pointer": false
-          },
-          "due_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          },
-          "starts_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          }
-        },
-        "required": [
-          "content"
-        ]
-      },
-      "ReplaceTodoResponseContent": {
-        "$ref": "#/components/schemas/Todo"
-      },
       "RepositionCardStepRequestContent": {
         "type": "object",
         "properties": {
@@ -26482,6 +26457,13 @@
           },
           "boosts_url": {
             "type": "string"
+          },
+          "steps": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CardStep"
+            },
+            "description": "Steps embedded in the Todo response (BC5 addition). The shared\n`steps/step` jbuilder partial emits the same shape as `CardStep`,\nso the existing `CardStepList` is reused."
           }
         },
         "required": [
@@ -26878,6 +26860,24 @@
           },
           "app_todolists_url": {
             "type": "string"
+          },
+          "todos_count": {
+            "type": "integer",
+            "description": "Total count of todos across all todolists in this todoset (BC5 addition).",
+            "format": "int32"
+          },
+          "completed_loose_todos_count": {
+            "type": "integer",
+            "description": "Count of completed loose todos at the todoset level (BC5 addition).",
+            "format": "int32"
+          },
+          "todos_url": {
+            "type": "string",
+            "description": "API URL for listing todos directly under this todoset (BC5 addition)."
+          },
+          "app_todos_url": {
+            "type": "string",
+            "description": "In-app URL for viewing the todoset's todos (BC5 addition)."
           }
         },
         "required": [
@@ -27454,6 +27454,54 @@
       "UpdateTimesheetEntryResponseContent": {
         "$ref": "#/components/schemas/TimesheetEntry"
       },
+      "UpdateTodoRequestContent": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "assignee_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "completion_subscriber_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "notify": {
+            "type": "boolean",
+            "x-go-type-skip-optional-pointer": false
+          },
+          "due_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
+          "starts_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          }
+        }
+      },
+      "UpdateTodoResponseContent": {
+        "$ref": "#/components/schemas/Todo"
+      },
       "UpdateTodolistOrGroupRequestContent": {
         "type": "object",
         "properties": {
diff --git a/spec/api-provenance.json b/spec/api-provenance.json
index a4a62cea1..ad2ef0b78 100644
--- a/spec/api-provenance.json
+++ b/spec/api-provenance.json
@@ -1,6 +1,14 @@
 {
   "bc3": {
+    "branch": "master",
     "revision": "e52453ff35a6292473eb095a8568649aa132fef9",
     "date": "2026-07-17"
+  },
+  "compatibility": {
+    "bc3-four": {
+      "branch": "four",
+      "revision": "9d73959a62538bbd2d474fbf806ce386bb4092a8",
+      "date": "2026-06-12"
+    }
   }
 }
diff --git a/spec/basecamp.smithy b/spec/basecamp.smithy
index 8aaab5a92..1d742ee0d 100644
--- a/spec/basecamp.smithy
+++ b/spec/basecamp.smithy
@@ -1257,6 +1257,11 @@ structure Todo {
   completion_url: String
   boosts_count: Integer
   boosts_url: String
+
+  /// Steps embedded in the Todo response (BC5 addition). The shared
+  /// `steps/step` jbuilder partial emits the same shape as `CardStep`,
+  /// so the existing `CardStepList` is reused.
+  steps: CardStepList
 }
 
 structure TodoParent {
@@ -1301,6 +1306,11 @@ structure Person {
   @basecampSensitive(category: "pii", redact: false)
   bio: PersonBio
 
+  /// Alias of `bio` introduced in BC5. BC3 emits both keys with identical content;
+  /// older BC4 responses may omit `tagline`. Prefer `bio` for cross-version reads.
+  @basecampSensitive(category: "pii", redact: false)
+  tagline: PersonBio
+
   @basecampSensitive(category: "pii", redact: false)
   location: PersonLocation
 
@@ -1373,6 +1383,18 @@ structure Todoset {
   completed_ratio: String
   completed: Boolean
   app_todolists_url: String
+
+  /// Total count of todos across all todolists in this todoset (BC5 addition).
+  todos_count: Integer
+
+  /// Count of completed loose todos at the todoset level (BC5 addition).
+  completed_loose_todos_count: Integer
+
+  /// API URL for listing todos directly under this todoset (BC5 addition).
+  todos_url: String
+
+  /// In-app URL for viewing the todoset's todos (BC5 addition).
+  app_todos_url: String
 }
 
 // ===== Todolist Shapes =====
@@ -8165,7 +8187,24 @@ structure GetMyNotificationsInput {
 structure GetMyNotificationsOutput {
   unreads: NotificationList
   reads: NotificationList
+
+  /// Legacy "save forever" collection. Observed BC5 behavior: emits `[]`
+  /// while BC4 still populates with real items — the BC team has not yet
+  /// resolved whether to keep BC4-shaped data on BC5 (back-compat) or to
+  /// accept the empty-array break with a documented BC5 changelog entry.
+  /// See COORDINATION.md for the open decision. The conceptual
+  /// replacement is `bubble_ups` (with optional scheduling via
+  /// `scheduled_bubble_ups`), though wire shapes are not interchangeable
+  /// per-item, so cross-version readers should consume both.
   memories: NotificationList
+
+  /// Items the user has saved with Bubble Up (BC5 addition). Roughly the
+  /// successor to `memories` but with optional scheduling — see
+  /// `scheduled_bubble_ups` for the time-deferred subset.
+  bubble_ups: NotificationList
+
+  /// Bubble Ups scheduled to resurface in the future (BC5 addition).
+  scheduled_bubble_ups: NotificationList
 }
 
 /// Mark specified items as read
@@ -8223,6 +8262,15 @@ structure Notification {
   unread_url: String
   bookmark_url: String
   memory_url: String
+
+  /// URL for the Bubble Up record covering this notification (BC5 addition).
+  /// Eligibility-gated — only present on items the current user can bubble up.
+  bubble_up_url: String
+
+  /// Scheduled resurfacing time when this item is queued as a scheduled
+  /// Bubble Up (BC5 addition). Absent when there is no scheduled time.
+  bubble_up_at: ISO8601Timestamp
+
   subscription_url: String
   subscribed: Boolean
   previewable_attachments: PreviewableAttachmentList
diff --git a/spec/bucket-scoped-allowlist.txt b/spec/bucket-scoped-allowlist.txt
new file mode 100644
index 000000000..98ccba0e5
--- /dev/null
+++ b/spec/bucket-scoped-allowlist.txt
@@ -0,0 +1,8 @@
+# Bucket-scoped list operations that legitimately have no flat counterpart.
+# One path-pattern per line. Format must match the OpenAPI path exactly.
+# Each entry should have a justification comment immediately above it.
+# Read by scripts/check-bucket-flat-parity.sh.
+
+# Webhooks are inherently per-project: a webhook subscribes to events scoped
+# to a single project, so there is no meaningful account-wide aggregate.
+/{accountId}/buckets/{bucketId}/webhooks.json

From a7576354130fdcc4fa6bbc69be9141e07aed35f4 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:20:43 -0700
Subject: [PATCH 02/16] build(make): add generate aggregator, parity lint,
 branch-aware sync-status
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* make generate — single command to regenerate every machine-derived
  artifact in the repo (Smithy, behavior model, URL routes, provenance,
  per-language SDKs) in dependency order.

* make check-bucket-flat-parity — new lint that scans openapi.json for
  GET /{accountId}/buckets/{bucketId}/<resource>(/...).json list
  operations and verifies each has a flat counterpart at
  /{accountId}/<resource>.json (or is justified in
  spec/bucket-scoped-allowlist.txt). Cross-project SDK consumers
  shouldn't have to walk every project to query account-wide data.

* make sync-status — reads .bc3.branch and reports drift for the active
  branch (now five) and the compatibility branch (master) as two
  clearly-labeled blocks via scripts/report-bc3-drift.sh, instead of
  silently mixing them under HEAD.

* make validate-api-gaps target wired into make check (script lands in
  the api-gaps registry commit).
---
 .gitignore                          |   1 +
 Makefile                            |  61 ++++++++++++----
 scripts/check-bucket-flat-parity.sh | 107 ++++++++++++++++++++++++++++
 scripts/report-bc3-drift.sh         |  37 ++++++++++
 4 files changed, 191 insertions(+), 15 deletions(-)
 create mode 100755 scripts/check-bucket-flat-parity.sh
 create mode 100755 scripts/report-bc3-drift.sh

diff --git a/.gitignore b/.gitignore
index dd2daac44..92d3ce204 100644
--- a/.gitignore
+++ b/.gitignore
@@ -45,6 +45,7 @@ typescript/coverage/
 
 # Kotlin SDK build artifacts
 kotlin/.gradle/
+kotlin/.kotlin/
 kotlin/build/
 kotlin/sdk/build/
 kotlin/generator/build/
diff --git a/Makefile b/Makefile
index 3519166c7..4324add56 100644
--- a/Makefile
+++ b/Makefile
@@ -104,20 +104,17 @@ BC3_REPO ?= basecamp/bc3
 sync-status:
 	@command -v gh > /dev/null 2>&1 || { echo "ERROR: gh CLI not found. Install: https://cli.github.com"; exit 1; }
 	@gh auth status > /dev/null 2>&1 || { echo "ERROR: gh not authenticated. Run: gh auth login"; exit 1; }
-	@REV=$$(jq -r '.bc3.revision // empty' spec/api-provenance.json); \
-	if [ -z "$$REV" ]; then \
-		echo "==> bc3 API docs: no baseline revision set"; \
+	@./scripts/report-bc3-drift.sh \
+		"$$(jq -r '.bc3.revision // empty' spec/api-provenance.json)" \
+		"$$(jq -r '.bc3.branch // "master"' spec/api-provenance.json)" \
+		"primary"
+	@COMPAT_REV=$$(jq -r '.compatibility["bc3-master"].revision // empty' spec/api-provenance.json); \
+	if [ -n "$$COMPAT_REV" ]; then \
 		echo ""; \
-		echo "==> bc3 API implementation: no baseline revision set"; \
-	else \
-		SHORT_REV=$$(echo $$REV | cut -c1-7); \
-		echo "==> bc3 API docs changes since last sync ($$SHORT_REV):"; \
-		gh api "repos/$(BC3_REPO)/compare/$$REV...HEAD" \
-			--jq '[.files[] | select(.filename | startswith("doc/api/"))] | if length == 0 then "  (no changes in doc/api/)" else .[] | "  " + .status[:1] + " " + .filename end'; \
-		echo ""; \
-		echo "==> bc3 API implementation changes since last sync ($$SHORT_REV):"; \
-		gh api "repos/$(BC3_REPO)/compare/$$REV...HEAD" \
-			--jq '[.files[] | select(.filename | startswith("app/controllers/"))] | if length == 0 then "  (no changes in app/controllers/)" else .[] | "  " + .status[:1] + " " + .filename end'; \
+		./scripts/report-bc3-drift.sh \
+			"$$COMPAT_REV" \
+			"$$(jq -r '.compatibility["bc3-master"].branch // "master"' spec/api-provenance.json)" \
+			"compat"; \
 	fi
 
 #------------------------------------------------------------------------------
@@ -588,12 +585,45 @@ tools:
 	@command -v swift >/dev/null 2>&1 || echo "NOTE: swift is optional (macOS: xcode-select --install, Arch: yay -S swift-bin)"
 	@echo "==> Done"
 
+#------------------------------------------------------------------------------
+# Spec-shape lints
+#------------------------------------------------------------------------------
+
+.PHONY: check-bucket-flat-parity validate-api-gaps
+
+# Verify every bucket-scoped GET list operation has a flat-path counterpart
+# (or is justified in spec/bucket-scoped-allowlist.txt). Cross-project SDK
+# consumers shouldn't need to enumerate projects to reach account-wide data.
+check-bucket-flat-parity:
+	@./scripts/check-bucket-flat-parity.sh
+
+# Validate spec/api-gaps/ entry frontmatter, required body sections, and allowlist.
+validate-api-gaps:
+	@./scripts/validate-api-gaps.sh
+
 #------------------------------------------------------------------------------
 # Combined targets
 #------------------------------------------------------------------------------
 
+.PHONY: generate
+
+# Regenerate every machine-derived artifact in the repo, in dependency order.
+# Run after editing spec/basecamp.smithy or spec/api-provenance.json.
+# Sequential phases via sub-makes so language generators don't run in
+# parallel against a stale openapi.json under `make -j`.
+generate:
+	@$(MAKE) smithy-build
+	@$(MAKE) behavior-model url-routes provenance-sync
+	@$(MAKE) ts-generate ts-generate-services \
+	         rb-generate rb-generate-services \
+	         py-generate \
+	         kt-generate-services \
+	         swift-generate
+	@$(MAKE) -C go generate
+	@echo "==> Generation complete"
+
 # Run all checks (Smithy + Go + TypeScript + Ruby + Kotlin + Swift + Python + Behavior Model + Conformance + Provenance + Actions lint)
-check: lint-actions sync-spec-version-check smithy-check behavior-model-check provenance-check sync-api-version-check go-check-drift auth-routable-check kt-check-drift go-check ts-check rb-check kt-check swift-check py-check conformance
+check: lint-actions sync-spec-version-check smithy-check behavior-model-check provenance-check sync-api-version-check go-check-drift auth-routable-check kt-check-drift go-check ts-check rb-check kt-check swift-check py-check conformance check-bucket-flat-parity validate-api-gaps
 	@echo "==> All checks passed"
 
 # Clean all build artifacts
@@ -699,6 +729,7 @@ help:
 	@echo "  tools            Install development tools (smithy, golangci-lint, actionlint, zizmor)"
 	@echo ""
 	@echo "Combined:"
-	@echo "  check            Run all checks (Smithy + behavior-model/drift + Go + TypeScript + Ruby + Swift + Kotlin + Python + Conformance + Provenance + API version sync + Actions lint)"
+	@echo "  generate         Regenerate every machine-derived artifact (Smithy + per-language SDKs + provenance)"
+	@echo "  check            Run all checks (Smithy + behavior-model/drift + Go + TypeScript + Ruby + Swift + Kotlin + Python + Conformance + Provenance + API version sync + parity lint + api-gaps + Actions lint)"
 	@echo "  clean            Remove all build artifacts"
 	@echo "  help             Show this help"
diff --git a/scripts/check-bucket-flat-parity.sh b/scripts/check-bucket-flat-parity.sh
new file mode 100755
index 000000000..e563f712a
--- /dev/null
+++ b/scripts/check-bucket-flat-parity.sh
@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+# Bucket↔flat parity lint.
+#
+# For every GET /{accountId}/buckets/{bucketId}/<resource>(/{filter})?.json operation
+# whose response is a list, check that a flat counterpart at
+# /{accountId}/<resource>(/{filter})?.json exists. If not, the path must be
+# entered in spec/bucket-scoped-allowlist.txt with a justification.
+#
+# Cross-project SDK consumers shouldn't have to walk every project to query
+# resources that already exist account-wide. Catching this early at the spec
+# layer prevents bucket-only collections from shipping by accident.
+#
+# Allowlist format: one bucket path-pattern per line. Comments (lines starting
+# with `#`) and blank lines are ignored. Each entry should have a justification
+# comment on the line immediately above it.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+SPEC="${1:-$PROJECT_ROOT/openapi.json}"
+ALLOWLIST="${2:-$PROJECT_ROOT/spec/bucket-scoped-allowlist.txt}"
+
+if [ ! -f "$SPEC" ]; then
+  echo "ERROR: openapi spec not found at $SPEC" >&2
+  exit 2
+fi
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "ERROR: jq is required" >&2
+  exit 2
+fi
+
+# Build the set of allowlisted patterns.
+ALLOWED=""
+if [ -f "$ALLOWLIST" ]; then
+  ALLOWED=$(grep -Ev '^\s*(#|$)' "$ALLOWLIST" || true)
+fi
+
+# Find candidate bucket-scoped GET list operations and their expected flat paths.
+# A "list" response is a top-level array (recursively resolving $ref one level).
+# jq exits non-zero for invalid OpenAPI / broken filter — let it fail loud rather
+# than silently turning bad input into "0 operations found".
+CANDIDATES=$(jq -r --slurpfile spec "$SPEC" '
+  $spec[0] as $s
+  | $s.paths
+  | to_entries[]
+  | select(.key | test("^/\\{accountId\\}/buckets/\\{bucketId\\}/[^/]+(/\\{[^}]+\\})?\\.json$"))
+  | select(.value.get != null)
+  | . as $entry
+  | (
+      $entry.value.get.responses["200"].content["application/json"].schema as $rs
+      | if $rs == null then null
+        elif $rs["$ref"] then
+          ($rs["$ref"] | sub("^#/components/schemas/"; "")) as $name
+          | $s.components.schemas[$name]
+        else $rs end
+    ) as $resolved
+  | select($resolved.type == "array")
+  | $entry.key
+' "$SPEC")
+
+if [ -z "$CANDIDATES" ]; then
+  echo "==> Bucket↔flat parity: 0 bucket-scoped list operations found"
+  exit 0
+fi
+
+VIOLATIONS=""
+COUNT=0
+while IFS= read -r BUCKET_PATH; do
+  [ -z "$BUCKET_PATH" ] && continue
+  COUNT=$((COUNT + 1))
+
+  # Compute the flat path: strip /buckets/{bucketId} from the bucket path.
+  FLAT_PATH=$(echo "$BUCKET_PATH" | sed 's|/buckets/{bucketId}||')
+
+  # Already covered by a flat sibling?
+  if jq -e --arg p "$FLAT_PATH" '.paths[$p].get != null' "$SPEC" >/dev/null 2>&1; then
+    continue
+  fi
+
+  # Allowlisted?
+  if echo "$ALLOWED" | grep -Fxq "$BUCKET_PATH"; then
+    continue
+  fi
+
+  VIOLATIONS="${VIOLATIONS}${BUCKET_PATH}|${FLAT_PATH}
+"
+done <<< "$CANDIDATES"
+
+echo "==> Bucket↔flat parity: scanned $COUNT bucket-scoped list operation(s)"
+
+if [ -n "$VIOLATIONS" ]; then
+  echo ""
+  echo "ERROR: bucket-scoped list operations without a flat counterpart:" >&2
+  while IFS='|' read -r BP FP; do
+    [ -z "$BP" ] && continue
+    echo "  $BP" >&2
+    echo "    expected flat path: $FP" >&2
+  done <<< "$VIOLATIONS"
+  echo "" >&2
+  echo "Either add the flat path to the spec, or add the bucket path to" >&2
+  echo "$ALLOWLIST with a justification comment immediately above the entry." >&2
+  exit 1
+fi
+
+echo "Bucket↔flat parity is clean"
diff --git a/scripts/report-bc3-drift.sh b/scripts/report-bc3-drift.sh
new file mode 100755
index 000000000..e673fd3b2
--- /dev/null
+++ b/scripts/report-bc3-drift.sh
@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Report drift between a baseline bc3 revision and the head of a branch.
+# Usage: report-bc3-drift.sh <revision> <branch> <label>
+#
+# label is one of:
+#   primary  — block we sync against (printed as "bc3 (<branch>) ...")
+#   compat   — additional compatibility tracking block
+set -euo pipefail
+
+REV="${1:-}"
+BRANCH="${2:-master}"
+LABEL="${3:-primary}"
+BC3_REPO="${BC3_REPO:-basecamp/bc3}"
+
+case "$LABEL" in
+  primary) HEADER="bc3 (active branch: $BRANCH)" ;;
+  compat)  HEADER="bc3 compatibility (branch: $BRANCH)" ;;
+  *)       HEADER="bc3 ($BRANCH)" ;;
+esac
+
+if [ -z "$REV" ]; then
+  echo "==> $HEADER API docs: no baseline revision set"
+  echo ""
+  echo "==> $HEADER API implementation: no baseline revision set"
+  exit 0
+fi
+
+SHORT_REV="${REV:0:7}"
+
+echo "==> $HEADER API docs changes since last sync ($SHORT_REV..$BRANCH):"
+gh api "repos/$BC3_REPO/compare/$REV...$BRANCH" \
+  --jq '[.files[] | select(.filename | startswith("doc/api/"))] | if length == 0 then "  (no changes in doc/api/)" else .[] | "  " + .status[:1] + " " + .filename end'
+
+echo ""
+echo "==> $HEADER API implementation changes since last sync ($SHORT_REV..$BRANCH):"
+gh api "repos/$BC3_REPO/compare/$REV...$BRANCH" \
+  --jq '[.files[] | select(.filename | startswith("app/controllers/") or startswith("app/views/api/"))] | if length == 0 then "  (no changes in app/controllers/ or app/views/api/)" else .[] | "  " + .status[:1] + " " + .filename end'

From d8c18476fe28126b90201c57f9b061dcb1bc54d0 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:02 -0700
Subject: [PATCH 03/16] =?UTF-8?q?docs(api-gaps):=20API=20gap=20registry=20?=
 =?UTF-8?q?+=20SDK=E2=86=94BC3=20coordination=20+=20validator?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The SDK is the client-side demand signal for BC3 API coverage. spec/api-gaps/
is a durable, schema-validated registry: each entry tracks one BC5
user-visible feature that ships without (or with incomplete) JSON API
coverage, paired with the BC3 parity plan that owns server-side delivery.
Status changes flow through git history, making the absorption journey
publicly auditable.

Initial registry (11 entries aligned with BC3 plan Phase 3 deliverables):

* calendar — show/update only
* scratchpad — URL path deferred by BC3 plan
* step-top-level — doc-only addition (existing partial)
* everything-aggregates — Phase 3c flat top-level recording listings (~22)
* activity-timeline — /activity (global) + /projects/:id/timeline
* recordable-subtypes-doc — Journal, CloudFile, GoogleDocument; Door excluded
  (read paths + create operations per BC3 Phase 3a)
* stack-doc-and-smithy — full CRUD + list collectables
* search-filter-additions — additive filter params
* rich-text-project-attachable — Project as Attachable
* recording-bubbleupable-field — additive boolean
* todoset-completed-list-visibility — pending BC3 classification

Tooling:
* spec/api-gaps/schema.json + allowlist-schema.json validate frontmatter
* allowlist.yml records routes that don't warrant a registry entry
  (transient nav state, duplicates already covered elsewhere)
* scripts/validate-api-gaps.{sh,rb} — Ruby stdlib only, no gem deps

COORDINATION.md (root) describes the SDK ↔ BC3 plan relationship and the
absorption lifecycle for anyone reading the SDK repo cold.

CONTRIBUTING.md picks up the api-gaps section, the parity lint section,
and points at make generate as the single command to regenerate
everything.
---
 CONTRIBUTING.md                               |  49 +++-
 COORDINATION.md                               |  56 +++++
 scripts/validate-api-gaps.rb                  | 233 ++++++++++++++++++
 scripts/validate-api-gaps.sh                  |  14 ++
 spec/api-gaps/README.md                       |  81 ++++++
 spec/api-gaps/activity-timeline.md            |  70 ++++++
 spec/api-gaps/allowlist-schema.json           |  36 +++
 spec/api-gaps/allowlist.yml                   |  29 +++
 spec/api-gaps/calendar.md                     |  64 +++++
 spec/api-gaps/everything-aggregates.md        |  91 +++++++
 spec/api-gaps/recordable-subtypes-doc.md      | 112 +++++++++
 spec/api-gaps/recording-bubbleupable-field.md |  57 +++++
 spec/api-gaps/rich-text-project-attachable.md |  53 ++++
 spec/api-gaps/schema.json                     |  59 +++++
 spec/api-gaps/scratchpad.md                   |  67 +++++
 spec/api-gaps/search-filter-additions.md      |  65 +++++
 spec/api-gaps/stack-doc-and-smithy.md         |  75 ++++++
 spec/api-gaps/step-top-level.md               |  68 +++++
 .../todoset-completed-list-visibility.md      |  63 +++++
 19 files changed, 1339 insertions(+), 3 deletions(-)
 create mode 100644 COORDINATION.md
 create mode 100755 scripts/validate-api-gaps.rb
 create mode 100755 scripts/validate-api-gaps.sh
 create mode 100644 spec/api-gaps/README.md
 create mode 100644 spec/api-gaps/activity-timeline.md
 create mode 100644 spec/api-gaps/allowlist-schema.json
 create mode 100644 spec/api-gaps/allowlist.yml
 create mode 100644 spec/api-gaps/calendar.md
 create mode 100644 spec/api-gaps/everything-aggregates.md
 create mode 100644 spec/api-gaps/recordable-subtypes-doc.md
 create mode 100644 spec/api-gaps/recording-bubbleupable-field.md
 create mode 100644 spec/api-gaps/rich-text-project-attachable.md
 create mode 100644 spec/api-gaps/schema.json
 create mode 100644 spec/api-gaps/scratchpad.md
 create mode 100644 spec/api-gaps/search-filter-additions.md
 create mode 100644 spec/api-gaps/stack-doc-and-smithy.md
 create mode 100644 spec/api-gaps/step-top-level.md
 create mode 100644 spec/api-gaps/todoset-completed-list-visibility.md

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c9083c682..fb123f147 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -208,12 +208,14 @@ All SDKs are generated from a single Smithy specification. When adding support f
    - Define the resource, operations, and shapes
    - Follow patterns from existing resources (e.g., `Project`, `Todo`)
 
-2. **Regenerate the OpenAPI spec**
+2. **Regenerate everything** in one step:
    ```bash
-   make smithy-build
+   make generate
    ```
 
-3. **Run per-SDK generators** to update generated service code:
+   This runs Smithy build, behavior model, URL routes, provenance sync, and per-language generators (TypeScript, Ruby, Python, Kotlin, Swift, Go) in dependency order.
+
+3. **Run per-SDK generators individually** if you only need one:
    - **Go:** `make go-check-drift` — Go services are hand-written wrappers around the generated client; the drift check verifies all generated operations are covered
    - **TypeScript:** `make ts-generate-services`
    - **Ruby:** `make rb-generate-services`
@@ -229,6 +231,47 @@ All SDKs are generated from a single Smithy specification. When adding support f
    - Add to the services table in each SDK's README
    - Add to CHANGELOG under `[Unreleased]`
 
+## Spec-shape lints
+
+The repo enforces a small set of structural invariants on the OpenAPI spec
+beyond the language-specific drift checks. These run as part of `make check`:
+
+- **Bucket↔flat parity** (`make check-bucket-flat-parity`): every
+  `GET /{accountId}/buckets/{bucketId}/<resource>(/...).json` list operation
+  must have a flat counterpart at `/{accountId}/<resource>.json`, or be
+  justified in [`spec/bucket-scoped-allowlist.txt`](spec/bucket-scoped-allowlist.txt).
+  The intent is that cross-project SDK consumers shouldn't have to walk every
+  project to query account-wide resources.
+
+  When adding a bucket-scoped list endpoint, either add the matching flat
+  endpoint or append a one-line entry to the allowlist with a justification
+  comment.
+
+## API gap registry (`spec/api-gaps/`)
+
+When BC ships a new user-visible feature without a JSON API (or with an
+incomplete one), add an entry under [`spec/api-gaps/`](spec/api-gaps/).
+The registry is the SDK side of the [BC3 API parity coordination](COORDINATION.md):
+the BC3 plan owns server-side delivery; the registry tracks the gap from
+detection through absorption, with status changes in git history.
+
+To add a new entry:
+
+1. Copy an existing entry in `spec/api-gaps/` as a template.
+2. Set frontmatter status to `no-json-contract` (or `partial-coverage` /
+   `ambiguous` as appropriate). See
+   [`spec/api-gaps/schema.json`](spec/api-gaps/schema.json) for valid
+   statuses.
+3. Add a row to the table in
+   [`spec/api-gaps/README.md`](spec/api-gaps/README.md).
+4. Run `make validate-api-gaps` to confirm frontmatter and required body
+   sections are well-formed. Wired into `make check`.
+
+For routes that should *not* warrant an entry (transient nav state, internal
+endpoints, duplicates of a route already covered elsewhere), add a record
+to [`spec/api-gaps/allowlist.yml`](spec/api-gaps/allowlist.yml) with a
+justification.
+
 ## Reporting Issues
 
 - Use GitHub Issues for bug reports and feature requests
diff --git a/COORDINATION.md b/COORDINATION.md
new file mode 100644
index 000000000..bf4cca352
--- /dev/null
+++ b/COORDINATION.md
@@ -0,0 +1,56 @@
+# Coordination: SDK ↔ BC3 API Parity for BC5
+
+This SDK works in lockstep with the BC3 API parity plan, tracked on the
+`basecamp/bc3` `five+api` branch. The authoritative server-side audit lives
+in that branch under `tmp/api_audit.md` (generated by the BC3 plan's
+`script/api/audit`).
+
+## Division of labor
+
+- **BC3 plan owns**: server-side audit, jbuilder + controller + doc
+  additions, BC4 compat verification, regenerating live-server doc
+  snapshots, eventually opening Smithy PRs in this repo.
+- **This SDK plan owns**: live canary against both backends, schema +
+  pairwise validation on raw wire bytes, additive Smithy absorption per
+  BC3 deliverable, the API-gap detector that catches anything BC3 hasn't
+  registered, the bucket-flat parity lint, the API gap registry at
+  [`spec/api-gaps/`](spec/api-gaps/).
+
+## Lifecycle per gap
+
+1. BC3 plan inventories a gap (Phase 1 audit) → SDK adds a corresponding
+   entry in [`spec/api-gaps/`](spec/api-gaps/).
+2. BC3 ships the JSON API for the gap → SDK canary auto-detects new
+   fields/endpoints.
+3. SDK opens a Smithy + per-language regeneration PR absorbing the new
+   contract.
+4. Entry frontmatter updates: `status: addressed-in-bc3-pr-N` then
+   `status: absorbed-in-sdk` with Smithy refs.
+
+## Contract decisions (cross-team)
+
+Two items the SDK canary surfaced that need product/API leadership decisions:
+
+1. `memories` going to `[]` on `GET /my/readings.json` — back-compat or
+   accept-and-document. BC4 populates the array; BC5 emits literal `[]`.
+   Existing BC4 API users reading `memories` would silently see no data on
+   BC5 — a subtractive change disguised as compatible.
+2. Longstanding `app_todoslists_url` typo at
+   `app/views/api/todosets/_todoset.json.jbuilder:28` — server fix, alias
+   period, or SDK accommodation. The SDK spec models the correctly-spelled
+   `app_todolists_url`, so SDK clients reading that field have always seen
+   `null`.
+
+Both are tracked in the BC3 plan's Phase 2 compat verification and this
+SDK plan's §8.
+
+## Where to look
+
+- BC3-side authoritative inventory: `tmp/api_audit.md` (generated by BC3
+  plan's `script/api/audit`)
+- SDK-side absorption status: [`spec/api-gaps/README.md`](spec/api-gaps/README.md)
+- Live canary results: `make check-bc5-compat` against current refs
+  (lands in PR 4 of the SDK plan)
+- Cross-team alignment status: this file
+
+— The basecamp-sdk team
diff --git a/scripts/validate-api-gaps.rb b/scripts/validate-api-gaps.rb
new file mode 100755
index 000000000..0ecec3e7f
--- /dev/null
+++ b/scripts/validate-api-gaps.rb
@@ -0,0 +1,233 @@
+#!/usr/bin/env ruby
+# Validates spec/api-gaps/*.md frontmatter and required body sections,
+# and spec/api-gaps/allowlist.yml against its schema.
+# Uses stdlib only (yaml, json) — no gem dependencies.
+
+require "date"
+require "json"
+require "yaml"
+
+GAPS_DIR = ARGV.fetch(0) { "spec/api-gaps" }
+SCHEMA_FILE = File.join(GAPS_DIR, "schema.json")
+ALLOWLIST_FILE = File.join(GAPS_DIR, "allowlist.yml")
+ALLOWLIST_SCHEMA_FILE = File.join(GAPS_DIR, "allowlist-schema.json")
+
+REQUIRED_BODY_SECTIONS = [
+  "## What's missing",
+  "## Why it matters",
+  "## Suggested API shape",
+  "## Implementation notes for BC3",
+  "## SDK absorption plan when this lands"
+].freeze
+
+errors = []
+
+def add_error(errors, file, message)
+  errors << "#{file}: #{message}"
+end
+
+# --- Frontmatter validators ----------------------------------------------------
+
+unless File.file?(SCHEMA_FILE)
+  warn "ERROR: schema not found at #{SCHEMA_FILE}"
+  exit 2
+end
+
+schema = JSON.parse(File.read(SCHEMA_FILE))
+required_fields = schema.dig("required") || []
+known_fields = schema.dig("properties")&.keys || []
+additional_strict = schema["additionalProperties"] == false
+status_alts = schema.dig("properties", "status", "oneOf") || []
+status_enum = status_alts.flat_map { |alt| alt["enum"] || [] }
+status_pattern = status_alts.find { |alt| alt["pattern"] }&.dig("pattern")
+date_pattern = schema.dig("properties", "detected", "pattern")
+
+def parse_frontmatter(path)
+  content = File.read(path)
+  return [nil, content, "missing leading frontmatter delimiter"] unless content.start_with?("---\n")
+
+  rest = content[4..]
+  end_idx = rest.index("\n---\n")
+  return [nil, content, "missing closing frontmatter delimiter"] unless end_idx
+
+  yaml_text = rest[0...end_idx]
+  body = rest[(end_idx + 5)..]
+  begin
+    [YAML.safe_load(yaml_text, permitted_classes: [Date, Time]), body, nil]
+  rescue Psych::SyntaxError => e
+    [nil, body, "YAML parse error: #{e.message}"]
+  end
+end
+
+def validate_frontmatter(meta, file, required_fields, known_fields, additional_strict, status_enum, status_pattern, date_pattern, errors, expected_gap)
+  unless meta.is_a?(Hash)
+    add_error(errors, file, "frontmatter is not a mapping")
+    return
+  end
+
+  required_fields.each do |field|
+    unless meta.key?(field)
+      add_error(errors, file, "missing required frontmatter field: #{field}")
+    end
+  end
+
+  if additional_strict
+    extra = meta.keys - known_fields
+    extra.each do |k|
+      add_error(errors, file, "unknown frontmatter field: #{k} (schema declares additionalProperties: false)")
+    end
+  end
+
+  if (gap = meta["gap"]) && expected_gap && gap != expected_gap
+    add_error(errors, file, "frontmatter gap=#{gap.inspect} does not match filename #{expected_gap.inspect}")
+  end
+
+  if (status = meta["status"])
+    unless status.is_a?(String)
+      add_error(errors, file, "status must be a string, got #{status.class}: #{status.inspect}")
+      return
+    end
+    valid = status_enum.include?(status) || (status_pattern && status.match?(Regexp.new(status_pattern)))
+    unless valid
+      add_error(errors, file, "status #{status.inspect} not in enum and does not match pattern")
+    end
+
+    case status
+    when "absorbed-in-sdk"
+      smithy_refs = meta["smithy_refs"]
+      if !smithy_refs.is_a?(Array) || smithy_refs.empty?
+        add_error(errors, file, "status=absorbed-in-sdk requires non-empty smithy_refs array")
+      end
+    when "confirmed-not-api-resource"
+      section = meta.dig("bc3_refs", "bc3_plan_section")
+      unless section.is_a?(String) && !section.empty?
+        add_error(errors, file, "status=confirmed-not-api-resource requires bc3_refs.bc3_plan_section")
+      end
+    when /\Aaddressed-in-bc3-pr-\d+\z/
+      pr = meta["bc3_pr"]
+      if pr.nil? || pr.to_s.empty?
+        add_error(errors, file, "status=#{status} requires bc3_pr ref")
+      end
+    end
+  end
+
+  if (detected = meta["detected"]) && date_pattern && detected.to_s !~ Regexp.new(date_pattern)
+    add_error(errors, file, "detected #{detected.inspect} does not match #{date_pattern}")
+  end
+
+  bc3_refs = meta["bc3_refs"]
+  unless bc3_refs.is_a?(Hash)
+    add_error(errors, file, "bc3_refs must be a mapping")
+  end
+end
+
+def validate_body_sections(body, file, errors)
+  REQUIRED_BODY_SECTIONS.each do |section|
+    unless body.include?(section)
+      add_error(errors, file, "missing required section heading: #{section}")
+    end
+  end
+end
+
+# Find all api-gap markdown files (excluding README and archive).
+gap_files = Dir.glob(File.join(GAPS_DIR, "*.md")).reject do |path|
+  basename = File.basename(path)
+  basename == "README.md"
+end
+
+if gap_files.empty?
+  warn "WARN: no api-gap entries found in #{GAPS_DIR}"
+end
+
+gap_files.each do |path|
+  expected_gap = File.basename(path, ".md")
+  meta, body, err = parse_frontmatter(path)
+  if err
+    add_error(errors, path, err)
+    next
+  end
+  validate_frontmatter(meta, path, required_fields, known_fields, additional_strict, status_enum, status_pattern, date_pattern, errors, expected_gap)
+  validate_body_sections(body || "", path, errors)
+end
+
+# --- Allowlist validator ------------------------------------------------------
+
+if File.file?(ALLOWLIST_FILE)
+  unless File.file?(ALLOWLIST_SCHEMA_FILE)
+    add_error(errors, ALLOWLIST_FILE, "allowlist exists but allowlist-schema.json is missing at #{ALLOWLIST_SCHEMA_FILE}")
+    # Skip allowlist content validation when the schema is missing.
+    allowlist_schema = nil
+  else
+    allowlist_schema = JSON.parse(File.read(ALLOWLIST_SCHEMA_FILE))
+  end
+  allowed_keys = allowlist_schema && allowlist_schema["properties"]&.keys || []
+  begin
+    allowlist = YAML.safe_load(File.read(ALLOWLIST_FILE), permitted_classes: [Date, Time]) || {}
+  rescue Psych::SyntaxError => e
+    add_error(errors, ALLOWLIST_FILE, "YAML parse error: #{e.message}")
+    allowlist = nil
+  end
+
+  if allowlist.is_a?(Hash) && allowlist_schema
+    extra_keys = allowlist.keys - allowed_keys
+    extra_keys.each do |k|
+      add_error(errors, ALLOWLIST_FILE, "unknown top-level key: #{k}")
+    end
+
+    allowlist.each do |category, entries|
+      next unless allowed_keys.include?(category)
+      entry_schema = allowlist_schema.dig("properties", category, "items", "properties") || {}
+      required_entry_fields = allowlist_schema.dig("properties", category, "items", "required") || []
+      Array(entries).each_with_index do |entry, idx|
+        unless entry.is_a?(Hash)
+          add_error(errors, ALLOWLIST_FILE, "#{category}[#{idx}] must be a mapping")
+          next
+        end
+        required_entry_fields.each do |field|
+          unless entry.key?(field)
+            add_error(errors, ALLOWLIST_FILE, "#{category}[#{idx}] missing required field: #{field}")
+          end
+        end
+        if entry["classified"] && entry["classified"].to_s !~ /\A\d{4}-\d{2}-\d{2}\z/
+          add_error(errors, ALLOWLIST_FILE, "#{category}[#{idx}] classified date format invalid: #{entry["classified"]}")
+        end
+        extra_fields = entry.keys - entry_schema.keys
+        extra_fields.each do |k|
+          add_error(errors, ALLOWLIST_FILE, "#{category}[#{idx}] unknown field: #{k}")
+        end
+      end
+    end
+  elsif allowlist
+    add_error(errors, ALLOWLIST_FILE, "allowlist must be a mapping")
+  end
+end
+
+# --- Cross-reference: absorbed_under_other_gap covers refer to existing entries
+
+if File.file?(ALLOWLIST_FILE)
+  begin
+    allowlist = YAML.safe_load(File.read(ALLOWLIST_FILE), permitted_classes: [Date, Time]) || {}
+    Array(allowlist["absorbed_under_other_brief"]).each_with_index do |entry, idx|
+      next unless entry.is_a?(Hash)
+      cover = entry["covers_under"]
+      next if cover.nil? || cover.empty?
+      gap_path = File.join(GAPS_DIR, "#{cover}.md")
+      unless File.file?(gap_path)
+        add_error(errors, ALLOWLIST_FILE, "absorbed_under_other_brief[#{idx}].covers_under references missing entry: #{cover}.md")
+      end
+    end
+  rescue Psych::SyntaxError
+    # Already reported.
+  end
+end
+
+# --- Report ------------------------------------------------------------------
+
+if errors.empty?
+  puts "==> Validated #{gap_files.length} api-gap entr#{gap_files.length == 1 ? 'y' : 'ies'} and allowlist — clean"
+  exit 0
+else
+  warn "==> API gap validation failed:"
+  errors.each { |e| warn "  #{e}" }
+  exit 1
+end
diff --git a/scripts/validate-api-gaps.sh b/scripts/validate-api-gaps.sh
new file mode 100755
index 000000000..b436ffa24
--- /dev/null
+++ b/scripts/validate-api-gaps.sh
@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Validate spec/api-gaps/*.md frontmatter + required body sections.
+# Also validates spec/api-gaps/allowlist.yml against allowlist-schema.json.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+if ! command -v ruby >/dev/null 2>&1; then
+  echo "ERROR: ruby is required for validate-api-gaps" >&2
+  exit 2
+fi
+
+exec ruby "$SCRIPT_DIR/validate-api-gaps.rb" "$PROJECT_ROOT/spec/api-gaps"
diff --git a/spec/api-gaps/README.md b/spec/api-gaps/README.md
new file mode 100644
index 000000000..773ee00b8
--- /dev/null
+++ b/spec/api-gaps/README.md
@@ -0,0 +1,81 @@
+# API Gap Registry
+
+Each markdown file in this directory describes a BC5 user-visible feature or
+contract that ships without (or with incomplete) JSON API coverage. The
+registry is the SDK side of the [SDK ↔ BC3 coordination](../../COORDINATION.md):
+the BC3 parity plan owns server-side delivery; entries here track each gap
+from detection through absorption. Status changes flow through git history,
+making the absorption journey publicly auditable.
+
+## Lifecycle
+
+1. **Detect**: a gap is identified — by the API gap detector
+   (`make detect-api-gaps`), by editorial review of the BC3 parity plan, or
+   by an SDK consumer raising a request. A starter entry gets generated or
+   authored.
+2. **Address**: BC3 ships a JSON API contract for the gap. Entry frontmatter
+   updates to `addressed-in-bc3-pr-N`.
+3. **Absorb**: SDK opens a follow-up PR adding the Smithy operations and
+   regenerated SDK code. Frontmatter updates to `absorbed-in-sdk` with
+   Smithy structure refs.
+4. **Archive**: entries more than a year past `absorbed-in-sdk` may be moved
+   to `archive/` for tidiness; they remain readable as historical record.
+
+## Statuses
+
+| Status | Meaning |
+|---|---|
+| `no-json-contract` | Detected gap; no JSON API exists yet. |
+| `partial-coverage` | Some elements exist (partial, render path) but doc and/or Smithy are missing. |
+| `ambiguous` | BC3 has not yet classified whether this is API-shaped or UI-only. |
+| `confirmed-not-api-resource` | BC3 confirmed UI-only / not part of the API surface; entry retained as classification record. |
+| `addressed-in-bc3-pr-N` | BC3 has shipped a JSON API contract; SDK absorption pending. |
+| `absorbed-in-sdk` | SDK has absorbed the contract via Smithy + regenerated code. |
+
+## Entries (current)
+
+| Gap | Status | BC3 plan phase | SDK demand |
+|---|---|---|---|
+| [calendar](calendar.md) | no-json-contract | 3b | medium |
+| [scratchpad](scratchpad.md) | no-json-contract | 3b | medium |
+| [step-top-level](step-top-level.md) | partial-coverage | 3b | low |
+| [everything-aggregates](everything-aggregates.md) | no-json-contract | 3c | high |
+| [activity-timeline](activity-timeline.md) | no-json-contract | 3d | high |
+| [recordable-subtypes-doc](recordable-subtypes-doc.md) | partial-coverage | 3a | medium |
+| [stack-doc-and-smithy](stack-doc-and-smithy.md) | partial-coverage | 3b | medium |
+| [search-filter-additions](search-filter-additions.md) | no-json-contract | 3e | medium |
+| [rich-text-project-attachable](rich-text-project-attachable.md) | no-json-contract | 3e | low |
+| [recording-bubbleupable-field](recording-bubbleupable-field.md) | no-json-contract | 3e | low |
+| [todoset-completed-list-visibility](todoset-completed-list-visibility.md) | ambiguous | 3a | low |
+
+The detector also maintains [`allowlist.yml`](allowlist.yml) for routes
+classified as not-an-API-resource or absorbed under another entry. Allowlist
+records are lighter-weight than entries and serve a different purpose:
+entries preserve the *investigation history* of candidates that warranted
+SDK-side review; allowlist records cover routes that should never have
+warranted an entry in the first place. Pick one per candidate, never both.
+
+## Validating
+
+```
+make validate-api-gaps
+```
+
+Validates frontmatter on every entry against [`schema.json`](schema.json)
+and the allowlist against [`allowlist-schema.json`](allowlist-schema.json).
+Wired into `make check`.
+
+## Detecting new gaps (planned)
+
+Today, entries are added by hand when a gap is identified. Automated
+detection — diffing routes between BC3 master and the active branch,
+classifying each new route against multi-signal heuristics, and emitting
+starter entries for human review — will arrive in a later PR. The intended
+invocation will be:
+
+```
+BC3_REPO_PATH=~/Work/basecamp/bc3 make detect-api-gaps
+```
+
+The `detect-api-gaps` Make target does not yet exist; running this now will
+error.
diff --git a/spec/api-gaps/activity-timeline.md b/spec/api-gaps/activity-timeline.md
new file mode 100644
index 000000000..125ff58a5
--- /dev/null
+++ b/spec/api-gaps/activity-timeline.md
@@ -0,0 +1,70 @@
+---
+gap: activity-timeline
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: high
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3d
+  routes:
+    - GET /:account_id/activity.json
+    - GET /:account_id/projects/:project_id/timeline.json
+  controllers:
+    - app/controllers/activity_controller.rb
+    - app/controllers/timelines_controller.rb
+  related_existing_api: []
+---
+
+# Activity Timeline (global + per-project)
+
+## What's missing
+
+BC5 introduces a global activity feed (`/activity.json`) and per-project
+timeline (`/projects/:project_id/timeline.json`) backed by an Activity
+envelope. The BC3 plan Phase 3d ships both routes plus the envelope shape.
+
+Note: there is **no `/buckets/:id/timeline` route** — earlier drafts of this
+brief used the wrong path. Per-project routes are keyed by `project_id`, not
+`bucket_id`.
+
+## Why it matters
+
+Activity feeds are a primary integration surface for dashboards, audit logs,
+and "what's new since I last checked" tooling. Without a JSON API, consumers
+have to poll individual recording endpoints and reconstruct ordering — slow,
+incomplete, and incompatible with the in-app activity stream.
+
+## Suggested API shape
+
+`GET /:account_id/activity.json`:
+- Pagination: Link header, `X-Total-Count`.
+- Response: array of `Activity` envelope objects:
+  - `id` (long), `created_at`, `updated_at`
+  - `kind` (string — what happened)
+  - `recording` (polymorphic: Todo, Card, Message, etc.)
+  - `creator` (Person)
+  - `bucket` (TodoBucket-shaped, when scoped)
+
+`GET /:account_id/projects/:project_id/timeline.json`:
+- Same envelope, pre-filtered to the project.
+- Pagination: same as global.
+
+## Implementation notes for BC3
+
+- Activity envelope likely already exists in some form (used by web UI). BC3
+  Phase 3d work makes it a documented, JSON-serialisable contract.
+- Per-project timeline action lives on `timelines_controller.rb`, not on
+  `projects_controller`.
+- `doc/api/sections/activity.md` covers both the global and per-project
+  routes plus the envelope shape.
+
+## SDK absorption plan when this lands
+
+- New `ActivityService` with `getActivity()` (global) and
+  `getProjectTimeline(projectId)` (per-project).
+- New shape: `Activity` envelope.
+- The recording field is polymorphic — model as a union of existing recording
+  shapes if Smithy supports it, otherwise use a discriminated structure with
+  a `type` field.
+- Canary fixture: include `getActivity()` once schema is stable. Pairwise
+  check is BC4-absent → BC5-present.
diff --git a/spec/api-gaps/allowlist-schema.json b/spec/api-gaps/allowlist-schema.json
new file mode 100644
index 000000000..54f6e1273
--- /dev/null
+++ b/spec/api-gaps/allowlist-schema.json
@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "API Gap Allowlist",
+  "description": "Schema for spec/api-gaps/allowlist.yml — routes the detector classifies as not requiring a dedicated registry entry.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "not_api_resource": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "reason", "classified"],
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string" },
+          "reason": { "type": "string" },
+          "classified": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" }
+        }
+      }
+    },
+    "absorbed_under_other_brief": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "covers_under", "reason", "classified"],
+        "additionalProperties": false,
+        "properties": {
+          "path": { "type": "string" },
+          "covers_under": { "type": "string", "description": "Brief identifier (gap field) that covers this route." },
+          "reason": { "type": "string" },
+          "classified": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" }
+        }
+      }
+    }
+  }
+}
diff --git a/spec/api-gaps/allowlist.yml b/spec/api-gaps/allowlist.yml
new file mode 100644
index 000000000..ac1127186
--- /dev/null
+++ b/spec/api-gaps/allowlist.yml
@@ -0,0 +1,29 @@
+# Routes the detector has classified as not requiring a dedicated brief.
+# Each entry must justify why no brief is needed. Schema: allowlist-schema.json.
+#
+# Two categories:
+#   not_api_resource         — clearly transient nav state, internal endpoints,
+#                              or routes BC3 has explicitly excluded from API surface
+#   absorbed_under_other_brief — duplicates of routes already covered by another brief
+not_api_resource:
+  - path: my/navigation/menu/projects
+    reason: "Nav UI state, not a persistent API resource. BC3 plan §Out of scope: my/navigation/menu/* and my/navigation/today/* are transient nav state."
+    classified: 2026-05-01
+  - path: my/sidebar/badge
+    reason: "Transient nav state per BC3 plan §Out of scope: my/sidebar/* (badge, readings, bubble_ups, circles)."
+    classified: 2026-05-01
+  - path: my/sidebar/readings
+    reason: "Transient nav state per BC3 plan §Out of scope."
+    classified: 2026-05-01
+  - path: my/sidebar/bubble_ups
+    reason: "Transient nav state per BC3 plan §Out of scope."
+    classified: 2026-05-01
+  - path: my/sidebar/circles
+    reason: "Transient nav state per BC3 plan §Out of scope."
+    classified: 2026-05-01
+
+absorbed_under_other_brief:
+  - path: timelines/searches
+    covers_under: search-filter-additions
+    reason: "Search-within-timeline endpoint; tracked under the broader search-filter-additions brief covering BC3 Phase 3e search additions."
+    classified: 2026-05-01
diff --git a/spec/api-gaps/calendar.md b/spec/api-gaps/calendar.md
new file mode 100644
index 000000000..b853b0953
--- /dev/null
+++ b/spec/api-gaps/calendar.md
@@ -0,0 +1,64 @@
+---
+gap: calendar
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: medium
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3b
+  routes:
+    - GET /:account_id/calendars/:id.json
+    - PUT /:account_id/calendars/:id.json
+  controllers:
+    - app/controllers/calendars_controller.rb
+  related_existing_api: []
+---
+
+# Calendar (show/update)
+
+## What's missing
+
+BC5 introduces a top-level Calendar resource (a per-user calendar view, not the
+per-project Schedule). The web app reads and updates calendar settings via
+`calendars_controller.rb`, but there are no JSON-formatted responses on those
+routes today. The BC3 parity plan Phase 3b ships **show + update only** —
+not full CRUD.
+
+## Why it matters
+
+Without `GET` an SDK client can't display the user's calendar surface in a
+custom integration. Without `PUT` consumers can't set the few mutable
+properties (e.g. visibility, default view) the web UI exposes. This is a new
+top-level resource on BC5 with no BC4 analog, so additive coverage is safe.
+
+## Suggested API shape
+
+`GET /:account_id/calendars/:id.json`:
+- `id` (long), `name` (string), `url`, `app_url`
+- `view` ("day" | "week" | "month" | ...) and any other settings the form exposes
+- `creator` (Person), `created_at`, `updated_at`
+- `subscribed_buckets` (array of Bucket-shaped) if applicable
+
+`PUT /:account_id/calendars/:id.json`:
+- Accept the mutable subset of the show payload
+- Return `204 No Content` on success or the updated resource
+
+## Implementation notes for BC3
+
+- New `app/views/api/calendars/_calendar.json.jbuilder` partial; `show.json.jbuilder`,
+  `update.json.jbuilder` reuse it.
+- Add `respond_to :json` (or per-action `format.json`) to the relevant actions
+  in `calendars_controller.rb`.
+- Add `doc/api/sections/calendars.md` describing both routes.
+- Re-evaluate `index/create/destroy` if usage signals demand later — initial
+  scope is intentionally small.
+
+## SDK absorption plan when this lands
+
+- New Smithy operations: `GetCalendar`, `UpdateCalendar`.
+- New shapes: `Calendar`, `UpdateCalendarInput`/`Output`.
+- New service registration: `CalendarsService` with `get(id)` and `update(id, input)`.
+- Canary fixture: add `GetCalendar` to `live-my-surface.json` once a stable
+  fixture-id resolution path exists (e.g., dock walk → calendar tool).
+- Pairwise check: BC4 absent → BC5 present is fine; the assertion is structural
+  conformance against the response schema, not pairwise equality.
diff --git a/spec/api-gaps/everything-aggregates.md b/spec/api-gaps/everything-aggregates.md
new file mode 100644
index 000000000..ba7ebc8ba
--- /dev/null
+++ b/spec/api-gaps/everything-aggregates.md
@@ -0,0 +1,91 @@
+---
+gap: everything-aggregates
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: high
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3c
+  routes:
+    - "GET /:account_id/todos.json"
+    - "GET /:account_id/todos/open.json"
+    - "GET /:account_id/cards.json"
+    - "GET /:account_id/cards/not_now.json"
+    - "GET /:account_id/files.json"
+    - "GET /:account_id/messages.json"
+    - "GET /:account_id/comments.json"
+    - "GET /:account_id/boosts.json"
+    - "GET /:account_id/checkins.json"
+    - "GET /:account_id/forwards.json"
+    - "GET /:account_id/documents.json"
+    - "(plus per-group filter sub-routes; final route list pending BC3 settlement)"
+  controllers:
+    - app/controllers/everything/todos_controller.rb
+    - app/controllers/everything/cards_controller.rb
+    - app/controllers/everything/files_controller.rb
+    - app/controllers/everything/messages_controller.rb
+    - app/controllers/everything/comments_controller.rb
+    - app/controllers/everything/boosts_controller.rb
+    - app/controllers/everything/checkins_controller.rb
+    - app/controllers/everything/forwards_controller.rb
+    - app/controllers/everything/documents_controller.rb
+  related_existing_api:
+    - ListMyAssignments (similar contract — flat aggregate of one recording type)
+---
+
+# Everything aggregates (flat top-level recording listings)
+
+## What's missing
+
+BC5 introduces account-wide flat listings of recordings by type, served by the
+`everything/*_controller.rb` namespace under flat top-level paths (note:
+`/everything/...` is the **Rails controller namespace**, not part of the URL).
+There are 9 recording-type groups: todos, cards, files, messages, comments,
+boosts, checkins, forwards, documents.
+
+**Current BC3 Phase 3c scope: 22 API-eligible endpoints.** The earlier top
+summary listed 30 endpoints across the 9 groups (bare top-level routes plus
+filter sub-routes per group); the Phase 3c detail narrowed it to 22 by
+excluding the bare top-level routes that stay HTML shells. Treat 22 as the
+working number for absorption planning; if BC3 settles a different final
+count before the absorption PR opens, this brief gets re-synced.
+
+## Why it matters
+
+Today, surfacing "all of one recording type across all projects" in a custom
+integration requires walking projects and concatenating per-project listings.
+The everything aggregates collapse that into a single paginated request.
+This is a strong demand signal from the SDK side — the workaround is painful
+and racy with project-membership changes.
+
+## Suggested API shape
+
+Each endpoint mirrors the `ListMyAssignments`-shaped contract: a paginated
+list of recordings of a single type, scoped to the current user's visibility.
+
+Example: `GET /:account_id/todos/open.json`:
+- Pagination: Link header (RFC5988), `X-Total-Count`, `maxPageSize: 50`.
+- Response: array of Todo (per existing `_todo.json.jbuilder`).
+
+Filter sub-routes follow the existing convention used by `MyAssignments` —
+e.g. `/cards/not_now.json` is the per-status filter variant of `/cards.json`.
+
+## Implementation notes for BC3
+
+- 9 controllers under `app/controllers/everything/` already exist (web).
+  Add a `respond_to :json` branch and corresponding jbuilder views.
+- Consider whether to ship bare top-level routes (`/todos.json`, etc.) or
+  scope to sub-routes only. Mirror that decision in `doc/api/`.
+- Consistency: all 9 groups should use the same pagination + filter idiom.
+  Inconsistency between groups creates per-endpoint absorption work in the SDK.
+
+## SDK absorption plan when this lands
+
+- New `EverythingService` with one op per endpoint BC3 ships.
+- Each op routed at the flat top-level path (no `/everything/` URL prefix).
+- Reuse existing recording shapes (`Todo`, `Card`, `Document`, `Message`, etc.).
+- Canary fixture: cover at least one operation per group to catch shape drift.
+  Pairwise check: BC4 absent → BC5 present is fine.
+- Operation count in PR description must match what BC3 actually ships.
+  Working number is 22 (Phase 3c API-eligible endpoints); brief author
+  re-syncs route list before the absorption PR opens.
diff --git a/spec/api-gaps/recordable-subtypes-doc.md b/spec/api-gaps/recordable-subtypes-doc.md
new file mode 100644
index 000000000..d27c81cf7
--- /dev/null
+++ b/spec/api-gaps/recordable-subtypes-doc.md
@@ -0,0 +1,112 @@
+---
+gap: recordable-subtypes-doc
+status: partial-coverage
+detected: 2026-05-01
+sdk_demand: medium
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3a
+  routes:
+    - "POST /:account_id/buckets/:bucket_id/journals.json (create)"
+    - "POST /:account_id/buckets/:bucket_id/journals/:journal_id/entries.json (create)"
+    - "POST /:account_id/buckets/:bucket_id/cloud_files.json (create)"
+    - "POST /:account_id/buckets/:bucket_id/google_documents.json (create)"
+    - "(plus polymorphic surfacing in existing Recording responses — no new GET routes)"
+  controllers:
+    - app/controllers/journals_controller.rb
+    - app/controllers/journals/entries_controller.rb
+    - app/controllers/cloud_files_controller.rb
+    - app/controllers/google_documents_controller.rb
+  related_existing_api:
+    - GetRecording (polymorphic by recording_type)
+---
+
+# Recordable subtypes — doc + Smithy ops + create
+
+## What's missing
+
+BC5 surfaces several Recording subtypes that have always existed in the
+codebase but have never been formally documented as API-shaped:
+
+- `Journal` and `Journal::Entry` (per-project journal posts)
+- `CloudFile` (linked external file: Google Drive, Dropbox, etc.)
+- `GoogleDocument` (specifically a Google Docs link, distinct from CloudFile)
+
+These appear polymorphically in existing Recording responses (search results,
+activity feeds, etc.). Their wire shapes likely render via existing partials,
+but the subtypes are absent from `doc/api/` and from the SDK's typed shapes.
+
+The BC3 plan Phase 3a covers documentation + Smithy shapes **and `create`
+operations** for all four subtypes (Journal, Journal::Entry, CloudFile,
+GoogleDocument). This is not shape/doc-only absorption — the SDK adds
+`Create*` operations to match.
+
+**Door is excluded** by the BC3 plan from standalone API coverage and is
+covered (if at all) only as a string-typed `type` value on existing
+Recording responses.
+
+## Why it matters
+
+SDK consumers iterating through Recording-shaped responses (Search,
+Activity, etc.) currently see opaque payloads when the underlying Recording
+is one of these subtypes. Adding typed shapes lets them pattern-match on
+`type` and render appropriately.
+
+## Suggested API shape
+
+Two parallel additions — documentation/typed shapes for read paths, and new
+POST endpoints for create paths.
+
+**Read paths (already surface via polymorphism):**
+
+1. Document the wire shape for each subtype:
+   - `Journal`: id, title, status, urls, recordings_count, etc. (Recording-like)
+   - `Journal::Entry`: id, title, content, journal (parent reference)
+   - `CloudFile`: id, name, content_type, external_url, source ("Google Drive" etc.)
+   - `GoogleDocument`: id, name, google_url, doc_type
+2. Confirm `type` value emitted by each (e.g. `"Journal::Entry"`,
+   `"CloudFile"`, `"GoogleDocument"`).
+3. Verify polymorphic Recording-shaped responses include these without
+   manual whitelisting (`Recording#bubbleupable?` test should suffice).
+
+**Create paths (BC3 Phase 3a):**
+
+- `POST /:account_id/buckets/:bucket_id/journals.json` — input: `title`,
+  optional `description`/`status`. Returns the created Journal.
+- `POST /:account_id/buckets/:bucket_id/journals/:journal_id/entries.json`
+  — input: `title`, `content`. Returns the created Journal::Entry.
+- `POST /:account_id/buckets/:bucket_id/cloud_files.json` — input: external
+  URL, name, source. Returns the created CloudFile.
+- `POST /:account_id/buckets/:bucket_id/google_documents.json` — input:
+  Google Doc URL, name. Returns the created GoogleDocument.
+
+Confirm the exact controller paths and input shapes against BC3 Phase 3a
+before opening the absorption PR.
+
+## Implementation notes for BC3
+
+- Spot-check `app/views/api/journals/`, `app/views/api/cloud_files/`,
+  `app/views/api/google_documents/` — partials may already exist via
+  polymorphic dispatch.
+- Add `doc/api/sections/journals.md`, etc.
+- For create endpoints: confirm controller-level routes; existing
+  `journals_controller.rb`, `cloud_files_controller.rb`, etc. likely host
+  the `create` action with a JSON branch added in Phase 3a.
+
+## SDK absorption plan when this lands
+
+- New Smithy structures: `Journal`, `JournalEntry`, `CloudFile`,
+  `GoogleDocument`.
+- New Smithy operations: `CreateJournal`, `CreateJournalEntry`,
+  `CreateCloudFile`, `CreateGoogleDocument` — each with input/output
+  structures.
+- New service registrations: likely `JournalsService`, `CloudFilesService`,
+  `GoogleDocumentsService` (consolidate if BC3 puts them under a single
+  controller namespace).
+- Where Recording is polymorphic, extend the discriminated structure (or
+  add new union members) with the new `type` values.
+- Door is not modelled separately — appears as a string `type` value on
+  existing Recording responses, undecoded.
+- Canary: extend the `Search` and `Activity` fixture coverage to include
+  recordings of these new types if test data permits. Create operations
+  not covered by canary (read-only canary scope).
diff --git a/spec/api-gaps/recording-bubbleupable-field.md b/spec/api-gaps/recording-bubbleupable-field.md
new file mode 100644
index 000000000..f7101c5eb
--- /dev/null
+++ b/spec/api-gaps/recording-bubbleupable-field.md
@@ -0,0 +1,57 @@
+---
+gap: recording-bubbleupable-field
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: low
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3e
+  routes:
+    - "(no new routes — additive field on existing Recording-shaped responses)"
+  controllers: []
+  related_existing_api:
+    - "Recording (polymorphic shape used by GetRecording, search results, activity feeds)"
+---
+
+# Recording#bubbleupable? field
+
+## What's missing
+
+BC5 adds a `bubbleupable` (or `bubbleupable?`) boolean field to the
+Recording envelope to indicate whether the current user can bubble-up the
+recording. The BC3 plan Phase 3e covers this addition along with any other
+new envelope fields.
+
+## Why it matters
+
+Without the field, SDK consumers can't pre-compute the eligibility of UI
+affordances ("Save to Bubble Up" button) without a separate roundtrip.
+Bubble-up eligibility is per-user, per-recording, and not derivable
+client-side from the recording type alone.
+
+## Suggested API shape
+
+Additive boolean field on every Recording-shaped response:
+```json
+{ ..., "bubbleupable": true }
+```
+
+If BC3 surfaces additional envelope fields in the same phase, document each
+here as they're confirmed.
+
+## Implementation notes for BC3
+
+- Add to the shared `_recording.json.jbuilder` partial.
+- Document in `doc/api/sections/recordings.md`.
+- Verify behavior against the `Recording#bubbleupable?` predicate in the
+  Rails model.
+
+## SDK absorption plan when this lands
+
+- Extend the Smithy `Recording` shape (or whichever shape carries the
+  envelope fields — `Notification`, `MyAssignment`, etc.) with an optional
+  `bubbleupable: Boolean` field.
+- No new service registrations.
+- Canary: extras-observed reporting will surface the field automatically
+  during the first live run after BC5 ships; the absorption PR adds it to
+  the spec.
diff --git a/spec/api-gaps/rich-text-project-attachable.md b/spec/api-gaps/rich-text-project-attachable.md
new file mode 100644
index 000000000..c6e2e2de8
--- /dev/null
+++ b/spec/api-gaps/rich-text-project-attachable.md
@@ -0,0 +1,53 @@
+---
+gap: rich-text-project-attachable
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: low
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3e
+  routes:
+    - "(no new routes — change is to the rich-text attachable schema documented at doc/api/sections/rich_text.md)"
+  controllers: []
+  related_existing_api:
+    - "Rich text rendering: Document, Message, Comment payloads"
+---
+
+# Project as Attachable in rich text
+
+## What's missing
+
+The existing `doc/api/sections/rich_text.md` enumerates Attachable types
+(types of recordings that can be inlined in a rich-text body). BC5 adds
+`Project` to that list — you can now attach a project reference inside a
+message, document, or comment body.
+
+## Why it matters
+
+If SDK consumers rendering rich text don't model `Project` as an Attachable,
+they'll see unrecognised `<bc-attachment sgid="..." content-type="...">` tags
+and either drop them or render them as raw HTML. Adding it to the typed
+attachable enum lets clients dispatch correctly.
+
+## Suggested API shape
+
+Additive: `"Project"` is a new value in the `attachableTypes` enum used by
+the rich-text contract. Existing rich-text payloads gain attachments with
+`content-type="application/vnd.basecamp.project"` (or whatever sgid type
+the server emits).
+
+## Implementation notes for BC3
+
+- Update `doc/api/sections/rich_text.md` to include `Project` in the
+  Attachable list.
+- Confirm the `content-type` MIME string emitted; the SDK enum needs to
+  match exactly.
+
+## SDK absorption plan when this lands
+
+- Update the rich-text Smithy / TypeScript / Ruby reference enum if one
+  exists; otherwise this is a doc-only update referencing the BC3 doc.
+- Comment update on any rich-text helper that enumerates attachable types.
+- No service or operation changes.
+- No canary fixture impact unless the live test bodies start including
+  Project attachments.
diff --git a/spec/api-gaps/schema.json b/spec/api-gaps/schema.json
new file mode 100644
index 000000000..36ca82840
--- /dev/null
+++ b/spec/api-gaps/schema.json
@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "API Gap Entry Frontmatter",
+  "description": "Schema for the YAML frontmatter at the top of each spec/api-gaps/*.md file. Validated by scripts/validate-api-gaps.sh.",
+  "type": "object",
+  "required": ["gap", "status", "detected", "bc3_refs"],
+  "additionalProperties": false,
+  "properties": {
+    "gap": {
+      "type": "string",
+      "description": "Short kebab-case identifier matching the brief filename (without .md)."
+    },
+    "status": {
+      "description": "Lifecycle status. Statuses follow the detector emit set + closure states.",
+      "oneOf": [
+        { "type": "string", "enum": [
+          "no-json-contract",
+          "partial-coverage",
+          "ambiguous",
+          "confirmed-not-api-resource",
+          "absorbed-in-sdk"
+        ] },
+        { "type": "string", "pattern": "^addressed-in-bc3-pr-[0-9]+$" }
+      ]
+    },
+    "detected": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
+      "description": "ISO date when the gap was first identified."
+    },
+    "bc3_refs": {
+      "type": "object",
+      "description": "Pointers into the BC3 source/plan that frame the gap.",
+      "additionalProperties": true,
+      "properties": {
+        "introduced_in": { "type": "string" },
+        "bc3_plan_phase": { "type": "string" },
+        "bc3_plan_section": { "type": "string" },
+        "routes": { "type": "array", "items": { "type": "string" } },
+        "controllers": { "type": "array", "items": { "type": "string" } },
+        "related_existing_api": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "sdk_demand": {
+      "type": "string",
+      "enum": ["high", "medium", "low"],
+      "description": "Editorial estimate of how much SDK consumers need this gap closed."
+    },
+    "bc3_pr": {
+      "type": ["string", "integer"],
+      "description": "Reference to the BC3 PR that addressed the gap (when status is addressed-in-bc3-pr-N or absorbed-in-sdk)."
+    },
+    "smithy_refs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Smithy structures/operations that absorbed the contract (when status is absorbed-in-sdk)."
+    }
+  }
+}
diff --git a/spec/api-gaps/scratchpad.md b/spec/api-gaps/scratchpad.md
new file mode 100644
index 000000000..930f4ea5c
--- /dev/null
+++ b/spec/api-gaps/scratchpad.md
@@ -0,0 +1,67 @@
+---
+gap: scratchpad
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: medium
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3b
+  routes:
+    - "GET /:account_id/my/navigation/notes.json (URL pending — BC3 plan defers final path)"
+    - "PUT /:account_id/my/navigation/notes.json (URL pending)"
+  controllers:
+    - app/controllers/my/notes_controller.rb (path tentative — actual controller name pending BC3 decision)
+  related_existing_api: []
+---
+
+# Scratchpad (per-user notes)
+
+## What's missing
+
+BC5 introduces a per-user "scratchpad" — a single rich-text note attached to
+the navigation surface, distinct from the per-project Documents resource.
+Read/write is exposed in the web UI but no JSON contract exists yet.
+
+The BC3 parity plan Phase 3b ships the jbuilder partial and a JSON branch on
+the relevant controller, but **the URL path is explicitly deferred** by the
+BC3 team. The plan's working default is `/my/navigation/notes.json`; the
+final path is BC3's call. This brief tracks the decision.
+
+## Why it matters
+
+External SDK consumers building dashboards or note-syncing tools can't read or
+write the user's scratchpad without screen-scraping. As the navigation gets
+more first-class data attached to it, leaving notes off the API surface is a
+predictable source of demand-signal complaints.
+
+## Suggested API shape
+
+`GET /:account_id/my/navigation/notes.json` (or final-decided path):
+- `id` (long, optional — single per-user note may not need an id)
+- `content` (rich text, format consistent with Document/Message bodies)
+- `updated_at`, `created_at`
+
+`PUT /:account_id/my/navigation/notes.json`:
+- `content` (string)
+- Returns 204 or the updated payload.
+
+## Implementation notes for BC3
+
+- Resolve URL path first. Coordinate with the BC3 plan owner; once the path
+  is fixed, update this brief's `routes:` field and the corresponding SDK
+  Smithy operation paths.
+- Single-resource (not collection): the `index/show` distinction collapses
+  here — there's one note per user.
+- Add to `doc/api/`.
+
+## SDK absorption plan when this lands
+
+- Smithy: `GetMyScratchpad`, `UpdateMyScratchpad` (or `MyNotesService` —
+  service name follows whatever BC3 picks for the URL).
+- Service registration depends on URL: if `/my/notes.json`, group with the
+  `My*` services; if under `/my/navigation/...`, follow that namespacing.
+- Canary fixture: a single per-account fixture-id-free GET works well since
+  the resource is implicit-self.
+- Pairwise check: BC4 absent → BC5 present is fine.
+
+**Action item**: revisit this brief when BC3 commits the URL path.
diff --git a/spec/api-gaps/search-filter-additions.md b/spec/api-gaps/search-filter-additions.md
new file mode 100644
index 000000000..0d2f09447
--- /dev/null
+++ b/spec/api-gaps/search-filter-additions.md
@@ -0,0 +1,65 @@
+---
+gap: search-filter-additions
+status: no-json-contract
+detected: 2026-05-01
+sdk_demand: medium
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3e
+  routes:
+    - "GET /:account_id/search.json (existing)"
+    - "GET /:account_id/timelines/searches.json (existing — covered here)"
+  controllers:
+    - app/controllers/searches_controller.rb
+  related_existing_api:
+    - SearchService.search
+---
+
+# Search — additional filter parameters
+
+## What's missing
+
+The existing Search endpoint accepts a small set of filter parameters today.
+BC5 adds the following (per BC3 plan Phase 3e):
+
+- `type_names` (string[]) — filter to specific recording types.
+- `creator_ids` (long[]) — filter to recordings authored by specific people.
+- `bucket_ids` (long[]) — restrict to specific projects.
+- `exclude_chat` (boolean) — drop chat messages from results.
+- `file_type` (string) — filter file recordings by extension/type.
+- `sort` (enum: "relevance" | "recency" | …) — control result ordering.
+
+The `timelines/searches` route is the timeline-scoped variant; covered here
+since it shares the input shape.
+
+## Why it matters
+
+These are additive filter params on an existing endpoint. Without them, SDK
+consumers either over-fetch and filter client-side (slow, paginates wrong) or
+hand-roll URL strings to bypass the typed input shape (fragile and silently
+breaks if BC3 changes the param names).
+
+## Suggested API shape
+
+Additive parameters on the existing `SearchInput` shape — types per the list
+above. Response shape is unchanged.
+
+## Implementation notes for BC3
+
+- All additions are query-string params handled server-side. No new
+  controller actions, no new partials.
+- `doc/api/sections/search.md` updates the parameter list.
+- Document defaults explicitly (e.g. `sort: "relevance"`).
+
+## SDK absorption plan when this lands
+
+- Extend the existing Smithy `SearchInput` structure with the new optional
+  fields (each annotated `@httpQuery`).
+- Same change applies to the timeline-search input if it's a separate
+  Smithy structure.
+- No new service registrations.
+- Canary: add a search call with at least one of the new filter params in
+  `live-my-surface.json`.
+- Pairwise check: existing `search.json` is BC4-compatible; new params are
+  silently ignored on BC4, present and respected on BC5. No invariant
+  violation.
diff --git a/spec/api-gaps/stack-doc-and-smithy.md b/spec/api-gaps/stack-doc-and-smithy.md
new file mode 100644
index 000000000..20d5e9676
--- /dev/null
+++ b/spec/api-gaps/stack-doc-and-smithy.md
@@ -0,0 +1,75 @@
+---
+gap: stack-doc-and-smithy
+status: partial-coverage
+detected: 2026-05-01
+sdk_demand: medium
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3b
+  routes:
+    - GET /:account_id/stacks/:id.json
+    - POST /:account_id/stacks.json
+    - PUT /:account_id/stacks/:id.json
+    - DELETE /:account_id/stacks/:id.json
+    - GET /:account_id/stacks/:id/collectables.json
+  controllers:
+    - app/controllers/stacks_controller.rb
+    - app/controllers/stacks/collectables_controller.rb
+  related_existing_api:
+    - "(stack jbuilder partial — already shipped; doc + Smithy still missing)"
+---
+
+# Stack — full CRUD + list collectables
+
+## What's missing
+
+Stacks (BC5's saved-collection abstraction) ship with a partial in
+`app/views/api/stacks/_stack.json.jbuilder` already, but no documented JSON
+contract or Smithy operations. The BC3 plan Phase 3b expanded this to **full
+CRUD + list collectables** (revised from earlier "doc-only / add-remove
+collectables" scope).
+
+## Why it matters
+
+Stacks are user-curated collections of recordings — first-class data the SDK
+should be able to read and manipulate. Without CRUD, integrations can't
+build "save to my stack" workflows or surface stack contents in dashboards.
+
+## Suggested API shape
+
+`GET /:account_id/stacks/:id.json`:
+- `id`, `title`, `position`, `created_at`, `updated_at`
+- `creator` (Person)
+- `collectables_count`, `collectables_url`
+
+`POST /:account_id/stacks.json`:
+- Input: `title`, optional `position`
+- Returns the created stack.
+
+`PUT /:account_id/stacks/:id.json`:
+- Input: subset of mutable fields (`title`, `position`).
+- Returns the updated stack or 204.
+
+`DELETE /:account_id/stacks/:id.json`:
+- Returns 204.
+
+`GET /:account_id/stacks/:id/collectables.json`:
+- Pagination: Link header.
+- Response: array of polymorphic Recording-shaped items.
+
+## Implementation notes for BC3
+
+- The stack partial already exists; show/index views reuse it.
+- Add `create`/`update`/`destroy` actions with JSON branches.
+- New `_collectable.json.jbuilder` (or reuse existing recording partial)
+  for the collectables endpoint.
+- `doc/api/sections/stacks.md` covers all five routes.
+
+## SDK absorption plan when this lands
+
+- New `StacksService` with `get(id)`, `create(input)`, `update(id, input)`,
+  `delete(id)`, `listCollectables(id)`.
+- New shapes: `Stack`, `CreateStackInput/Output`, `UpdateStackInput/Output`.
+- `listCollectables` uses Recording polymorphic shape.
+- Canary fixture: `getStack(id)` once a stable fixture exists; pairwise
+  check is BC4-absent → BC5-present.
diff --git a/spec/api-gaps/step-top-level.md b/spec/api-gaps/step-top-level.md
new file mode 100644
index 000000000..7393f1d2b
--- /dev/null
+++ b/spec/api-gaps/step-top-level.md
@@ -0,0 +1,68 @@
+---
+gap: step-top-level
+status: partial-coverage
+detected: 2026-05-01
+sdk_demand: low
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3b
+  routes:
+    - "GET /:account_id/buckets/:bucket_id/cards/:card_id/steps/:id.json (existing — already in SDK)"
+    - "Top-level Step paths (final path/depth pending BC3 doc decision)"
+  controllers:
+    - app/controllers/steps_controller.rb
+  related_existing_api:
+    - GetCardStep
+    - CreateCardStep
+    - UpdateCardStep
+    - SetCardStepCompletion
+    - RepositionCardStep
+---
+
+# Step (top-level paths)
+
+## What's missing
+
+BC5 generalises Step beyond the Kanban-card context (`Step::FormerlyKanbanStep`
+keeps `type: "Kanban::Step"` on the wire — see SDK plan §Out of scope). The
+jbuilder partial for Step is already shipped via the cards routes. The BC3
+parity plan Phase 3b adds a doc-only entry exposing top-level Step routes
+(unscoped from cards).
+
+The wire shape itself is unchanged — the SDK already models `CardStep`. What's
+missing is documentation + Smithy operations under the new top-level paths.
+
+## Why it matters
+
+If BC3 documents top-level Step routes, the SDK needs corresponding Smithy ops
+so SDK consumers can use them without manually constructing URLs from
+recording-id pairs. Forward compat is fine: the existing `CardStepsService`
+keeps working under its current paths.
+
+## Suggested API shape
+
+Same as existing `CardStep` shape (already modelled at `spec/basecamp.smithy`
+line 4712). The new operations are merely routed differently — most likely:
+
+- `GET /:account_id/steps/:id.json` (single Step regardless of recording parent)
+- `PUT /:account_id/steps/:id/completions.json` (toggle completion)
+
+The wire payload's `type` field stays `"Kanban::Step"` per BC3 plan's
+`Step::FormerlyKanbanStep` override.
+
+## Implementation notes for BC3
+
+- Choose and document the canonical top-level path.
+- Reuse the existing `_step.json.jbuilder` partial.
+- Update `doc/api/sections/cards.md` (or add `doc/api/sections/steps.md`) to
+  describe both forms.
+
+## SDK absorption plan when this lands
+
+- Either extend `CardStepsService` with a new `getStep(id)` op routed at
+  `/:account_id/steps/:id.json`, OR add a parallel `StepsService` with the
+  same shape — coordinate naming with the BC3 doc choice.
+- Do not rename `CardStepsService` — the existing service stays.
+- No new Smithy structures (existing `CardStep` is reused).
+- Canary fixture: optional; the existing CardStep coverage already exercises
+  the wire shape.
diff --git a/spec/api-gaps/todoset-completed-list-visibility.md b/spec/api-gaps/todoset-completed-list-visibility.md
new file mode 100644
index 000000000..b7f33989f
--- /dev/null
+++ b/spec/api-gaps/todoset-completed-list-visibility.md
@@ -0,0 +1,63 @@
+---
+gap: todoset-completed-list-visibility
+status: ambiguous
+detected: 2026-05-01
+sdk_demand: low
+bc3_refs:
+  introduced_in: five
+  bc3_plan_phase: 3a
+  routes:
+    - "todosets/completed_list_visibility (verb pending — likely PUT)"
+  controllers:
+    - app/controllers/todosets_controller.rb
+  related_existing_api:
+    - GetTodoset
+---
+
+# Todoset — completed-list visibility toggle
+
+## What's missing
+
+A new route `todosets/completed_list_visibility` was detected on
+`origin/five` and is likely a PUT endpoint to show/hide the completed-todos
+list at the todoset level (matches the existing UI toggle).
+
+**This entry is currently `ambiguous`**: the BC3 plan has not classified
+whether this is an API-shaped resource or UI-only state. PR 1 must classify
+it before merging:
+
+- If JSON-API: SDK absorbs as `UpdateTodosetCompletedListVisibility` op,
+  this entry flips to `no-json-contract` and the absorption PR ships once
+  BC3 lands the contract.
+- If UI-only: this entry flips to `confirmed-not-api-resource` and stays
+  as a record (per the entry-vs-allowlist rule — registry entries are
+  durable records for candidates that warranted SDK-side investigation,
+  regardless of final classification).
+
+## Why it matters
+
+If this is an API-shaped toggle and the SDK doesn't model it, integrations
+can't replicate the in-app behavior. If it's UI-only, modelling it would
+introduce a no-op endpoint — worse than missing it.
+
+The right answer comes from BC3, not from the SDK. Hence the brief.
+
+## Suggested API shape (if API-shaped)
+
+`PUT /:account_id/todosets/:id/completed_list_visibility.json`:
+- Input: `visible` (boolean)
+- Returns 204 or the updated Todoset.
+
+## Implementation notes for BC3
+
+- Confirm whether the route is reached only by the web form (CSRF-token,
+  session-cookie auth) or also by API auth.
+- If API-shaped: add JSON branch + jbuilder + doc entry.
+- If UI-only: explicit note in BC3 plan would close this brief.
+
+## SDK absorption plan when this lands
+
+- If API-shaped: new operation `UpdateTodosetCompletedListVisibility` on
+  the existing `TodosetsService`.
+- If UI-only: this brief stays at `confirmed-not-api-resource` as the
+  record of the classification.

From 40a7d102b1f6ec61407eab46d34701f87bf457a1 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:09 -0700
Subject: [PATCH 04/16] ts: regenerate from BC5 spec additions

---
 typescript/src/generated/metadata.ts          |  47 +----
 .../src/generated/openapi-stripped.json       | 188 +++++++++++-------
 typescript/src/generated/schema.d.ts          |  54 +++++
 3 files changed, 176 insertions(+), 113 deletions(-)

diff --git a/typescript/src/generated/metadata.ts b/typescript/src/generated/metadata.ts
index 6e958c9ae..1988faffb 100644
--- a/typescript/src/generated/metadata.ts
+++ b/typescript/src/generated/metadata.ts
@@ -1,43 +1,7 @@
-// Generated from OpenAPI x-basecamp-* extensions. Do not edit by hand.
-
-export interface RetryConfig {
-  maxAttempts: number;
-  baseDelayMs: number;
-  backoff: "exponential" | "linear" | "constant";
-  retryOn: number[];
-}
-
-export interface PaginationConfig {
-  style: "link" | "cursor" | "page";
-  pageParam?: string;
-  totalCountHeader?: string;
-  maxPageSize?: number;
-  key?: string;
-}
-
-export interface IdempotentConfig {
-  keySupported?: boolean;
-  keyHeader?: string;
-  natural?: boolean;
-}
-
-export interface OperationMetadata {
-  retry?: RetryConfig;
-  pagination?: PaginationConfig;
-  idempotent?: IdempotentConfig;
-}
-
-export interface MetadataOutput {
-  $schema: string;
-  version: string;
-  generated: string;
-  operations: Record<string, OperationMetadata>;
-}
-
-const metadata: MetadataOutput = {
+{
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-07-18T00:53:17.738Z",
+  "generated": "2026-05-01T22:48:06.275Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -2366,7 +2330,7 @@ const metadata: MetadataOutput = {
         ]
       }
     },
-    "ReplaceTodo": {
+    "UpdateTodo": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -2686,7 +2650,4 @@ const metadata: MetadataOutput = {
       }
     }
   }
-};
-
-export default metadata;
-
+}
diff --git a/typescript/src/generated/openapi-stripped.json b/typescript/src/generated/openapi-stripped.json
index abd8d07bf..51c6e99b9 100644
--- a/typescript/src/generated/openapi-stripped.json
+++ b/typescript/src/generated/openapi-stripped.json
@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-07-17",
+    "version": "2026-05-01",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -16291,17 +16291,16 @@
         }
       },
       "put": {
-        "description": "Replace a todo with a new complete representation.\nThe request body is the todo's full writable state: any writable field\nomitted from the request is cleared server-side (empty/missing\nassignee_ids clears assignees, missing description clears it, and so\non). content is required — a request without it is rejected.\nTo set some fields while preserving the rest, use the SDK's merge-safe\nupdate or edit methods, which GET the current todo and PUT the full\nrepresentation back. Those read-modify-write helpers are not atomic:\na concurrent write between the GET and PUT is overwritten (last write\nwins for the whole representation; the window is one round-trip).",
-        "operationId": "ReplaceTodo",
+        "description": "Update an existing todo",
+        "operationId": "UpdateTodo",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/ReplaceTodoRequestContent"
+                "$ref": "#/components/schemas/UpdateTodoRequestContent"
               }
             }
-          },
-          "required": true
+          }
         },
         "parameters": [
           {
@@ -16316,11 +16315,11 @@
         ],
         "responses": {
           "200": {
-            "description": "ReplaceTodo 200 response",
+            "description": "UpdateTodo 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ReplaceTodoResponseContent"
+                  "$ref": "#/components/schemas/UpdateTodoResponseContent"
                 }
               }
             }
@@ -16390,10 +16389,6 @@
             429,
             503
           ]
-        },
-        "x-basecamp-write-semantics": {
-          "mode": "replace",
-          "clearsOmitted": true
         }
       }
     },
@@ -21260,7 +21255,22 @@
             "type": "array",
             "items": {
               "$ref": "#/components/schemas/Notification"
-            }
+            },
+            "description": "Legacy \"save forever\" collection. Observed BC5 behavior: emits `[]`\nwhile BC4 still populates with real items — the BC team has not yet\nresolved whether to keep BC4-shaped data on BC5 (back-compat) or to\naccept the empty-array break with a documented BC5 changelog entry.\nSee COORDINATION.md for the open decision. The conceptual\nreplacement is `bubble_ups` (with optional scheduling via\n`scheduled_bubble_ups`), though wire shapes are not interchangeable\nper-item, so cross-version readers should consume both."
+          },
+          "bubble_ups": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Notification"
+            },
+            "description": "Items the user has saved with Bubble Up (BC5 addition). Roughly the\nsuccessor to `memories` but with optional scheduling — see\n`scheduled_bubble_ups` for the time-deferred subset."
+          },
+          "scheduled_bubble_ups": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Notification"
+            },
+            "description": "Bubble Ups scheduled to resurface in the future (BC5 addition)."
           }
         }
       },
@@ -22370,6 +22380,19 @@
           "memory_url": {
             "type": "string"
           },
+          "bubble_up_url": {
+            "type": "string",
+            "description": "URL for the Bubble Up record covering this notification (BC5 addition).\nEligibility-gated — only present on items the current user can bubble up."
+          },
+          "bubble_up_at": {
+            "type": "string",
+            "description": "Scheduled resurfacing time when this item is queued as a scheduled\nBubble Up (BC5 addition). Absent when there is no scheduled time.",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
           "subscription_url": {
             "type": "string"
           },
@@ -22516,6 +22539,15 @@
               "redact": false
             }
           },
+          "tagline": {
+            "type": "string",
+            "description": "Alias of `bio` introduced in BC5. BC3 emits both keys with identical content;\nolder BC4 responses may omit `tagline`. Prefer `bio` for cross-version reads.",
+            "format": "password",
+            "x-basecamp-sensitive": {
+              "category": "pii",
+              "redact": false
+            }
+          },
           "location": {
             "type": "string",
             "format": "password",
@@ -22713,12 +22745,6 @@
           "purpose": {
             "type": "string"
           },
-          "start_date": {
-            "type": "string"
-          },
-          "end_date": {
-            "type": "string"
-          },
           "clients_enabled": {
             "type": "boolean"
           },
@@ -23335,57 +23361,6 @@
           "url"
         ]
       },
-      "ReplaceTodoRequestContent": {
-        "type": "object",
-        "properties": {
-          "content": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "assignee_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "completion_subscriber_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "notify": {
-            "type": "boolean",
-            "x-go-type-skip-optional-pointer": false
-          },
-          "due_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          },
-          "starts_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          }
-        },
-        "required": [
-          "content"
-        ]
-      },
-      "ReplaceTodoResponseContent": {
-        "$ref": "#/components/schemas/Todo"
-      },
       "RepositionCardStepRequestContent": {
         "type": "object",
         "properties": {
@@ -24158,6 +24133,13 @@
           },
           "boosts_url": {
             "type": "string"
+          },
+          "steps": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CardStep"
+            },
+            "description": "Steps embedded in the Todo response (BC5 addition). The shared\n`steps/step` jbuilder partial emits the same shape as `CardStep`,\nso the existing `CardStepList` is reused."
           }
         },
         "required": [
@@ -24554,6 +24536,24 @@
           },
           "app_todolists_url": {
             "type": "string"
+          },
+          "todos_count": {
+            "type": "integer",
+            "description": "Total count of todos across all todolists in this todoset (BC5 addition).",
+            "format": "int32"
+          },
+          "completed_loose_todos_count": {
+            "type": "integer",
+            "description": "Count of completed loose todos at the todoset level (BC5 addition).",
+            "format": "int32"
+          },
+          "todos_url": {
+            "type": "string",
+            "description": "API URL for listing todos directly under this todoset (BC5 addition)."
+          },
+          "app_todos_url": {
+            "type": "string",
+            "description": "In-app URL for viewing the todoset's todos (BC5 addition)."
           }
         },
         "required": [
@@ -25130,6 +25130,54 @@
       "UpdateTimesheetEntryResponseContent": {
         "$ref": "#/components/schemas/TimesheetEntry"
       },
+      "UpdateTodoRequestContent": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "assignee_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "completion_subscriber_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "notify": {
+            "type": "boolean",
+            "x-go-type-skip-optional-pointer": false
+          },
+          "due_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
+          "starts_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          }
+        }
+      },
+      "UpdateTodoResponseContent": {
+        "$ref": "#/components/schemas/Todo"
+      },
       "UpdateTodolistOrGroupRequestContent": {
         "type": "object",
         "properties": {
diff --git a/typescript/src/generated/schema.d.ts b/typescript/src/generated/schema.d.ts
index 0bf5a2308..f124dd366 100644
--- a/typescript/src/generated/schema.d.ts
+++ b/typescript/src/generated/schema.d.ts
@@ -3299,7 +3299,25 @@ export interface components {
         GetMyNotificationsResponseContent: {
             unreads?: components["schemas"]["Notification"][];
             reads?: components["schemas"]["Notification"][];
+            /**
+             * @description Legacy "save forever" collection. Observed BC5 behavior: emits `[]`
+             *     while BC4 still populates with real items — the BC team has not yet
+             *     resolved whether to keep BC4-shaped data on BC5 (back-compat) or to
+             *     accept the empty-array break with a documented BC5 changelog entry.
+             *     See COORDINATION.md for the open decision. The conceptual
+             *     replacement is `bubble_ups` (with optional scheduling via
+             *     `scheduled_bubble_ups`), though wire shapes are not interchangeable
+             *     per-item, so cross-version readers should consume both.
+             */
             memories?: components["schemas"]["Notification"][];
+            /**
+             * @description Items the user has saved with Bubble Up (BC5 addition). Roughly the
+             *     successor to `memories` but with optional scheduling — see
+             *     `scheduled_bubble_ups` for the time-deferred subset.
+             */
+            bubble_ups?: components["schemas"]["Notification"][];
+            /** @description Bubble Ups scheduled to resurface in the future (BC5 addition). */
+            scheduled_bubble_ups?: components["schemas"]["Notification"][];
         };
         GetMyPreferencesResponseContent: components["schemas"]["Preferences"];
         GetMyProfileResponseContent: components["schemas"]["Person"];
@@ -3579,6 +3597,16 @@ export interface components {
             unread_url?: string;
             bookmark_url?: string;
             memory_url?: string;
+            /**
+             * @description URL for the Bubble Up record covering this notification (BC5 addition).
+             *     Eligibility-gated — only present on items the current user can bubble up.
+             */
+            bubble_up_url?: string;
+            /**
+             * @description Scheduled resurfacing time when this item is queued as a scheduled
+             *     Bubble Up (BC5 addition). Absent when there is no scheduled time.
+             */
+            bubble_up_at?: string;
             subscription_url?: string;
             subscribed?: boolean;
             previewable_attachments?: components["schemas"]["PreviewableAttachment"][];
@@ -3626,6 +3654,12 @@ export interface components {
             title?: string;
             /** Format: password */
             bio?: string;
+            /**
+             * Format: password
+             * @description Alias of `bio` introduced in BC5. BC3 emits both keys with identical content;
+             *     older BC4 responses may omit `tagline`. Prefer `bio` for cross-version reads.
+             */
+            tagline?: string;
             /** Format: password */
             location?: string;
             created_at?: string;
@@ -4083,6 +4117,12 @@ export interface components {
             /** Format: int32 */
             boosts_count?: number;
             boosts_url?: string;
+            /**
+             * @description Steps embedded in the Todo response (BC5 addition). The shared
+             *     `steps/step` jbuilder partial emits the same shape as `CardStep`,
+             *     so the existing `CardStepList` is reused.
+             */
+            steps?: components["schemas"]["CardStep"][];
         };
         TodoBucket: {
             /** Format: int64 */
@@ -4190,6 +4230,20 @@ export interface components {
             completed_ratio?: string;
             completed?: boolean;
             app_todolists_url?: string;
+            /**
+             * Format: int32
+             * @description Total count of todos across all todolists in this todoset (BC5 addition).
+             */
+            todos_count?: number;
+            /**
+             * Format: int32
+             * @description Count of completed loose todos at the todoset level (BC5 addition).
+             */
+            completed_loose_todos_count?: number;
+            /** @description API URL for listing todos directly under this todoset (BC5 addition). */
+            todos_url?: string;
+            /** @description In-app URL for viewing the todoset's todos (BC5 addition). */
+            app_todos_url?: string;
         };
         ToggleGaugeRequestContent: {
             gauge: components["schemas"]["GaugeTogglePayload"];

From d26f812c394780c1b853e4617f946b46d9807024 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:09 -0700
Subject: [PATCH 05/16] ruby: regenerate from BC5 spec additions

---
 ruby/lib/basecamp/generated/metadata.json |  4 +--
 ruby/lib/basecamp/generated/types.rb      | 32 ++++++++++++++++-------
 2 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/ruby/lib/basecamp/generated/metadata.json b/ruby/lib/basecamp/generated/metadata.json
index fcf9d9af1..2c184cb70 100644
--- a/ruby/lib/basecamp/generated/metadata.json
+++ b/ruby/lib/basecamp/generated/metadata.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-07-18T00:53:27Z",
+  "generated": "2026-05-01T22:48:07Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -2329,7 +2329,7 @@
         ]
       }
     },
-    "ReplaceTodo": {
+    "UpdateTodo": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
diff --git a/ruby/lib/basecamp/generated/types.rb b/ruby/lib/basecamp/generated/types.rb
index bcf1b9b6b..266fba542 100644
--- a/ruby/lib/basecamp/generated/types.rb
+++ b/ruby/lib/basecamp/generated/types.rb
@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated from OpenAPI spec. Do not edit manually.
-# Generated: 2026-07-18T00:53:27Z
+# Generated: 2026-05-01T22:48:07Z
 
 require "json"
 require "time"
@@ -2093,7 +2093,7 @@ def to_json(*args)
     # Notification
     class Notification
       include TypeHelpers
-      attr_accessor :created_at, :id, :updated_at, :app_url, :bookmark_url, :bucket_name, :content_excerpt, :creator, :image_url, :memory_url, :named, :participants, :previewable_attachments, :read_at, :readable_identifier, :readable_sgid, :section, :subscribed, :subscription_url, :title, :type, :unread_at, :unread_count, :unread_url
+      attr_accessor :created_at, :id, :updated_at, :app_url, :bookmark_url, :bubble_up_at, :bubble_up_url, :bucket_name, :content_excerpt, :creator, :image_url, :memory_url, :named, :participants, :previewable_attachments, :read_at, :readable_identifier, :readable_sgid, :section, :subscribed, :subscription_url, :title, :type, :unread_at, :unread_count, :unread_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -2106,6 +2106,8 @@ def initialize(data = {})
         @updated_at = parse_datetime(data["updated_at"])
         @app_url = data["app_url"]
         @bookmark_url = data["bookmark_url"]
+        @bubble_up_at = parse_datetime(data["bubble_up_at"])
+        @bubble_up_url = data["bubble_up_url"]
         @bucket_name = data["bucket_name"]
         @content_excerpt = data["content_excerpt"]
         @creator = parse_type(data["creator"], "Person")
@@ -2134,6 +2136,8 @@ def to_h
           "updated_at" => @updated_at,
           "app_url" => @app_url,
           "bookmark_url" => @bookmark_url,
+          "bubble_up_at" => @bubble_up_at,
+          "bubble_up_url" => @bubble_up_url,
           "bucket_name" => @bucket_name,
           "content_excerpt" => @content_excerpt,
           "creator" => @creator,
@@ -2246,7 +2250,7 @@ def to_json(*args)
     # Person
     class Person
       include TypeHelpers
-      attr_accessor :id, :name, :admin, :attachable_sgid, :avatar_url, :bio, :can_access_hill_charts, :can_access_timesheet, :can_manage_people, :can_manage_projects, :can_ping, :client, :company, :created_at, :email_address, :employee, :location, :owner, :personable_type, :time_zone, :title, :updated_at, :system_label
+      attr_accessor :id, :name, :admin, :attachable_sgid, :avatar_url, :bio, :can_access_hill_charts, :can_access_timesheet, :can_manage_people, :can_manage_projects, :can_ping, :client, :company, :created_at, :email_address, :employee, :location, :owner, :personable_type, :tagline, :time_zone, :title, :updated_at, :system_label
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -2274,6 +2278,7 @@ def initialize(data = {})
         @location = data["location"]
         @owner = parse_boolean(data["owner"])
         @personable_type = data["personable_type"]
+        @tagline = data["tagline"]
         @time_zone = data["time_zone"]
         @title = data["title"]
         @updated_at = parse_datetime(data["updated_at"])
@@ -2300,6 +2305,7 @@ def to_h
           "location" => @location,
           "owner" => @owner,
           "personable_type" => @personable_type,
+          "tagline" => @tagline,
           "time_zone" => @time_zone,
           "title" => @title,
           "updated_at" => @updated_at,
@@ -2427,7 +2433,7 @@ def to_json(*args)
     # Project
     class Project
       include TypeHelpers
-      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :end_date, :purpose, :start_date
+      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :purpose
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -2449,9 +2455,7 @@ def initialize(data = {})
         @clientside = parse_type(data["clientside"], "ClientSide")
         @description = data["description"]
         @dock = parse_array(data["dock"], "DockItem")
-        @end_date = data["end_date"]
         @purpose = data["purpose"]
-        @start_date = data["start_date"]
       end
 
       def to_h
@@ -2470,9 +2474,7 @@ def to_h
           "clientside" => @clientside,
           "description" => @description,
           "dock" => @dock,
-          "end_date" => @end_date,
           "purpose" => @purpose,
-          "start_date" => @start_date,
         }.compact
       end
 
@@ -3379,7 +3381,7 @@ def to_json(*args)
     # Todo
     class Todo
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :content, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completion_subscribers, :completion_url, :description, :due_on, :position, :starts_on, :subscription_url
+      attr_accessor :app_url, :bucket, :content, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completion_subscribers, :completion_url, :description, :due_on, :position, :starts_on, :steps, :subscription_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -3414,6 +3416,7 @@ def initialize(data = {})
         @due_on = data["due_on"]
         @position = parse_integer(data["position"])
         @starts_on = data["starts_on"]
+        @steps = parse_array(data["steps"], "CardStep")
         @subscription_url = data["subscription_url"]
       end
 
@@ -3446,6 +3449,7 @@ def to_h
           "due_on" => @due_on,
           "position" => @position,
           "starts_on" => @starts_on,
+          "steps" => @steps,
           "subscription_url" => @subscription_url,
         }.compact
       end
@@ -3666,7 +3670,7 @@ def to_json(*args)
     # Todoset
     class Todoset
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :name, :status, :title, :type, :updated_at, :url, :visible_to_clients, :app_todolists_url, :bookmark_url, :completed, :completed_ratio, :position, :todolists_count, :todolists_url
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :name, :status, :title, :type, :updated_at, :url, :visible_to_clients, :app_todolists_url, :app_todos_url, :bookmark_url, :completed, :completed_loose_todos_count, :completed_ratio, :position, :todolists_count, :todolists_url, :todos_count, :todos_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -3688,12 +3692,16 @@ def initialize(data = {})
         @url = data["url"]
         @visible_to_clients = parse_boolean(data["visible_to_clients"])
         @app_todolists_url = data["app_todolists_url"]
+        @app_todos_url = data["app_todos_url"]
         @bookmark_url = data["bookmark_url"]
         @completed = parse_boolean(data["completed"])
+        @completed_loose_todos_count = parse_integer(data["completed_loose_todos_count"])
         @completed_ratio = data["completed_ratio"]
         @position = parse_integer(data["position"])
         @todolists_count = parse_integer(data["todolists_count"])
         @todolists_url = data["todolists_url"]
+        @todos_count = parse_integer(data["todos_count"])
+        @todos_url = data["todos_url"]
       end
 
       def to_h
@@ -3712,12 +3720,16 @@ def to_h
           "url" => @url,
           "visible_to_clients" => @visible_to_clients,
           "app_todolists_url" => @app_todolists_url,
+          "app_todos_url" => @app_todos_url,
           "bookmark_url" => @bookmark_url,
           "completed" => @completed,
+          "completed_loose_todos_count" => @completed_loose_todos_count,
           "completed_ratio" => @completed_ratio,
           "position" => @position,
           "todolists_count" => @todolists_count,
           "todolists_url" => @todolists_url,
+          "todos_count" => @todos_count,
+          "todos_url" => @todos_url,
         }.compact
       end
 

From 7ef6d29da8ce10436d8c228f90da87488aee1ecb Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:10 -0700
Subject: [PATCH 06/16] python: regenerate from BC5 spec additions

---
 python/src/basecamp/generated/types.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/python/src/basecamp/generated/types.py b/python/src/basecamp/generated/types.py
index fc2530337..49082a158 100644
--- a/python/src/basecamp/generated/types.py
+++ b/python/src/basecamp/generated/types.py
@@ -706,8 +706,10 @@ class GetMyAssignmentsResponseContent(TypedDict):
 
 
 class GetMyNotificationsResponseContent(TypedDict):
+    bubble_ups: NotRequired[list[Notification]]
     memories: NotRequired[list[Notification]]
     reads: NotRequired[list[Notification]]
+    scheduled_bubble_ups: NotRequired[list[Notification]]
     unreads: NotRequired[list[Notification]]
 
 
@@ -890,6 +892,8 @@ class NotFoundErrorResponseContent(TypedDict):
 class Notification(TypedDict):
     app_url: NotRequired[str]
     bookmark_url: NotRequired[str]
+    bubble_up_at: NotRequired[str]
+    bubble_up_url: NotRequired[str]
     bucket_name: NotRequired[str]
     content_excerpt: NotRequired[str]
     created_at: str
@@ -957,6 +961,7 @@ class Person(TypedDict):
     name: str
     owner: NotRequired[bool]
     personable_type: NotRequired[str]
+    tagline: NotRequired[str]
     time_zone: NotRequired[str]
     title: NotRequired[str]
     updated_at: NotRequired[str]
@@ -1363,6 +1368,7 @@ class Todo(TypedDict):
     position: NotRequired[int]
     starts_on: NotRequired[str]
     status: str
+    steps: NotRequired[list[CardStep]]
     subscription_url: NotRequired[str]
     title: str
     type: str
@@ -1443,10 +1449,12 @@ class TodolistGroup(TypedDict):
 
 class Todoset(TypedDict):
     app_todolists_url: NotRequired[str]
+    app_todos_url: NotRequired[str]
     app_url: str
     bookmark_url: NotRequired[str]
     bucket: TodoBucket
     completed: NotRequired[bool]
+    completed_loose_todos_count: NotRequired[int]
     completed_ratio: NotRequired[str]
     created_at: str
     creator: Person
@@ -1458,6 +1466,8 @@ class Todoset(TypedDict):
     title: str
     todolists_count: NotRequired[int]
     todolists_url: NotRequired[str]
+    todos_count: NotRequired[int]
+    todos_url: NotRequired[str]
     type: str
     updated_at: str
     url: str

From 29b0ce98be881f50c87606bd55109912da18b21a Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:10 -0700
Subject: [PATCH 07/16] kotlin: regenerate from BC5 spec additions

---
 .../kotlin/com/basecamp/sdk/generated/models/Person.kt      | 1 +
 .../kotlin/com/basecamp/sdk/generated/models/Todo.kt        | 3 ++-
 .../kotlin/com/basecamp/sdk/generated/models/Todoset.kt     | 6 +++++-
 3 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Person.kt b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Person.kt
index 83dc00733..72df7ef47 100644
--- a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Person.kt
+++ b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Person.kt
@@ -22,6 +22,7 @@ data class Person(
     @SerialName("personable_type") val personableType: String? = null,
     val title: String? = null,
     val bio: String? = null,
+    val tagline: String? = null,
     val location: String? = null,
     @SerialName("created_at") val createdAt: String? = null,
     @SerialName("updated_at") val updatedAt: String? = null,
diff --git a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todo.kt b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todo.kt
index 117e8c9ef..bc8c82946 100644
--- a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todo.kt
+++ b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todo.kt
@@ -39,5 +39,6 @@ data class Todo(
     @SerialName("completion_subscribers") val completionSubscribers: List<Person> = emptyList(),
     @SerialName("completion_url") val completionUrl: String? = null,
     @SerialName("boosts_count") val boostsCount: Int = 0,
-    @SerialName("boosts_url") val boostsUrl: String? = null
+    @SerialName("boosts_url") val boostsUrl: String? = null,
+    val steps: List<CardStep> = emptyList()
 )
diff --git a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todoset.kt b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todoset.kt
index 0f9bd519b..0e9dddd5f 100644
--- a/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todoset.kt
+++ b/kotlin/sdk/src/commonMain/kotlin/com/basecamp/sdk/generated/models/Todoset.kt
@@ -31,5 +31,9 @@ data class Todoset(
     @SerialName("todolists_url") val todolistsUrl: String? = null,
     @SerialName("completed_ratio") val completedRatio: String? = null,
     val completed: Boolean = false,
-    @SerialName("app_todolists_url") val appTodolistsUrl: String? = null
+    @SerialName("app_todolists_url") val appTodolistsUrl: String? = null,
+    @SerialName("todos_count") val todosCount: Int = 0,
+    @SerialName("completed_loose_todos_count") val completedLooseTodosCount: Int = 0,
+    @SerialName("todos_url") val todosUrl: String? = null,
+    @SerialName("app_todos_url") val appTodosUrl: String? = null
 )

From b0bb5cb5ceb592ce3d08b85da55e7c15a3d97110 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:10 -0700
Subject: [PATCH 08/16] swift: regenerate from BC5 spec additions

---
 .../Models/GetMyNotificationsResponseContent.swift |  2 ++
 .../Basecamp/Generated/Models/Notification.swift   |  6 ++++++
 .../Sources/Basecamp/Generated/Models/Person.swift |  3 +++
 swift/Sources/Basecamp/Generated/Models/Todo.swift |  3 +++
 .../Basecamp/Generated/Models/Todoset.swift        | 14 +++++++++++++-
 5 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/swift/Sources/Basecamp/Generated/Models/GetMyNotificationsResponseContent.swift b/swift/Sources/Basecamp/Generated/Models/GetMyNotificationsResponseContent.swift
index 674374277..882493d5b 100644
--- a/swift/Sources/Basecamp/Generated/Models/GetMyNotificationsResponseContent.swift
+++ b/swift/Sources/Basecamp/Generated/Models/GetMyNotificationsResponseContent.swift
@@ -2,7 +2,9 @@
 import Foundation
 
 public struct GetMyNotificationsResponseContent: Codable, Sendable {
+    public var bubbleUps: [Notification]?
     public var memories: [Notification]?
     public var reads: [Notification]?
+    public var scheduledBubbleUps: [Notification]?
     public var unreads: [Notification]?
 }
diff --git a/swift/Sources/Basecamp/Generated/Models/Notification.swift b/swift/Sources/Basecamp/Generated/Models/Notification.swift
index 109bee095..7b10f4bd1 100644
--- a/swift/Sources/Basecamp/Generated/Models/Notification.swift
+++ b/swift/Sources/Basecamp/Generated/Models/Notification.swift
@@ -7,6 +7,8 @@ public struct Notification: Codable, Sendable {
     public let updatedAt: String
     public var appUrl: String?
     public var bookmarkUrl: String?
+    public var bubbleUpAt: String?
+    public var bubbleUpUrl: String?
     public var bucketName: String?
     public var contentExcerpt: String?
     public var creator: Person?
@@ -33,6 +35,8 @@ public struct Notification: Codable, Sendable {
         updatedAt: String,
         appUrl: String? = nil,
         bookmarkUrl: String? = nil,
+        bubbleUpAt: String? = nil,
+        bubbleUpUrl: String? = nil,
         bucketName: String? = nil,
         contentExcerpt: String? = nil,
         creator: Person? = nil,
@@ -58,6 +62,8 @@ public struct Notification: Codable, Sendable {
         self.updatedAt = updatedAt
         self.appUrl = appUrl
         self.bookmarkUrl = bookmarkUrl
+        self.bubbleUpAt = bubbleUpAt
+        self.bubbleUpUrl = bubbleUpUrl
         self.bucketName = bucketName
         self.contentExcerpt = contentExcerpt
         self.creator = creator
diff --git a/swift/Sources/Basecamp/Generated/Models/Person.swift b/swift/Sources/Basecamp/Generated/Models/Person.swift
index c1dffe54c..87ba5f54a 100644
--- a/swift/Sources/Basecamp/Generated/Models/Person.swift
+++ b/swift/Sources/Basecamp/Generated/Models/Person.swift
@@ -23,6 +23,7 @@ public struct Person: Codable, Sendable {
     public var location: String?
     public var owner: Bool?
     public var personableType: String?
+    public var tagline: String?
     public var timeZone: String?
     public var title: String?
     public var updatedAt: String?
@@ -47,6 +48,7 @@ public struct Person: Codable, Sendable {
         location: String? = nil,
         owner: Bool? = nil,
         personableType: String? = nil,
+        tagline: String? = nil,
         timeZone: String? = nil,
         title: String? = nil,
         updatedAt: String? = nil
@@ -70,6 +72,7 @@ public struct Person: Codable, Sendable {
         self.location = location
         self.owner = owner
         self.personableType = personableType
+        self.tagline = tagline
         self.timeZone = timeZone
         self.title = title
         self.updatedAt = updatedAt
diff --git a/swift/Sources/Basecamp/Generated/Models/Todo.swift b/swift/Sources/Basecamp/Generated/Models/Todo.swift
index 439210884..33702e53a 100644
--- a/swift/Sources/Basecamp/Generated/Models/Todo.swift
+++ b/swift/Sources/Basecamp/Generated/Models/Todo.swift
@@ -29,6 +29,7 @@ public struct Todo: Codable, Sendable {
     public var dueOn: String?
     public var position: Int32?
     public var startsOn: String?
+    public var steps: [CardStep]?
     public var subscriptionUrl: String?
 
     public init(
@@ -59,6 +60,7 @@ public struct Todo: Codable, Sendable {
         dueOn: String? = nil,
         position: Int32? = nil,
         startsOn: String? = nil,
+        steps: [CardStep]? = nil,
         subscriptionUrl: String? = nil
     ) {
         self.appUrl = appUrl
@@ -88,6 +90,7 @@ public struct Todo: Codable, Sendable {
         self.dueOn = dueOn
         self.position = position
         self.startsOn = startsOn
+        self.steps = steps
         self.subscriptionUrl = subscriptionUrl
     }
 }
diff --git a/swift/Sources/Basecamp/Generated/Models/Todoset.swift b/swift/Sources/Basecamp/Generated/Models/Todoset.swift
index 73bd97b3f..c1326d41e 100644
--- a/swift/Sources/Basecamp/Generated/Models/Todoset.swift
+++ b/swift/Sources/Basecamp/Generated/Models/Todoset.swift
@@ -16,12 +16,16 @@ public struct Todoset: Codable, Sendable {
     public let url: String
     public let visibleToClients: Bool
     public var appTodolistsUrl: String?
+    public var appTodosUrl: String?
     public var bookmarkUrl: String?
     public var completed: Bool?
+    public var completedLooseTodosCount: Int32?
     public var completedRatio: String?
     public var position: Int32?
     public var todolistsCount: Int32?
     public var todolistsUrl: String?
+    public var todosCount: Int32?
+    public var todosUrl: String?
 
     public init(
         appUrl: String,
@@ -38,12 +42,16 @@ public struct Todoset: Codable, Sendable {
         url: String,
         visibleToClients: Bool,
         appTodolistsUrl: String? = nil,
+        appTodosUrl: String? = nil,
         bookmarkUrl: String? = nil,
         completed: Bool? = nil,
+        completedLooseTodosCount: Int32? = nil,
         completedRatio: String? = nil,
         position: Int32? = nil,
         todolistsCount: Int32? = nil,
-        todolistsUrl: String? = nil
+        todolistsUrl: String? = nil,
+        todosCount: Int32? = nil,
+        todosUrl: String? = nil
     ) {
         self.appUrl = appUrl
         self.bucket = bucket
@@ -59,11 +67,15 @@ public struct Todoset: Codable, Sendable {
         self.url = url
         self.visibleToClients = visibleToClients
         self.appTodolistsUrl = appTodolistsUrl
+        self.appTodosUrl = appTodosUrl
         self.bookmarkUrl = bookmarkUrl
         self.completed = completed
+        self.completedLooseTodosCount = completedLooseTodosCount
         self.completedRatio = completedRatio
         self.position = position
         self.todolistsCount = todolistsCount
         self.todolistsUrl = todolistsUrl
+        self.todosCount = todosCount
+        self.todosUrl = todosUrl
     }
 }

From efcb1f7f66d940e7b15517783064ff2c5c93fad6 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Fri, 1 May 2026 15:21:10 -0700
Subject: [PATCH 09/16] go: regenerate from BC5 spec additions

---
 go/pkg/generated/client.gen.go | 111 +++++++++++++++++++++++----------
 1 file changed, 78 insertions(+), 33 deletions(-)

diff --git a/go/pkg/generated/client.gen.go b/go/pkg/generated/client.gen.go
index de31b19c1..ed5f820f4 100644
--- a/go/pkg/generated/client.gen.go
+++ b/go/pkg/generated/client.gen.go
@@ -999,9 +999,25 @@ type GetMyDueAssignmentsResponseContent = []MyAssignment
 
 // GetMyNotificationsResponseContent defines model for GetMyNotificationsResponseContent.
 type GetMyNotificationsResponseContent struct {
+	// BubbleUps Items the user has saved with Bubble Up (BC5 addition). Roughly the
+	// successor to `memories` but with optional scheduling — see
+	// `scheduled_bubble_ups` for the time-deferred subset.
+	BubbleUps []Notification `json:"bubble_ups,omitempty"`
+
+	// Memories Legacy "save forever" collection. Observed BC5 behavior: emits `[]`
+	// while BC4 still populates with real items — the BC team has not yet
+	// resolved whether to keep BC4-shaped data on BC5 (back-compat) or to
+	// accept the empty-array break with a documented BC5 changelog entry.
+	// See COORDINATION.md for the open decision. The conceptual
+	// replacement is `bubble_ups` (with optional scheduling via
+	// `scheduled_bubble_ups`), though wire shapes are not interchangeable
+	// per-item, so cross-version readers should consume both.
 	Memories []Notification `json:"memories,omitempty"`
 	Reads    []Notification `json:"reads,omitempty"`
-	Unreads  []Notification `json:"unreads,omitempty"`
+
+	// ScheduledBubbleUps Bubble Ups scheduled to resurface in the future (BC5 addition).
+	ScheduledBubbleUps []Notification `json:"scheduled_bubble_ups,omitempty"`
+	Unreads            []Notification `json:"unreads,omitempty"`
 }
 
 // GetMyPreferencesResponseContent defines model for GetMyPreferencesResponseContent.
@@ -1407,8 +1423,16 @@ type NotFoundErrorResponseContent struct {
 
 // Notification defines model for Notification.
 type Notification struct {
-	AppUrl         string    `json:"app_url,omitempty"`
-	BookmarkUrl    string    `json:"bookmark_url,omitempty"`
+	AppUrl      string `json:"app_url,omitempty"`
+	BookmarkUrl string `json:"bookmark_url,omitempty"`
+
+	// BubbleUpAt Scheduled resurfacing time when this item is queued as a scheduled
+	// Bubble Up (BC5 addition). Absent when there is no scheduled time.
+	BubbleUpAt time.Time `json:"bubble_up_at,omitempty"`
+
+	// BubbleUpUrl URL for the Bubble Up record covering this notification (BC5 addition).
+	// Eligibility-gated — only present on items the current user can bubble up.
+	BubbleUpUrl    string    `json:"bubble_up_url,omitempty"`
 	BucketName     string    `json:"bucket_name,omitempty"`
 	ContentExcerpt string    `json:"content_excerpt,omitempty"`
 	CreatedAt      time.Time `json:"created_at"`
@@ -1489,9 +1513,13 @@ type Person struct {
 	Name                string              `json:"name"`
 	Owner               bool                `json:"owner,omitempty"`
 	PersonableType      string              `json:"personable_type,omitempty"`
-	TimeZone            string              `json:"time_zone,omitempty"`
-	Title               string              `json:"title,omitempty"`
-	UpdatedAt           time.Time           `json:"updated_at,omitempty"`
+
+	// Tagline Alias of `bio` introduced in BC5. BC3 emits both keys with identical content;
+	// older BC4 responses may omit `tagline`. Prefer `bio` for cross-version reads.
+	Tagline   string    `json:"tagline,omitempty"`
+	TimeZone  string    `json:"time_zone,omitempty"`
+	Title     string    `json:"title,omitempty"`
+	UpdatedAt time.Time `json:"updated_at,omitempty"`
 }
 
 // PersonCompany defines model for PersonCompany.
@@ -1966,13 +1994,18 @@ type Todo struct {
 	StartsOn              types.Date `json:"starts_on,omitempty"`
 
 	// Status active|archived|trashed
-	Status           string    `json:"status"`
-	SubscriptionUrl  string    `json:"subscription_url,omitempty"`
-	Title            string    `json:"title"`
-	Type             string    `json:"type"`
-	UpdatedAt        time.Time `json:"updated_at"`
-	Url              string    `json:"url"`
-	VisibleToClients bool      `json:"visible_to_clients"`
+	Status string `json:"status"`
+
+	// Steps Steps embedded in the Todo response (BC5 addition). The shared
+	// `steps/step` jbuilder partial emits the same shape as `CardStep`,
+	// so the existing `CardStepList` is reused.
+	Steps            []CardStep `json:"steps,omitempty"`
+	SubscriptionUrl  string     `json:"subscription_url,omitempty"`
+	Title            string     `json:"title"`
+	Type             string     `json:"type"`
+	UpdatedAt        time.Time  `json:"updated_at"`
+	Url              string     `json:"url"`
+	VisibleToClients bool       `json:"visible_to_clients"`
 }
 
 // TodoBucket defines model for TodoBucket.
@@ -2068,26 +2101,38 @@ type TodolistOrGroup1 struct {
 
 // Todoset defines model for Todoset.
 type Todoset struct {
-	AppTodolistsUrl  string     `json:"app_todolists_url,omitempty"`
-	AppUrl           string     `json:"app_url"`
-	BookmarkUrl      string     `json:"bookmark_url,omitempty"`
-	Bucket           TodoBucket `json:"bucket"`
-	Completed        bool       `json:"completed,omitempty"`
-	CompletedRatio   string     `json:"completed_ratio,omitempty"`
-	CreatedAt        time.Time  `json:"created_at"`
-	Creator          Person     `json:"creator"`
-	Id               int64      `json:"id"`
-	InheritsStatus   bool       `json:"inherits_status"`
-	Name             string     `json:"name"`
-	Position         int32      `json:"position,omitempty"`
-	Status           string     `json:"status"`
-	Title            string     `json:"title"`
-	TodolistsCount   int32      `json:"todolists_count,omitempty"`
-	TodolistsUrl     string     `json:"todolists_url,omitempty"`
-	Type             string     `json:"type"`
-	UpdatedAt        time.Time  `json:"updated_at"`
-	Url              string     `json:"url"`
-	VisibleToClients bool       `json:"visible_to_clients"`
+	AppTodolistsUrl string `json:"app_todolists_url,omitempty"`
+
+	// AppTodosUrl In-app URL for viewing the todoset's todos (BC5 addition).
+	AppTodosUrl string     `json:"app_todos_url,omitempty"`
+	AppUrl      string     `json:"app_url"`
+	BookmarkUrl string     `json:"bookmark_url,omitempty"`
+	Bucket      TodoBucket `json:"bucket"`
+	Completed   bool       `json:"completed,omitempty"`
+
+	// CompletedLooseTodosCount Count of completed loose todos at the todoset level (BC5 addition).
+	CompletedLooseTodosCount int32     `json:"completed_loose_todos_count,omitempty"`
+	CompletedRatio           string    `json:"completed_ratio,omitempty"`
+	CreatedAt                time.Time `json:"created_at"`
+	Creator                  Person    `json:"creator"`
+	Id                       int64     `json:"id"`
+	InheritsStatus           bool      `json:"inherits_status"`
+	Name                     string    `json:"name"`
+	Position                 int32     `json:"position,omitempty"`
+	Status                   string    `json:"status"`
+	Title                    string    `json:"title"`
+	TodolistsCount           int32     `json:"todolists_count,omitempty"`
+	TodolistsUrl             string    `json:"todolists_url,omitempty"`
+
+	// TodosCount Total count of todos across all todolists in this todoset (BC5 addition).
+	TodosCount int32 `json:"todos_count,omitempty"`
+
+	// TodosUrl API URL for listing todos directly under this todoset (BC5 addition).
+	TodosUrl         string    `json:"todos_url,omitempty"`
+	Type             string    `json:"type"`
+	UpdatedAt        time.Time `json:"updated_at"`
+	Url              string    `json:"url"`
+	VisibleToClients bool      `json:"visible_to_clients"`
 }
 
 // ToggleGaugeRequestContent defines model for ToggleGaugeRequestContent.

From 5e12e2aa601960e946370f4d4dfcfc456a21e87d Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Wed, 13 May 2026 13:43:05 -0700
Subject: [PATCH 10/16] typescript: pin fast-uri and brace-expansion via
 overrides
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Both come in transitively via openapi-typescript → @redocly/openapi-core
(fast-uri through @redocly/ajv, brace-expansion through minimatch).
npm audit on the affected versions reports:

  fast-uri ≤3.1.1 — high — path traversal + host confusion
  (GHSA-q3j6-qgpj-74h6 / GHSA-v39h-62p7-jpjc)
  brace-expansion 4.0.0–5.0.4 — moderate — zero-step sequence
  hangs the process (GHSA-f886-m6hf-6m8v)

Lift both to the patched majors via overrides (alongside the existing
minimatch pin). The override path is preferred over plain dependency
bumps because the SDK doesn't depend on either package directly —
the responsibility for forwarding the fix sits with this repo until
the upstream packages cut new releases that pull the patches in
transitively.

Lands at the bottom of the BC5 stack so the wire-replay PRs above
(#294, #301) inherit the fix on rebase.
---
 typescript/package-lock.json | 8 ++++----
 typescript/package.json      | 4 +++-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/typescript/package-lock.json b/typescript/package-lock.json
index 014548134..747ec5516 100644
--- a/typescript/package-lock.json
+++ b/typescript/package-lock.json
@@ -1737,16 +1737,16 @@
       }
     },
     "node_modules/brace-expansion": {
-      "version": "5.0.2",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.2.tgz",
-      "integrity": "sha512-Pdk8c9poy+YhOgVWw1JNN22/HcivgKWwpxKq04M/jTmHyCZn12WPJebZxdjSa5TmBqISrUSgNYU3eRORljfCCw==",
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
+      "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "balanced-match": "^4.0.2"
       },
       "engines": {
-        "node": "20 || >=22"
+        "node": "18 || 20 || >=22"
       }
     },
     "node_modules/chai": {
diff --git a/typescript/package.json b/typescript/package.json
index 916bca651..38227c2c5 100644
--- a/typescript/package.json
+++ b/typescript/package.json
@@ -66,6 +66,8 @@
     "typescript": ">=5.0.0"
   },
   "overrides": {
-    "minimatch": ">=10.2.1"
+    "minimatch": ">=10.2.1",
+    "brace-expansion": ">=5.0.6",
+    "fast-uri": ">=3.1.2"
   }
 }

From 8237f1ad59f1ce74107acb834124d0d2e63f0cc8 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@37signals.com>
Date: Wed, 13 May 2026 13:47:24 -0700
Subject: [PATCH 11/16] spec: address Copilot review threads on bucket-parity
 lint + brief
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

scripts/check-bucket-flat-parity.sh — drop `--slurpfile spec` and read
the spec via positional input instead. The previous form passed the
spec to jq twice (once via --slurpfile, once positionally), so jq
parsed it twice per invocation. Reading once via positional input then
binding `. as \$s` for cross-iteration access preserves the same
schema-resolution behavior with a single parse.

spec/api-gaps/todoset-completed-list-visibility.md — rewrite the
"PR 1 must classify" sentence so the constraint reads on its own,
without requiring the umbrella-plan cross-reference. The brief now
notes that classification must come from the BC3 side and the brief
stays in the registry either way; readers no longer need to know
which PR "PR 1" referred to.
---
 scripts/check-bucket-flat-parity.sh                | 4 ++--
 spec/api-gaps/todoset-completed-list-visibility.md | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/scripts/check-bucket-flat-parity.sh b/scripts/check-bucket-flat-parity.sh
index e563f712a..b2e44e102 100755
--- a/scripts/check-bucket-flat-parity.sh
+++ b/scripts/check-bucket-flat-parity.sh
@@ -41,8 +41,8 @@ fi
 # A "list" response is a top-level array (recursively resolving $ref one level).
 # jq exits non-zero for invalid OpenAPI / broken filter — let it fail loud rather
 # than silently turning bad input into "0 operations found".
-CANDIDATES=$(jq -r --slurpfile spec "$SPEC" '
-  $spec[0] as $s
+CANDIDATES=$(jq -r '
+  . as $s
   | $s.paths
   | to_entries[]
   | select(.key | test("^/\\{accountId\\}/buckets/\\{bucketId\\}/[^/]+(/\\{[^}]+\\})?\\.json$"))
diff --git a/spec/api-gaps/todoset-completed-list-visibility.md b/spec/api-gaps/todoset-completed-list-visibility.md
index b7f33989f..fe55fb5d1 100644
--- a/spec/api-gaps/todoset-completed-list-visibility.md
+++ b/spec/api-gaps/todoset-completed-list-visibility.md
@@ -23,8 +23,9 @@ A new route `todosets/completed_list_visibility` was detected on
 list at the todoset level (matches the existing UI toggle).
 
 **This entry is currently `ambiguous`**: the BC3 plan has not classified
-whether this is an API-shaped resource or UI-only state. PR 1 must classify
-it before merging:
+whether this is an API-shaped resource or UI-only state. Classification
+must happen on the BC3 side (the SDK can't determine the right answer
+unilaterally); the brief stays in the registry either way:
 
 - If JSON-API: SDK absorbs as `UpdateTodosetCompletedListVisibility` op,
   this entry flips to `no-json-contract` and the absorption PR ships once

From dd92588d5706cab0c170ff706094cf1061c33c63 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@hey.com>
Date: Mon, 13 Jul 2026 19:23:53 -0700
Subject: [PATCH 12/16] make: iterate compatibility provenance blocks
 generically in sync-status

The sync-status target hardcoded the .compatibility.bc3-master key, which
broke when the post-launch repin renamed the BC4 baseline block to
bc3-four (BC4 now lives on the four branch; master is BC5). Loop over
.compatibility | keys[] instead so any set of compatibility baselines
gets its own labeled drift report without further Makefile edits.
---
 Makefile | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/Makefile b/Makefile
index 4324add56..837d745c2 100644
--- a/Makefile
+++ b/Makefile
@@ -108,14 +108,13 @@ sync-status:
 		"$$(jq -r '.bc3.revision // empty' spec/api-provenance.json)" \
 		"$$(jq -r '.bc3.branch // "master"' spec/api-provenance.json)" \
 		"primary"
-	@COMPAT_REV=$$(jq -r '.compatibility["bc3-master"].revision // empty' spec/api-provenance.json); \
-	if [ -n "$$COMPAT_REV" ]; then \
+	@for COMPAT_KEY in $$(jq -r '.compatibility // {} | keys[]' spec/api-provenance.json); do \
 		echo ""; \
 		./scripts/report-bc3-drift.sh \
-			"$$COMPAT_REV" \
-			"$$(jq -r '.compatibility["bc3-master"].branch // "master"' spec/api-provenance.json)" \
+			"$$(jq -r --arg k "$$COMPAT_KEY" '.compatibility[$$k].revision // empty' spec/api-provenance.json)" \
+			"$$(jq -r --arg k "$$COMPAT_KEY" '.compatibility[$$k].branch // "master"' spec/api-provenance.json)" \
 			"compat"; \
-	fi
+	done
 
 #------------------------------------------------------------------------------
 # Version management

From 839b69037f5a58e838089c9df31dcee46803b498 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@hey.com>
Date: Mon, 13 Jul 2026 19:23:53 -0700
Subject: [PATCH 13/16] regen: reconcile generated artifacts after rebase onto
 main

make generate over the hand-merged spec picks up both main's project
schedule dates (#302) and this branch's BC5 forward-compat additions,
and stamps the api-provenance repin (bc3 = master @ 415b54cc, BC4
compatibility baseline = four @ 9d73959a) through the Go provenance
mirror. go.work.sum picks up entries from the go generate dep download.
---
 go.work.sum                                   |    2 +
 go/pkg/generated/client.gen.go                | 1646 +++++++++++++++++
 openapi.json                                  |  124 +-
 ruby/lib/basecamp/generated/metadata.json     |    4 +-
 ruby/lib/basecamp/generated/types.rb          |    8 +-
 typescript/src/generated/metadata.ts          |   47 +-
 .../src/generated/openapi-stripped.json       |  124 +-
 7 files changed, 1837 insertions(+), 118 deletions(-)

diff --git a/go.work.sum b/go.work.sum
index f99408c11..1b4a32541 100644
--- a/go.work.sum
+++ b/go.work.sum
@@ -34,6 +34,7 @@ github.com/gabriel-vasile/mimetype v1.4.3/go.mod h1:d8uq/6HKRL6CGdk+aubisF/M5GcP
 github.com/gin-contrib/sse v0.1.0/go.mod h1:RHrZQHXnP2xjPF+u1gW/2HnVO7nvIa9PG3Gm+fLHvGI=
 github.com/gin-gonic/gin v1.10.1/go.mod h1:4PMNQiOhvDRa013RKVbsiNwoyezlm2rm0uX/T7kzp5Y=
 github.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0=
+github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE=
 github.com/go-playground/assert/v2 v2.2.0/go.mod h1:VDjEfimB/XKnb+ZQfWdccd7VUvScMdVu0Titje2rxJ4=
 github.com/go-playground/locales v0.14.1/go.mod h1:hxrqLVvrK65+Rwrd5Fc6F2O76J/NuW9t0sjnWqG1slY=
 github.com/go-playground/universal-translator v0.18.1/go.mod h1:xekY+UJKNuX9WP91TpwSH2VMlDf28Uj24BCp08ZFTUY=
@@ -86,6 +87,7 @@ github.com/labstack/gommon v0.4.2/go.mod h1:QlUFxVM+SNXhDL/Z7YhocGIBYOiwB0mXm1+1
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
 github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0/go.mod h1:zJYVVT2jmtg6P3p1VtQj7WsuWi/y4VnjVBn7F8KPB3I=
 github.com/mailgun/raymond/v2 v2.0.48/go.mod h1:lsgvL50kgt1ylcFJYZiULi5fjPBkkhNfj4KA0W54Z18=
+github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
 github.com/matryer/try v0.0.0-20161228173917-9ac251b645a2/go.mod h1:0KeJpeMD6o+O4hW7qJOT7vyQPKrWmj26uf5wMc/IiIs=
 github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
 github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
diff --git a/go/pkg/generated/client.gen.go b/go/pkg/generated/client.gen.go
index ed5f820f4..52422dc81 100644
--- a/go/pkg/generated/client.gen.go
+++ b/go/pkg/generated/client.gen.go
@@ -36,6 +36,28 @@ const (
 	Wednesday FirstWeekDay = "Wednesday"
 )
 
+// Valid indicates whether the value is a known member of the FirstWeekDay enum.
+func (e FirstWeekDay) Valid() bool {
+	switch e {
+	case Friday:
+		return true
+	case Monday:
+		return true
+	case Saturday:
+		return true
+	case Sunday:
+		return true
+	case Thursday:
+		return true
+	case Tuesday:
+		return true
+	case Wednesday:
+		return true
+	default:
+		return false
+	}
+}
+
 // Account defines model for Account.
 type Account struct {
 	Active       bool                `json:"active,omitempty"`
@@ -18844,6 +18866,14 @@ func (r GetAccountResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetAccountResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type RemoveAccountLogoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -18869,6 +18899,14 @@ func (r RemoveAccountLogoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r RemoveAccountLogoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateAccountLogoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -18895,6 +18933,14 @@ func (r UpdateAccountLogoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateAccountLogoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateAccountNameResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -18922,6 +18968,14 @@ func (r UpdateAccountNameResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateAccountNameResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateAttachmentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -18949,6 +19003,14 @@ func (r CreateAttachmentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateAttachmentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteBoostResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -18974,6 +19036,14 @@ func (r DeleteBoostResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteBoostResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetBoostResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19000,6 +19070,14 @@ func (r GetBoostResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetBoostResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SetCardColumnColorResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19028,6 +19106,14 @@ func (r SetCardColumnColorResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SetCardColumnColorResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DisableCardColumnOnHoldResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19055,6 +19141,14 @@ func (r DisableCardColumnOnHoldResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DisableCardColumnOnHoldResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type EnableCardColumnOnHoldResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19082,6 +19176,14 @@ func (r EnableCardColumnOnHoldResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r EnableCardColumnOnHoldResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListWebhooksResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19108,6 +19210,14 @@ func (r ListWebhooksResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListWebhooksResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateWebhookResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19136,6 +19246,14 @@ func (r CreateWebhookResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateWebhookResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19162,6 +19280,14 @@ func (r GetCardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateCardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19189,6 +19315,14 @@ func (r UpdateCardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateCardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type MoveCardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19215,6 +19349,14 @@ func (r MoveCardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r MoveCardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type RepositionCardStepResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19241,6 +19383,14 @@ func (r RepositionCardStepResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r RepositionCardStepResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCardStepResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19268,6 +19418,14 @@ func (r CreateCardStepResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCardStepResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19294,6 +19452,14 @@ func (r GetCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19321,6 +19487,14 @@ func (r UpdateCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListCardsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19347,6 +19521,14 @@ func (r ListCardsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListCardsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19374,6 +19556,14 @@ func (r CreateCardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UnsubscribeFromCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19399,6 +19589,14 @@ func (r UnsubscribeFromCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UnsubscribeFromCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SubscribeToCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19425,6 +19623,14 @@ func (r SubscribeToCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SubscribeToCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCardStepResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19451,6 +19657,14 @@ func (r GetCardStepResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCardStepResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateCardStepResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19478,6 +19692,14 @@ func (r UpdateCardStepResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateCardStepResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SetCardStepCompletionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19505,6 +19727,14 @@ func (r SetCardStepCompletionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SetCardStepCompletionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCardTableResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19531,6 +19761,14 @@ func (r GetCardTableResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCardTableResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19558,6 +19796,14 @@ func (r CreateCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type MoveCardColumnResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19584,6 +19830,14 @@ func (r MoveCardColumnResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r MoveCardColumnResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListMessageTypesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19610,6 +19864,14 @@ func (r ListMessageTypesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListMessageTypesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateMessageTypeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19637,6 +19899,14 @@ func (r CreateMessageTypeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateMessageTypeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteMessageTypeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19662,6 +19932,14 @@ func (r DeleteMessageTypeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteMessageTypeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMessageTypeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19688,6 +19966,14 @@ func (r GetMessageTypeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMessageTypeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateMessageTypeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19715,6 +20001,14 @@ func (r UpdateMessageTypeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateMessageTypeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListCampfiresResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19741,6 +20035,14 @@ func (r ListCampfiresResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListCampfiresResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCampfireResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19767,6 +20069,14 @@ func (r GetCampfireResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCampfireResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListChatbotsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19793,6 +20103,14 @@ func (r ListChatbotsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListChatbotsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateChatbotResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19820,6 +20138,14 @@ func (r CreateChatbotResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateChatbotResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteChatbotResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19845,6 +20171,14 @@ func (r DeleteChatbotResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteChatbotResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetChatbotResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19871,6 +20205,14 @@ func (r GetChatbotResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetChatbotResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateChatbotResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19898,6 +20240,14 @@ func (r UpdateChatbotResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateChatbotResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListCampfireLinesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19924,6 +20274,14 @@ func (r ListCampfireLinesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListCampfireLinesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCampfireLineResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19951,6 +20309,14 @@ func (r CreateCampfireLineResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCampfireLineResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteCampfireLineResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -19976,6 +20342,14 @@ func (r DeleteCampfireLineResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteCampfireLineResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCampfireLineResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20002,6 +20376,14 @@ func (r GetCampfireLineResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCampfireLineResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListCampfireUploadsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20028,6 +20410,14 @@ func (r ListCampfireUploadsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListCampfireUploadsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCampfireUploadResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20055,6 +20445,14 @@ func (r CreateCampfireUploadResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCampfireUploadResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListPingablePeopleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20081,6 +20479,14 @@ func (r ListPingablePeopleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListPingablePeopleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListClientApprovalsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20107,6 +20513,14 @@ func (r ListClientApprovalsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListClientApprovalsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetClientApprovalResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20133,6 +20547,14 @@ func (r GetClientApprovalResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetClientApprovalResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListClientCorrespondencesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20159,6 +20581,14 @@ func (r ListClientCorrespondencesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListClientCorrespondencesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetClientCorrespondenceResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20185,6 +20615,14 @@ func (r GetClientCorrespondenceResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetClientCorrespondenceResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListClientRepliesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20211,6 +20649,14 @@ func (r ListClientRepliesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListClientRepliesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetClientReplyResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20237,6 +20683,14 @@ func (r GetClientReplyResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetClientReplyResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetCommentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20263,6 +20717,14 @@ func (r GetCommentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetCommentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateCommentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20290,6 +20752,14 @@ func (r UpdateCommentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateCommentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CloneToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20317,6 +20787,14 @@ func (r CloneToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CloneToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20342,6 +20820,14 @@ func (r DeleteToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20368,6 +20854,14 @@ func (r GetToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20395,6 +20889,14 @@ func (r UpdateToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetDocumentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20421,6 +20923,14 @@ func (r GetDocumentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetDocumentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateDocumentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20448,6 +20958,14 @@ func (r UpdateDocumentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateDocumentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DestroyGaugeNeedleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20474,6 +20992,14 @@ func (r DestroyGaugeNeedleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DestroyGaugeNeedleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetGaugeNeedleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20500,6 +21026,14 @@ func (r GetGaugeNeedleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetGaugeNeedleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateGaugeNeedleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20528,6 +21062,14 @@ func (r UpdateGaugeNeedleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateGaugeNeedleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetForwardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20554,6 +21096,14 @@ func (r GetForwardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetForwardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListForwardRepliesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20580,6 +21130,14 @@ func (r ListForwardRepliesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListForwardRepliesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateForwardReplyResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20607,6 +21165,14 @@ func (r CreateForwardReplyResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateForwardReplyResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetForwardReplyResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20633,6 +21199,14 @@ func (r GetForwardReplyResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetForwardReplyResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetInboxResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20659,6 +21233,14 @@ func (r GetInboxResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetInboxResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListForwardsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20685,6 +21267,14 @@ func (r ListForwardsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListForwardsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListLineupMarkersResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20711,6 +21301,14 @@ func (r ListLineupMarkersResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListLineupMarkersResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateLineupMarkerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20737,6 +21335,14 @@ func (r CreateLineupMarkerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateLineupMarkerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteLineupMarkerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20762,6 +21368,14 @@ func (r DeleteLineupMarkerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteLineupMarkerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateLineupMarkerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20788,6 +21402,14 @@ func (r UpdateLineupMarkerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateLineupMarkerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMessageBoardResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20814,6 +21436,14 @@ func (r GetMessageBoardResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMessageBoardResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListMessagesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20840,6 +21470,14 @@ func (r ListMessagesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListMessagesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateMessageResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20867,6 +21505,14 @@ func (r CreateMessageResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateMessageResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMessageResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20893,6 +21539,14 @@ func (r GetMessageResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMessageResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateMessageResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20920,6 +21574,14 @@ func (r UpdateMessageResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateMessageResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyAssignmentsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20945,6 +21607,14 @@ func (r GetMyAssignmentsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyAssignmentsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyCompletedAssignmentsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20970,6 +21640,14 @@ func (r GetMyCompletedAssignmentsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyCompletedAssignmentsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyDueAssignmentsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -20996,6 +21674,14 @@ func (r GetMyDueAssignmentsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyDueAssignmentsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyPreferencesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21021,6 +21707,14 @@ func (r GetMyPreferencesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyPreferencesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateMyPreferencesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21048,6 +21742,14 @@ func (r UpdateMyPreferencesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateMyPreferencesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyProfileResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21074,6 +21776,14 @@ func (r GetMyProfileResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyProfileResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateMyProfileResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21099,6 +21809,14 @@ func (r UpdateMyProfileResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateMyProfileResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetQuestionRemindersResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21125,6 +21843,14 @@ func (r GetQuestionRemindersResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetQuestionRemindersResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetMyNotificationsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21150,6 +21876,14 @@ func (r GetMyNotificationsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetMyNotificationsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type MarkAsReadResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21175,6 +21909,14 @@ func (r MarkAsReadResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r MarkAsReadResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListPeopleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21201,6 +21943,14 @@ func (r ListPeopleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListPeopleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetPersonResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21227,6 +21977,14 @@ func (r GetPersonResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetPersonResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DisableOutOfOfficeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21252,6 +22010,14 @@ func (r DisableOutOfOfficeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DisableOutOfOfficeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetOutOfOfficeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21278,6 +22044,14 @@ func (r GetOutOfOfficeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetOutOfOfficeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type EnableOutOfOfficeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21305,6 +22079,14 @@ func (r EnableOutOfOfficeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r EnableOutOfOfficeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListProjectsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21331,6 +22113,14 @@ func (r ListProjectsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListProjectsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateProjectResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21358,6 +22148,14 @@ func (r CreateProjectResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateProjectResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListRecordingsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21384,6 +22182,14 @@ func (r ListRecordingsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListRecordingsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type TrashProjectResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21409,6 +22215,14 @@ func (r TrashProjectResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r TrashProjectResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetProjectResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21435,6 +22249,14 @@ func (r GetProjectResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetProjectResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateProjectResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21462,6 +22284,14 @@ func (r UpdateProjectResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateProjectResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ToggleGaugeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21487,6 +22317,14 @@ func (r ToggleGaugeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ToggleGaugeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListGaugeNeedlesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21514,6 +22352,14 @@ func (r ListGaugeNeedlesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListGaugeNeedlesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateGaugeNeedleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21541,6 +22387,14 @@ func (r CreateGaugeNeedleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateGaugeNeedleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListProjectPeopleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21567,6 +22421,14 @@ func (r ListProjectPeopleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListProjectPeopleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateProjectAccessResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21595,6 +22457,14 @@ func (r UpdateProjectAccessResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateProjectAccessResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetProjectTimelineResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21622,6 +22492,14 @@ func (r GetProjectTimelineResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetProjectTimelineResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetProjectTimesheetResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21648,6 +22526,14 @@ func (r GetProjectTimesheetResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetProjectTimesheetResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetAnswerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21674,6 +22560,14 @@ func (r GetAnswerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetAnswerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateAnswerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21700,6 +22594,14 @@ func (r UpdateAnswerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateAnswerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetQuestionnaireResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21726,6 +22628,14 @@ func (r GetQuestionnaireResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetQuestionnaireResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListQuestionsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21752,6 +22662,14 @@ func (r ListQuestionsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListQuestionsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateQuestionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21779,6 +22697,14 @@ func (r CreateQuestionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateQuestionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetQuestionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21805,6 +22731,14 @@ func (r GetQuestionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetQuestionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateQuestionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21832,6 +22766,14 @@ func (r UpdateQuestionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateQuestionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListAnswersResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21858,6 +22800,14 @@ func (r ListAnswersResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListAnswersResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateAnswerResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21885,6 +22835,14 @@ func (r CreateAnswerResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateAnswerResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListQuestionAnswerersResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21912,6 +22870,14 @@ func (r ListQuestionAnswerersResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListQuestionAnswerersResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetAnswersByPersonResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21939,6 +22905,14 @@ func (r GetAnswersByPersonResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetAnswersByPersonResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateQuestionNotificationSettingsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21966,6 +22940,14 @@ func (r UpdateQuestionNotificationSettingsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateQuestionNotificationSettingsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ResumeQuestionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -21992,6 +22974,14 @@ func (r ResumeQuestionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ResumeQuestionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type PauseQuestionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22019,6 +23009,14 @@ func (r PauseQuestionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r PauseQuestionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UnpinMessageResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22044,6 +23042,14 @@ func (r UnpinMessageResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UnpinMessageResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type PinMessageResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22070,6 +23076,14 @@ func (r PinMessageResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r PinMessageResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetRecordingResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22096,6 +23110,14 @@ func (r GetRecordingResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetRecordingResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListRecordingBoostsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22122,6 +23144,14 @@ func (r ListRecordingBoostsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListRecordingBoostsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateRecordingBoostResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22149,6 +23179,14 @@ func (r CreateRecordingBoostResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateRecordingBoostResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SetClientVisibilityResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22176,6 +23214,14 @@ func (r SetClientVisibilityResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SetClientVisibilityResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListCommentsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22202,6 +23248,14 @@ func (r ListCommentsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListCommentsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateCommentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22229,6 +23283,14 @@ func (r CreateCommentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateCommentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListEventsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22255,6 +23317,14 @@ func (r ListEventsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListEventsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListEventBoostsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22281,6 +23351,14 @@ func (r ListEventBoostsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListEventBoostsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateEventBoostResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22308,6 +23386,14 @@ func (r CreateEventBoostResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateEventBoostResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UnarchiveRecordingResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22334,6 +23420,14 @@ func (r UnarchiveRecordingResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UnarchiveRecordingResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ArchiveRecordingResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22360,6 +23454,14 @@ func (r ArchiveRecordingResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ArchiveRecordingResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type TrashRecordingResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22386,6 +23488,14 @@ func (r TrashRecordingResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r TrashRecordingResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UnsubscribeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22411,6 +23521,14 @@ func (r UnsubscribeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UnsubscribeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetSubscriptionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22437,6 +23555,14 @@ func (r GetSubscriptionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetSubscriptionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SubscribeResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22464,6 +23590,14 @@ func (r SubscribeResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SubscribeResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateSubscriptionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22491,6 +23625,14 @@ func (r UpdateSubscriptionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateSubscriptionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetRecordingTimesheetResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22517,6 +23659,14 @@ func (r GetRecordingTimesheetResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetRecordingTimesheetResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateTimesheetEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22544,6 +23694,14 @@ func (r CreateTimesheetEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateTimesheetEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DisableToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22569,6 +23727,14 @@ func (r DisableToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DisableToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type EnableToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22595,6 +23761,14 @@ func (r EnableToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r EnableToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type RepositionToolResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22621,6 +23795,14 @@ func (r RepositionToolResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r RepositionToolResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListGaugesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22647,6 +23829,14 @@ func (r ListGaugesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListGaugesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetProgressReportResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22673,6 +23863,14 @@ func (r GetProgressReportResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetProgressReportResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetUpcomingScheduleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22699,6 +23897,14 @@ func (r GetUpcomingScheduleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetUpcomingScheduleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTimesheetReportResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22725,6 +23931,14 @@ func (r GetTimesheetReportResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTimesheetReportResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListAssignablePeopleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22751,6 +23965,14 @@ func (r ListAssignablePeopleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListAssignablePeopleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetAssignedTodosResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22778,6 +24000,14 @@ func (r GetAssignedTodosResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetAssignedTodosResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetOverdueTodosResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22804,6 +24034,14 @@ func (r GetOverdueTodosResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetOverdueTodosResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetPersonProgressResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22831,6 +24069,14 @@ func (r GetPersonProgressResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetPersonProgressResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetScheduleEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22857,6 +24103,14 @@ func (r GetScheduleEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetScheduleEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateScheduleEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22884,6 +24138,14 @@ func (r UpdateScheduleEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateScheduleEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetScheduleEntryOccurrenceResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22910,6 +24172,14 @@ func (r GetScheduleEntryOccurrenceResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetScheduleEntryOccurrenceResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetScheduleResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22936,6 +24206,14 @@ func (r GetScheduleResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetScheduleResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateScheduleSettingsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22963,6 +24241,14 @@ func (r UpdateScheduleSettingsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateScheduleSettingsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListScheduleEntriesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -22989,6 +24275,14 @@ func (r ListScheduleEntriesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListScheduleEntriesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateScheduleEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23016,6 +24310,14 @@ func (r CreateScheduleEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateScheduleEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type SearchResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23042,6 +24344,14 @@ func (r SearchResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r SearchResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetSearchMetadataResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23068,6 +24378,14 @@ func (r GetSearchMetadataResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetSearchMetadataResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListTemplatesResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23094,6 +24412,14 @@ func (r ListTemplatesResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListTemplatesResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateTemplateResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23121,6 +24447,14 @@ func (r CreateTemplateResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateTemplateResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteTemplateResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23146,6 +24480,14 @@ func (r DeleteTemplateResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteTemplateResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTemplateResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23172,6 +24514,14 @@ func (r GetTemplateResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTemplateResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateTemplateResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23199,6 +24549,14 @@ func (r UpdateTemplateResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateTemplateResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateProjectFromTemplateResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23226,6 +24584,14 @@ func (r CreateProjectFromTemplateResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateProjectFromTemplateResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetProjectConstructionResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23252,6 +24618,14 @@ func (r GetProjectConstructionResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetProjectConstructionResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTimesheetEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23278,6 +24652,14 @@ func (r GetTimesheetEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTimesheetEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateTimesheetEntryResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23305,6 +24687,14 @@ func (r UpdateTimesheetEntryResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateTimesheetEntryResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type RepositionTodolistGroupResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23331,6 +24721,14 @@ func (r RepositionTodolistGroupResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r RepositionTodolistGroupResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTodolistOrGroupResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23357,6 +24755,14 @@ func (r GetTodolistOrGroupResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTodolistOrGroupResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateTodolistOrGroupResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23384,6 +24790,14 @@ func (r UpdateTodolistOrGroupResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateTodolistOrGroupResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListTodolistGroupsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23410,6 +24824,14 @@ func (r ListTodolistGroupsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListTodolistGroupsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateTodolistGroupResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23437,6 +24859,14 @@ func (r CreateTodolistGroupResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateTodolistGroupResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListTodosResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23463,6 +24893,14 @@ func (r ListTodosResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListTodosResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23490,6 +24928,14 @@ func (r CreateTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type TrashTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23515,6 +24961,14 @@ func (r TrashTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r TrashTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23541,6 +24995,14 @@ func (r GetTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ReplaceTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23568,6 +25030,14 @@ func (r ReplaceTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ReplaceTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UncompleteTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23593,6 +25063,14 @@ func (r UncompleteTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UncompleteTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CompleteTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23619,6 +25097,14 @@ func (r CompleteTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CompleteTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type RepositionTodoResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23645,6 +25131,14 @@ func (r RepositionTodoResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r RepositionTodoResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetTodosetResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23671,6 +25165,14 @@ func (r GetTodosetResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetTodosetResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetHillChartResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23697,6 +25199,14 @@ func (r GetHillChartResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetHillChartResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateHillChartSettingsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23724,6 +25234,14 @@ func (r UpdateHillChartSettingsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateHillChartSettingsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListTodolistsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23750,6 +25268,14 @@ func (r ListTodolistsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListTodolistsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateTodolistResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23777,6 +25303,14 @@ func (r CreateTodolistResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateTodolistResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetUploadResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23803,6 +25337,14 @@ func (r GetUploadResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetUploadResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateUploadResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23830,6 +25372,14 @@ func (r UpdateUploadResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateUploadResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListUploadVersionsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23856,6 +25406,14 @@ func (r ListUploadVersionsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListUploadVersionsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetVaultResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23882,6 +25440,14 @@ func (r GetVaultResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetVaultResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateVaultResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23909,6 +25475,14 @@ func (r UpdateVaultResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateVaultResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListDocumentsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23935,6 +25509,14 @@ func (r ListDocumentsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListDocumentsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateDocumentResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23962,6 +25544,14 @@ func (r CreateDocumentResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateDocumentResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListUploadsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -23988,6 +25578,14 @@ func (r ListUploadsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListUploadsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateUploadResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24015,6 +25613,14 @@ func (r CreateUploadResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateUploadResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type ListVaultsResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24041,6 +25647,14 @@ func (r ListVaultsResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r ListVaultsResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type CreateVaultResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24068,6 +25682,14 @@ func (r CreateVaultResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r CreateVaultResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type DeleteWebhookResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24093,6 +25715,14 @@ func (r DeleteWebhookResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r DeleteWebhookResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type GetWebhookResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24119,6 +25749,14 @@ func (r GetWebhookResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r GetWebhookResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 type UpdateWebhookResponse struct {
 	Body         []byte
 	HTTPResponse *http.Response
@@ -24147,6 +25785,14 @@ func (r UpdateWebhookResponse) StatusCode() int {
 	return 0
 }
 
+// ContentType is a convenience method to retrieve the Content-Type value from the HTTP response headers
+func (r UpdateWebhookResponse) ContentType() string {
+	if r.HTTPResponse != nil {
+		return r.HTTPResponse.Header.Get("Content-Type")
+	}
+	return ""
+}
+
 // GetAccountWithResponse request returning *GetAccountResponse
 func (c *ClientWithResponses) GetAccountWithResponse(ctx context.Context, accountId string, reqEditors ...RequestEditorFn) (*GetAccountResponse, error) {
 	rsp, err := c.GetAccount(ctx, accountId, reqEditors...)
diff --git a/openapi.json b/openapi.json
index 876bf8a56..9dc62c7f4 100644
--- a/openapi.json
+++ b/openapi.json
@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-05-01",
+    "version": "2026-07-17",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -18362,16 +18362,17 @@
         }
       },
       "put": {
-        "description": "Update an existing todo",
-        "operationId": "UpdateTodo",
+        "description": "Replace a todo with a new complete representation.\nThe request body is the todo's full writable state: any writable field\nomitted from the request is cleared server-side (empty/missing\nassignee_ids clears assignees, missing description clears it, and so\non). content is required — a request without it is rejected.\nTo set some fields while preserving the rest, use the SDK's merge-safe\nupdate or edit methods, which GET the current todo and PUT the full\nrepresentation back. Those read-modify-write helpers are not atomic:\na concurrent write between the GET and PUT is overwritten (last write\nwins for the whole representation; the window is one round-trip).",
+        "operationId": "ReplaceTodo",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateTodoRequestContent"
+                "$ref": "#/components/schemas/ReplaceTodoRequestContent"
               }
             }
-          }
+          },
+          "required": true
         },
         "parameters": [
           {
@@ -18397,11 +18398,11 @@
         ],
         "responses": {
           "200": {
-            "description": "UpdateTodo 200 response",
+            "description": "ReplaceTodo 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/UpdateTodoResponseContent"
+                  "$ref": "#/components/schemas/ReplaceTodoResponseContent"
                 }
               }
             }
@@ -18471,6 +18472,10 @@
             429,
             503
           ]
+        },
+        "x-basecamp-write-semantics": {
+          "mode": "replace",
+          "clearsOmitted": true
         }
       }
     },
@@ -25069,6 +25074,12 @@
           "purpose": {
             "type": "string"
           },
+          "start_date": {
+            "type": "string"
+          },
+          "end_date": {
+            "type": "string"
+          },
           "clients_enabled": {
             "type": "boolean"
           },
@@ -25685,6 +25696,57 @@
           "url"
         ]
       },
+      "ReplaceTodoRequestContent": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "assignee_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "completion_subscriber_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "notify": {
+            "type": "boolean",
+            "x-go-type-skip-optional-pointer": false
+          },
+          "due_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
+          "starts_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          }
+        },
+        "required": [
+          "content"
+        ]
+      },
+      "ReplaceTodoResponseContent": {
+        "$ref": "#/components/schemas/Todo"
+      },
       "RepositionCardStepRequestContent": {
         "type": "object",
         "properties": {
@@ -27454,54 +27516,6 @@
       "UpdateTimesheetEntryResponseContent": {
         "$ref": "#/components/schemas/TimesheetEntry"
       },
-      "UpdateTodoRequestContent": {
-        "type": "object",
-        "properties": {
-          "content": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "assignee_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "completion_subscriber_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "notify": {
-            "type": "boolean",
-            "x-go-type-skip-optional-pointer": false
-          },
-          "due_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          },
-          "starts_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          }
-        }
-      },
-      "UpdateTodoResponseContent": {
-        "$ref": "#/components/schemas/Todo"
-      },
       "UpdateTodolistOrGroupRequestContent": {
         "type": "object",
         "properties": {
diff --git a/ruby/lib/basecamp/generated/metadata.json b/ruby/lib/basecamp/generated/metadata.json
index 2c184cb70..fb46a0779 100644
--- a/ruby/lib/basecamp/generated/metadata.json
+++ b/ruby/lib/basecamp/generated/metadata.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-05-01T22:48:07Z",
+  "generated": "2026-07-22T02:19:46Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -2329,7 +2329,7 @@
         ]
       }
     },
-    "UpdateTodo": {
+    "ReplaceTodo": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
diff --git a/ruby/lib/basecamp/generated/types.rb b/ruby/lib/basecamp/generated/types.rb
index 266fba542..e0250f567 100644
--- a/ruby/lib/basecamp/generated/types.rb
+++ b/ruby/lib/basecamp/generated/types.rb
@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated from OpenAPI spec. Do not edit manually.
-# Generated: 2026-05-01T22:48:07Z
+# Generated: 2026-07-22T02:19:46Z
 
 require "json"
 require "time"
@@ -2433,7 +2433,7 @@ def to_json(*args)
     # Project
     class Project
       include TypeHelpers
-      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :purpose
+      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :end_date, :purpose, :start_date
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -2455,7 +2455,9 @@ def initialize(data = {})
         @clientside = parse_type(data["clientside"], "ClientSide")
         @description = data["description"]
         @dock = parse_array(data["dock"], "DockItem")
+        @end_date = data["end_date"]
         @purpose = data["purpose"]
+        @start_date = data["start_date"]
       end
 
       def to_h
@@ -2474,7 +2476,9 @@ def to_h
           "clientside" => @clientside,
           "description" => @description,
           "dock" => @dock,
+          "end_date" => @end_date,
           "purpose" => @purpose,
+          "start_date" => @start_date,
         }.compact
       end
 
diff --git a/typescript/src/generated/metadata.ts b/typescript/src/generated/metadata.ts
index 1988faffb..785317541 100644
--- a/typescript/src/generated/metadata.ts
+++ b/typescript/src/generated/metadata.ts
@@ -1,7 +1,43 @@
-{
+// Generated from OpenAPI x-basecamp-* extensions. Do not edit by hand.
+
+export interface RetryConfig {
+  maxAttempts: number;
+  baseDelayMs: number;
+  backoff: "exponential" | "linear" | "constant";
+  retryOn: number[];
+}
+
+export interface PaginationConfig {
+  style: "link" | "cursor" | "page";
+  pageParam?: string;
+  totalCountHeader?: string;
+  maxPageSize?: number;
+  key?: string;
+}
+
+export interface IdempotentConfig {
+  keySupported?: boolean;
+  keyHeader?: string;
+  natural?: boolean;
+}
+
+export interface OperationMetadata {
+  retry?: RetryConfig;
+  pagination?: PaginationConfig;
+  idempotent?: IdempotentConfig;
+}
+
+export interface MetadataOutput {
+  $schema: string;
+  version: string;
+  generated: string;
+  operations: Record<string, OperationMetadata>;
+}
+
+const metadata: MetadataOutput = {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-05-01T22:48:06.275Z",
+  "generated": "2026-07-22T02:19:44.980Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -2330,7 +2366,7 @@
         ]
       }
     },
-    "UpdateTodo": {
+    "ReplaceTodo": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -2650,4 +2686,7 @@
       }
     }
   }
-}
+};
+
+export default metadata;
+
diff --git a/typescript/src/generated/openapi-stripped.json b/typescript/src/generated/openapi-stripped.json
index 51c6e99b9..321696a30 100644
--- a/typescript/src/generated/openapi-stripped.json
+++ b/typescript/src/generated/openapi-stripped.json
@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-05-01",
+    "version": "2026-07-17",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -16291,16 +16291,17 @@
         }
       },
       "put": {
-        "description": "Update an existing todo",
-        "operationId": "UpdateTodo",
+        "description": "Replace a todo with a new complete representation.\nThe request body is the todo's full writable state: any writable field\nomitted from the request is cleared server-side (empty/missing\nassignee_ids clears assignees, missing description clears it, and so\non). content is required — a request without it is rejected.\nTo set some fields while preserving the rest, use the SDK's merge-safe\nupdate or edit methods, which GET the current todo and PUT the full\nrepresentation back. Those read-modify-write helpers are not atomic:\na concurrent write between the GET and PUT is overwritten (last write\nwins for the whole representation; the window is one round-trip).",
+        "operationId": "ReplaceTodo",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateTodoRequestContent"
+                "$ref": "#/components/schemas/ReplaceTodoRequestContent"
               }
             }
-          }
+          },
+          "required": true
         },
         "parameters": [
           {
@@ -16315,11 +16316,11 @@
         ],
         "responses": {
           "200": {
-            "description": "UpdateTodo 200 response",
+            "description": "ReplaceTodo 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/UpdateTodoResponseContent"
+                  "$ref": "#/components/schemas/ReplaceTodoResponseContent"
                 }
               }
             }
@@ -16389,6 +16390,10 @@
             429,
             503
           ]
+        },
+        "x-basecamp-write-semantics": {
+          "mode": "replace",
+          "clearsOmitted": true
         }
       }
     },
@@ -22745,6 +22750,12 @@
           "purpose": {
             "type": "string"
           },
+          "start_date": {
+            "type": "string"
+          },
+          "end_date": {
+            "type": "string"
+          },
           "clients_enabled": {
             "type": "boolean"
           },
@@ -23361,6 +23372,57 @@
           "url"
         ]
       },
+      "ReplaceTodoRequestContent": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "assignee_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "completion_subscriber_ids": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          "notify": {
+            "type": "boolean",
+            "x-go-type-skip-optional-pointer": false
+          },
+          "due_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          },
+          "starts_on": {
+            "type": "string",
+            "x-go-type": "types.Date",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            },
+            "x-go-type-skip-optional-pointer": true
+          }
+        },
+        "required": [
+          "content"
+        ]
+      },
+      "ReplaceTodoResponseContent": {
+        "$ref": "#/components/schemas/Todo"
+      },
       "RepositionCardStepRequestContent": {
         "type": "object",
         "properties": {
@@ -25130,54 +25192,6 @@
       "UpdateTimesheetEntryResponseContent": {
         "$ref": "#/components/schemas/TimesheetEntry"
       },
-      "UpdateTodoRequestContent": {
-        "type": "object",
-        "properties": {
-          "content": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "assignee_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "completion_subscriber_ids": {
-            "type": "array",
-            "items": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          "notify": {
-            "type": "boolean",
-            "x-go-type-skip-optional-pointer": false
-          },
-          "due_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          },
-          "starts_on": {
-            "type": "string",
-            "x-go-type": "types.Date",
-            "x-go-type-import": {
-              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
-            },
-            "x-go-type-skip-optional-pointer": true
-          }
-        }
-      },
-      "UpdateTodoResponseContent": {
-        "$ref": "#/components/schemas/Todo"
-      },
       "UpdateTodolistOrGroupRequestContent": {
         "type": "object",
         "properties": {

From 12c0f0a18f0690fdbbaadab338cbb9df0b0b05df Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@hey.com>
Date: Tue, 21 Jul 2026 19:41:44 -0700
Subject: [PATCH 14/16] typescript: bump fast-uri, brace-expansion, js-yaml
 overrides for fresh advisories

Three high-severity advisories published since main's last green security
run (2026-07-20) trip npm Audit on the TypeScript SDK:

- fast-uri GHSA-4c8g-83qw-93j6 (host confusion via failed IDN
  canonicalization): override >=3.1.2 -> >=3.1.3, resolves 4.1.1
- brace-expansion GHSA-3jxr-9vmj-r5cp (DoS via exponential expansion):
  override >=5.0.6 -> >=5.0.7
- js-yaml GHSA-52cp-r559-cp3m (quadratic CPU via merge-key chains):
  new override ^4.3.0, pinned to the 4.x patched line since js-yaml 5
  is a major bump for openapi-typescript's transitive use

npm audit clean; ts-generate + ts-generate-services + ts-check verified
green under the new resolutions.
---
 typescript/package-lock.json | 82 +++++++++++++-----------------------
 typescript/package.json      |  5 ++-
 2 files changed, 32 insertions(+), 55 deletions(-)

diff --git a/typescript/package-lock.json b/typescript/package-lock.json
index 747ec5516..dbc401d66 100644
--- a/typescript/package-lock.json
+++ b/typescript/package-lock.json
@@ -900,9 +900,6 @@
         "arm64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -920,9 +917,6 @@
         "arm64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -940,9 +934,6 @@
         "ppc64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -960,9 +951,6 @@
         "riscv64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -980,9 +968,6 @@
         "riscv64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1000,9 +985,6 @@
         "s390x"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1020,9 +1002,6 @@
         "x64"
       ],
       "dev": true,
-      "libc": [
-        "glibc"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1040,9 +1019,6 @@
         "x64"
       ],
       "dev": true,
-      "libc": [
-        "musl"
-      ],
       "license": "MIT",
       "optional": true,
       "os": [
@@ -1166,6 +1142,29 @@
         "npm": ">=9.5.0"
       }
     },
+    "node_modules/@redocly/openapi-core/node_modules/js-yaml": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.0.tgz",
+      "integrity": "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/puzrin"
+        },
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/nodeca"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
     "node_modules/@rolldown/binding-android-arm64": {
       "version": "1.1.5",
       "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.1.5.tgz",
@@ -1737,9 +1736,9 @@
       }
     },
     "node_modules/brace-expansion": {
-      "version": "5.0.6",
-      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz",
-      "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==",
+      "version": "5.0.7",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz",
+      "integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -1996,9 +1995,9 @@
       }
     },
     "node_modules/fast-uri": {
-      "version": "3.1.2",
-      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.2.tgz",
-      "integrity": "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==",
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-4.1.1.tgz",
+      "integrity": "sha512-YPOs1zD5TG2+EZt+r88LwF6mclA7TPkpwMP7ZN3TO2HiHS8TXvq7QA/17iJsV9dubcLo/f8eEYqMBruyQV21hQ==",
       "dev": true,
       "funding": [
         {
@@ -2216,29 +2215,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/js-yaml": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.2.0.tgz",
-      "integrity": "sha512-ePWsvanv0DWuDRsW8dnt+R4jQ31SCRCQ7hhNcPXZPsoBZiemuZNYGf7adZdqX2D86j6rvKp3RpCxVTSb8WQlOw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/puzrin"
-        },
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/nodeca"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "argparse": "^2.0.1"
-      },
-      "bin": {
-        "js-yaml": "bin/js-yaml.js"
-      }
-    },
     "node_modules/json-schema-traverse": {
       "version": "1.0.0",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
diff --git a/typescript/package.json b/typescript/package.json
index 38227c2c5..67052cb60 100644
--- a/typescript/package.json
+++ b/typescript/package.json
@@ -67,7 +67,8 @@
   },
   "overrides": {
     "minimatch": ">=10.2.1",
-    "brace-expansion": ">=5.0.6",
-    "fast-uri": ">=3.1.2"
+    "brace-expansion": ">=5.0.7",
+    "fast-uri": ">=3.1.3",
+    "js-yaml": "^4.3.0"
   }
 }

From 7e32f443b1058cda8d8df64ed4465b4f0946d9f2 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@hey.com>
Date: Tue, 21 Jul 2026 19:54:09 -0700
Subject: [PATCH 15/16] make, scripts: address review threads on sync-status +
 parity lint
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- sync-status: pass BC3_REPO through to report-bc3-drift.sh in both the
  primary and compatibility invocations — make variables aren't exported
  to recipe environments, so 'make sync-status BC3_REPO=org/fork' was
  silently querying the default repo
- parity lint: use [[:space:]] instead of the non-POSIX \s escape in the
  allowlist filter; accept {projectId} alongside {bucketId} in the
  bucket-path pattern (and strip logic) for forward-compat with the
  documented Smithy path convention; use # as the sed delimiter to keep
  the ERE alternation unambiguous across GNU/BSD sed

Candidate count and lint verdict unchanged (verified against openapi.json
before/after).
---
 Makefile                            |  4 ++--
 scripts/check-bucket-flat-parity.sh | 12 +++++++-----
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/Makefile b/Makefile
index 837d745c2..eab8c9499 100644
--- a/Makefile
+++ b/Makefile
@@ -104,13 +104,13 @@ BC3_REPO ?= basecamp/bc3
 sync-status:
 	@command -v gh > /dev/null 2>&1 || { echo "ERROR: gh CLI not found. Install: https://cli.github.com"; exit 1; }
 	@gh auth status > /dev/null 2>&1 || { echo "ERROR: gh not authenticated. Run: gh auth login"; exit 1; }
-	@./scripts/report-bc3-drift.sh \
+	@BC3_REPO="$(BC3_REPO)" ./scripts/report-bc3-drift.sh \
 		"$$(jq -r '.bc3.revision // empty' spec/api-provenance.json)" \
 		"$$(jq -r '.bc3.branch // "master"' spec/api-provenance.json)" \
 		"primary"
 	@for COMPAT_KEY in $$(jq -r '.compatibility // {} | keys[]' spec/api-provenance.json); do \
 		echo ""; \
-		./scripts/report-bc3-drift.sh \
+		BC3_REPO="$(BC3_REPO)" ./scripts/report-bc3-drift.sh \
 			"$$(jq -r --arg k "$$COMPAT_KEY" '.compatibility[$$k].revision // empty' spec/api-provenance.json)" \
 			"$$(jq -r --arg k "$$COMPAT_KEY" '.compatibility[$$k].branch // "master"' spec/api-provenance.json)" \
 			"compat"; \
diff --git a/scripts/check-bucket-flat-parity.sh b/scripts/check-bucket-flat-parity.sh
index b2e44e102..c5e6f8203 100755
--- a/scripts/check-bucket-flat-parity.sh
+++ b/scripts/check-bucket-flat-parity.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # Bucket↔flat parity lint.
 #
-# For every GET /{accountId}/buckets/{bucketId}/<resource>(/{filter})?.json operation
+# For every GET /{accountId}/buckets/{bucketId or projectId}/<resource>(/{filter})?.json operation
 # whose response is a list, check that a flat counterpart at
 # /{accountId}/<resource>(/{filter})?.json exists. If not, the path must be
 # entered in spec/bucket-scoped-allowlist.txt with a justification.
@@ -34,7 +34,7 @@ fi
 # Build the set of allowlisted patterns.
 ALLOWED=""
 if [ -f "$ALLOWLIST" ]; then
-  ALLOWED=$(grep -Ev '^\s*(#|$)' "$ALLOWLIST" || true)
+  ALLOWED=$(grep -Ev '^[[:space:]]*(#|$)' "$ALLOWLIST" || true)
 fi
 
 # Find candidate bucket-scoped GET list operations and their expected flat paths.
@@ -45,7 +45,7 @@ CANDIDATES=$(jq -r '
   . as $s
   | $s.paths
   | to_entries[]
-  | select(.key | test("^/\\{accountId\\}/buckets/\\{bucketId\\}/[^/]+(/\\{[^}]+\\})?\\.json$"))
+  | select(.key | test("^/\\{accountId\\}/buckets/\\{(bucketId|projectId)\\}/[^/]+(/\\{[^}]+\\})?\\.json$"))
   | select(.value.get != null)
   | . as $entry
   | (
@@ -71,8 +71,10 @@ while IFS= read -r BUCKET_PATH; do
   [ -z "$BUCKET_PATH" ] && continue
   COUNT=$((COUNT + 1))
 
-  # Compute the flat path: strip /buckets/{bucketId} from the bucket path.
-  FLAT_PATH=$(echo "$BUCKET_PATH" | sed 's|/buckets/{bucketId}||')
+  # Compute the flat path: strip the /buckets/{<label>} segment. The spec uses
+  # {bucketId} today; {projectId} is accepted for forward-compat with the
+  # documented Smithy path convention.
+  FLAT_PATH=$(echo "$BUCKET_PATH" | sed -E 's#/buckets/\{(bucketId|projectId)\}##')
 
   # Already covered by a flat sibling?
   if jq -e --arg p "$FLAT_PATH" '.paths[$p].get != null' "$SPEC" >/dev/null 2>&1; then

From 66f9dfa9261c6df13f8985fdf9dc865d07af90f0 Mon Sep 17 00:00:00 2001
From: Jeremy Daer <jeremy@hey.com>
Date: Tue, 21 Jul 2026 20:02:00 -0700
Subject: [PATCH 16/16] make, scripts: second review round on sync-status +
 parity lint
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- parity lint: accept literal filter segments (e.g. /todos/completed.json)
  in addition to path-parameter variants — the header always promised
  (/<filter>)? coverage but the regex only matched /{param}. Candidate
  set unchanged today (verified: single-resource GETs carry no .json
  suffix in this spec, so the anchor keeps the match tight).
- sync-status: guard on jq alongside the existing gh guards.
---
 Makefile                            | 1 +
 scripts/check-bucket-flat-parity.sh | 5 +++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index eab8c9499..704b24422 100644
--- a/Makefile
+++ b/Makefile
@@ -103,6 +103,7 @@ BC3_REPO ?= basecamp/bc3
 
 sync-status:
 	@command -v gh > /dev/null 2>&1 || { echo "ERROR: gh CLI not found. Install: https://cli.github.com"; exit 1; }
+	@command -v jq > /dev/null 2>&1 || { echo "ERROR: jq not found. Install: https://jqlang.github.io/jq/"; exit 1; }
 	@gh auth status > /dev/null 2>&1 || { echo "ERROR: gh not authenticated. Run: gh auth login"; exit 1; }
 	@BC3_REPO="$(BC3_REPO)" ./scripts/report-bc3-drift.sh \
 		"$$(jq -r '.bc3.revision // empty' spec/api-provenance.json)" \
diff --git a/scripts/check-bucket-flat-parity.sh b/scripts/check-bucket-flat-parity.sh
index c5e6f8203..4634f8fdb 100755
--- a/scripts/check-bucket-flat-parity.sh
+++ b/scripts/check-bucket-flat-parity.sh
@@ -1,7 +1,8 @@
 #!/usr/bin/env bash
 # Bucket↔flat parity lint.
 #
-# For every GET /{accountId}/buckets/{bucketId or projectId}/<resource>(/{filter})?.json operation
+# For every GET /{accountId}/buckets/{bucketId or projectId}/<resource>(/<filter>)?.json operation
+# (<filter> may be a literal segment like "completed" or a path parameter)
 # whose response is a list, check that a flat counterpart at
 # /{accountId}/<resource>(/{filter})?.json exists. If not, the path must be
 # entered in spec/bucket-scoped-allowlist.txt with a justification.
@@ -45,7 +46,7 @@ CANDIDATES=$(jq -r '
   . as $s
   | $s.paths
   | to_entries[]
-  | select(.key | test("^/\\{accountId\\}/buckets/\\{(bucketId|projectId)\\}/[^/]+(/\\{[^}]+\\})?\\.json$"))
+  | select(.key | test("^/\\{accountId\\}/buckets/\\{(bucketId|projectId)\\}/[^/]+(/[^/]+)?\\.json$"))
   | select(.value.get != null)
   | . as $entry
   | (