@37signals/basecamp 0.14.0 → 0.16.0

package/src/generated/openapi-stripped.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-08-05",
+    "version": "2026-09-02",
     "description": "Basecamp API",
     "contact": {
       "name": "Basecamp",
@@ -11204,6 +11204,77 @@
         }
       }
     },
+    "/my/recent_projects.json": {
+      "get": {
+        "description": "List the projects the current user has most recently visited, most recent visit first.\nReads the per-user visit log — capped at the 50 most recent visits, keeping\nonly active projects the user can still access — not the home grid's\npinned-exclusion and padding. This endpoint is not paginated. Each entry is\nthe standard project projection plus the current user's bookmarked flag. A\nvisit is recorded when the user opens a project in Basecamp, when they\ncreate one, and by RecordProjectVisit.",
+        "operationId": "ListRecentProjects",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "ListRecentProjects 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListRecentProjectsResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Projects"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
     "/my/unreads.json": {
       "put": {
         "description": "Mark specified items as read",
@@ -13012,6 +13083,93 @@
         }
       }
     },
+    "/projects/{projectId}/recent_visit.json": {
+      "post": {
+        "description": "Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content).\nIdempotent: re-recording a visit refreshes the same entry. Visits to\narchived or trashed projects are accepted but not recorded, and an\ninaccessible project answers 404.",
+        "operationId": "RecordProjectVisit",
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "RecordProjectVisit 204 response"
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Projects"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
     "/projects/{projectId}/status/active.json": {
       "put": {
         "description": "Restore a project to active status from trash as well as from the archive (returns 204 No Content).\nThis is the inverse of both ArchiveProject and TrashProject. Restoring counts against\nthe account's project limit, so it answers 507 when that limit is already reached.",
@@ -15321,20 +15479,10 @@
         }
       }
     },
-    "/recordings/{recordingId}/client_visibility.json": {
-      "put": {
-        "description": "Set client visibility for a recording",
-        "operationId": "SetClientVisibility",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SetClientVisibilityRequestContent"
-              }
-            }
-          },
-          "required": true
-        },
+    "/recordings/{recordingId}/bubble_up.json": {
+      "delete": {
+        "description": "Remove the current user's bubble-up from a recording (returns 204 No Content).\nIdempotent: popping an absent bubble-up also returns 204.",
+        "operationId": "DeleteBubbleUp",
         "parameters": [
           {
             "name": "recordingId",
@@ -15347,15 +15495,8 @@
           }
         ],
         "responses": {
-          "200": {
-            "description": "SetClientVisibility 200 response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SetClientVisibilityResponseContent"
-                }
-              }
-            }
+          "204": {
+            "description": "DeleteBubbleUp 204 response"
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -15387,12 +15528,12 @@
               }
             }
           },
-          "422": {
-            "description": "ValidationError 422 response",
+          "429": {
+            "description": "RateLimitError 429 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
                 }
               }
             }
@@ -15409,7 +15550,7 @@
           }
         },
         "tags": [
-          "ClientFeatures"
+          "BubbleUps"
         ],
         "x-basecamp-idempotent": {
           "natural": true
@@ -15423,12 +15564,19 @@
             503
           ]
         }
-      }
-    },
-    "/recordings/{recordingId}/comments.json": {
-      "get": {
-        "description": "List comments on a recording\n\n**Pagination**: Uses Link header (RFC5988). Follow the `next` rel URL\nto fetch additional pages. X-Total-Count header provides total count.",
-        "operationId": "ListComments",
+      },
+      "post": {
+        "description": "Bubble up a recording for the current user, resurfacing it in the current\nuser's readings (the BC5 successor to \"save\"). Returns 204 No Content with\nno body.\n\nThe `at` field controls timing. Send `\"now\"` to bubble up immediately, or a\nscheduling keyword (`\"today\"`, `\"tomorrow\"`, `\"weekend\"`, `\"next_week\"`) or\nan ISO8601 date (e.g. `\"2026-09-10\"`) to schedule it to resurface later.\nNOTE: bc3 currently requires `at` — omitting it raises on the server\n(`Date.iso8601(nil)`), so send `\"now\"` for the immediate case. The field is\nmodeled optional (not `@required`) so a future bc3 default (`params[:at] ||=\n\"now\"`) makes omission mean \"now\" without an SDK change.\n\nIdempotent: bubbling up an already-bubbled recording is set-membership and\nstill returns 204.",
+        "operationId": "CreateBubbleUp",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateBubbleUpRequestContent"
+              }
+            }
+          }
+        },
         "parameters": [
           {
             "name": "recordingId",
@@ -15438,28 +15586,11 @@
               "format": "int64"
             },
             "required": true
-          },
-          {
-            "name": "page",
-            "in": "query",
-            "description": "Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.",
-            "schema": {
-              "type": "integer",
-              "description": "Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.",
-              "format": "int32"
-            }
           }
         ],
         "responses": {
-          "200": {
-            "description": "ListComments 200 response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ListCommentsResponseContent"
-                }
-              }
-            }
+          "204": {
+            "description": "CreateBubbleUp 204 response"
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -15481,6 +15612,16 @@
               }
             }
           },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
           "429": {
             "description": "RateLimitError 429 response",
             "content": {
@@ -15503,12 +15644,10 @@
           }
         },
         "tags": [
-          "Messages"
+          "BubbleUps"
         ],
-        "x-basecamp-pagination": {
-          "style": "link",
-          "totalCountHeader": "X-Total-Count",
-          "maxPageSize": 50
+        "x-basecamp-idempotent": {
+          "natural": true
         },
         "x-basecamp-retry": {
           "maxAttempts": 3,
@@ -15519,15 +15658,17 @@
             503
           ]
         }
-      },
-      "post": {
-        "description": "Create a new comment on a recording",
-        "operationId": "CreateComment",
+      }
+    },
+    "/recordings/{recordingId}/client_visibility.json": {
+      "put": {
+        "description": "Set client visibility for a recording",
+        "operationId": "SetClientVisibility",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/CreateCommentRequestContent"
+                "$ref": "#/components/schemas/SetClientVisibilityRequestContent"
               }
             }
           },
@@ -15545,12 +15686,12 @@
           }
         ],
         "responses": {
-          "201": {
-            "description": "CreateComment 201 response",
+          "200": {
+            "description": "SetClientVisibility 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CreateCommentResponseContent"
+                  "$ref": "#/components/schemas/SetClientVisibilityResponseContent"
                 }
               }
             }
@@ -15575,8 +15716,206 @@
               }
             }
           },
-          "422": {
-            "description": "ValidationError 422 response",
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "ValidationError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "ClientFeatures"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/recordings/{recordingId}/comments.json": {
+      "get": {
+        "description": "List comments on a recording\n\n**Pagination**: Uses Link header (RFC5988). Follow the `next` rel URL\nto fetch additional pages. X-Total-Count header provides total count.",
+        "operationId": "ListComments",
+        "parameters": [
+          {
+            "name": "recordingId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          },
+          {
+            "name": "page",
+            "in": "query",
+            "description": "Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.",
+            "schema": {
+              "type": "integer",
+              "description": "Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.",
+              "format": "int32"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "ListComments 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListCommentsResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Messages"
+        ],
+        "x-basecamp-pagination": {
+          "style": "link",
+          "totalCountHeader": "X-Total-Count",
+          "maxPageSize": 50
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      },
+      "post": {
+        "description": "Create a new comment on a recording",
+        "operationId": "CreateComment",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateCommentRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [
+          {
+            "name": "recordingId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "CreateComment 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateCommentResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "ValidationError 422 response",
             "content": {
               "application/json": {
                 "schema": {
@@ -15929,10 +16268,10 @@
         }
       }
     },
-    "/recordings/{recordingId}/status/active.json": {
-      "put": {
-        "description": "Unarchive a recording (restore to active status)",
-        "operationId": "UnarchiveRecording",
+    "/recordings/{recordingId}/spotlight.json": {
+      "delete": {
+        "description": "Remove a recording from the spotlight area.\nIdempotent: removing an absent spotlight also returns 204.",
+        "operationId": "UnspotlightRecording",
         "parameters": [
           {
             "name": "recordingId",
@@ -15946,7 +16285,7 @@
         ],
         "responses": {
           "204": {
-            "description": "UnarchiveRecording 204 response"
+            "description": "UnspotlightRecording 204 response"
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -15978,12 +16317,12 @@
               }
             }
           },
-          "422": {
-            "description": "ValidationError 422 response",
+          "429": {
+            "description": "RateLimitError 429 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
                 }
               }
             }
@@ -16014,12 +16353,10 @@
             503
           ]
         }
-      }
-    },
-    "/recordings/{recordingId}/status/archived.json": {
-      "put": {
-        "description": "Archive a recording",
-        "operationId": "ArchiveRecording",
+      },
+      "post": {
+        "description": "Put a recording's card in the spotlight area on its project or template home page.\nIdempotent: spotlighting an already-spotlighted recording still returns 201.",
+        "operationId": "SpotlightRecording",
         "parameters": [
           {
             "name": "recordingId",
@@ -16032,8 +16369,15 @@
           }
         ],
         "responses": {
-          "204": {
-            "description": "ArchiveRecording 204 response"
+          "201": {
+            "description": "SpotlightRecording 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SpotlightRecordingResponseContent"
+                }
+              }
+            }
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -16075,6 +16419,16 @@
               }
             }
           },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
           "500": {
             "description": "InternalServerError 500 response",
             "content": {
@@ -16103,10 +16457,10 @@
         }
       }
     },
-    "/recordings/{recordingId}/status/trashed.json": {
+    "/recordings/{recordingId}/status/active.json": {
       "put": {
-        "description": "Trash a recording",
-        "operationId": "TrashRecording",
+        "description": "Unarchive a recording (restore to active status)",
+        "operationId": "UnarchiveRecording",
         "parameters": [
           {
             "name": "recordingId",
@@ -16115,19 +16469,12 @@
               "type": "integer",
               "format": "int64"
             },
-            "required": true,
-            "examples": {
-              "TrashRecording_example1": {
-                "summary": "Trash any recording type",
-                "description": "Works on comments, messages, documents, cards - any recording",
-                "value": 555666
-              }
-            }
+            "required": true
           }
         ],
         "responses": {
           "204": {
-            "description": "TrashRecording 204 response"
+            "description": "UnarchiveRecording 204 response"
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -16197,8 +16544,189 @@
         }
       }
     },
-    "/recordings/{recordingId}/subscription.json": {
-      "delete": {
+    "/recordings/{recordingId}/status/archived.json": {
+      "put": {
+        "description": "Archive a recording",
+        "operationId": "ArchiveRecording",
+        "parameters": [
+          {
+            "name": "recordingId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "ArchiveRecording 204 response"
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "ValidationError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Automation"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/recordings/{recordingId}/status/trashed.json": {
+      "put": {
+        "description": "Trash a recording",
+        "operationId": "TrashRecording",
+        "parameters": [
+          {
+            "name": "recordingId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true,
+            "examples": {
+              "TrashRecording_example1": {
+                "summary": "Trash any recording type",
+                "description": "Works on comments, messages, documents, cards - any recording",
+                "value": 555666
+              }
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "TrashRecording 204 response"
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "ValidationError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidationErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Automation"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/recordings/{recordingId}/subscription.json": {
+      "delete": {
         "description": "Unsubscribe the current user from a recording",
         "operationId": "Unsubscribe",
         "parameters": [
@@ -19070,7 +19598,281 @@
           "Folders"
         ],
         "x-basecamp-retry": {
-          "maxAttempts": 3,
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      },
+      "put": {
+        "description": "Rename a folder.\n\n`name` is the only writable attribute; a folder's projects, ordering, and\nimage are managed elsewhere and an image parameter sent here is ignored.",
+        "operationId": "UpdateFolder",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateFolderRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [
+          {
+            "name": "folderId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "UpdateFolder 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpdateFolderResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "FieldValidationError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FieldValidationErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Folders"
+        ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/template_library.json": {
+      "get": {
+        "description": "Get the account's to-do list template library",
+        "operationId": "GetTemplateLibrary",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "GetTemplateLibrary 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetTemplateLibraryResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Automation"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/template_library/copies.json": {
+      "post": {
+        "description": "Start copying a to-do list template into a project",
+        "operationId": "CreateTemplateLibraryCopy",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateTemplateLibraryCopyRequestContent"
+              }
+            }
+          },
+          "required": true
+        },
+        "parameters": [],
+        "responses": {
+          "201": {
+            "description": "CreateTemplateLibraryCopy 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateTemplateLibraryCopyResponseContent"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "UnauthorizedError 401 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UnauthorizedErrorResponseContent"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "ForbiddenError 403 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ForbiddenErrorResponseContent"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "NotFoundError 404 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "PeopleConfirmationRequiredError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PeopleConfirmationRequiredErrorResponseContent"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "RateLimitError 429 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "InternalServerError 500 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/InternalServerErrorResponseContent"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "Automation"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 2,
           "baseDelayMs": 1000,
           "backoff": "exponential",
           "retryOn": [
@@ -19078,23 +19880,15 @@
             503
           ]
         }
-      },
-      "put": {
-        "description": "Rename a folder.\n\n`name` is the only writable attribute; a folder's projects, ordering, and\nimage are managed elsewhere and an image parameter sent here is ignored.",
-        "operationId": "UpdateFolder",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/UpdateFolderRequestContent"
-              }
-            }
-          },
-          "required": true
-        },
+      }
+    },
+    "/template_library/copies/{copyId}": {
+      "get": {
+        "description": "Get the current status of a to-do list template copy",
+        "operationId": "GetTemplateLibraryCopy",
         "parameters": [
           {
-            "name": "folderId",
+            "name": "copyId",
             "in": "path",
             "schema": {
               "type": "integer",
@@ -19105,11 +19899,11 @@
         ],
         "responses": {
           "200": {
-            "description": "UpdateFolder 200 response",
+            "description": "GetTemplateLibraryCopy 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/UpdateFolderResponseContent"
+                  "$ref": "#/components/schemas/GetTemplateLibraryCopyResponseContent"
                 }
               }
             }
@@ -19144,12 +19938,12 @@
               }
             }
           },
-          "422": {
-            "description": "FieldValidationError 422 response",
+          "429": {
+            "description": "RateLimitError 429 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/FieldValidationErrorResponseContent"
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
                 }
               }
             }
@@ -19166,11 +19960,8 @@
           }
         },
         "tags": [
-          "Folders"
+          "Automation"
         ],
-        "x-basecamp-idempotent": {
-          "natural": true
-        },
         "x-basecamp-retry": {
           "maxAttempts": 3,
           "baseDelayMs": 1000,
@@ -24904,7 +25695,8 @@
             "type": "string"
           },
           "command_url": {
-            "type": "string"
+            "type": "string",
+            "description": "Only present when the requester is an account administrator; possession of this URL is enough to command the bot."
           },
           "url": {
             "type": "string"
@@ -24913,7 +25705,8 @@
             "type": "string"
           },
           "lines_url": {
-            "type": "string"
+            "type": "string",
+            "description": "Only present when the requester is an account administrator; possession of this URL is enough to post lines as the bot."
           }
         },
         "required": [
@@ -25551,6 +26344,15 @@
       "CreateBookmarkResponseContent": {
         "$ref": "#/components/schemas/Bookmark"
       },
+      "CreateBubbleUpRequestContent": {
+        "type": "object",
+        "properties": {
+          "at": {
+            "type": "string",
+            "description": "Timing for the bubble-up. `\"now\"` bubbles up immediately; a scheduling\nkeyword (`\"today\"`, `\"tomorrow\"`, `\"weekend\"`, `\"next_week\"`) or an ISO8601\ndate (e.g. `\"2026-09-10\"`) schedules it to resurface later. bc3 requires a\nvalue — omitting `at` errors server-side (`Date.iso8601(nil)`) — so send\n`\"now\"` for the immediate case."
+          }
+        }
+      },
       "CreateCampfireLineRequestContent": {
         "type": "object",
         "properties": {
@@ -26069,6 +26871,30 @@
       "CreateScheduleEntryResponseContent": {
         "$ref": "#/components/schemas/ScheduleEntry"
       },
+      "CreateTemplateLibraryCopyRequestContent": {
+        "type": "object",
+        "properties": {
+          "template_recording_id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "destination_parent_id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "adding_people_confirmed": {
+            "type": "boolean",
+            "description": "Confirm granting destination-project access to people referenced by the template."
+          }
+        },
+        "required": [
+          "destination_parent_id",
+          "template_recording_id"
+        ]
+      },
+      "CreateTemplateLibraryCopyResponseContent": {
+        "$ref": "#/components/schemas/TemplateLibraryCopy"
+      },
       "CreateTemplateRequestContent": {
         "type": "object",
         "properties": {
@@ -27886,10 +28712,13 @@
             "type": "array",
             "items": {
               "$ref": "#/components/schemas/TimelineEvent"
-            },
-            "x-go-type-skip-optional-pointer": true
+            }
           }
-        }
+        },
+        "required": [
+          "events",
+          "person"
+        ]
       },
       "GetPersonResponseContent": {
         "$ref": "#/components/schemas/Person"
@@ -27951,6 +28780,12 @@
       "GetSubscriptionResponseContent": {
         "$ref": "#/components/schemas/Subscription"
       },
+      "GetTemplateLibraryCopyResponseContent": {
+        "$ref": "#/components/schemas/TemplateLibraryCopy"
+      },
+      "GetTemplateLibraryResponseContent": {
+        "$ref": "#/components/schemas/TemplateLibrary"
+      },
       "GetTemplateResponseContent": {
         "$ref": "#/components/schemas/Template"
       },
@@ -28497,6 +29332,12 @@
           "$ref": "#/components/schemas/Question"
         }
       },
+      "ListRecentProjectsResponseContent": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/Project"
+        }
+      },
       "ListRecordingBoostsResponseContent": {
         "type": "array",
         "items": {
@@ -28911,6 +29752,7 @@
       },
       "MyAssignmentAssignee": {
         "type": "object",
+        "description": "A person as bc3's `people/_person_minimal.json.jbuilder` renders them —\nthe same three-key partial behind UpcomingSchedulePerson and\nOutOfOfficePerson. All three keys are emitted unconditionally, so all\nthree are required.",
         "properties": {
           "id": {
             "type": "integer",
@@ -28926,7 +29768,9 @@
           }
         },
         "required": [
-          "id"
+          "avatar_url",
+          "id",
+          "name"
         ]
       },
       "MyAssignmentBucket": {
@@ -29219,6 +30063,7 @@
       },
       "OutOfOfficePerson": {
         "type": "object",
+        "description": "A person as bc3's `people/_person_minimal.json.jbuilder` renders them —\nthe same three-key partial behind UpcomingSchedulePerson and\nMyAssignmentAssignee. All three keys are emitted unconditionally, so all\nthree are required.",
         "properties": {
           "id": {
             "type": "integer",
@@ -29234,7 +30079,9 @@
           }
         },
         "required": [
-          "id"
+          "avatar_url",
+          "id",
+          "name"
         ]
       },
       "PauseQuestionResponseContent": {
@@ -29245,6 +30092,25 @@
           }
         }
       },
+      "PeopleConfirmationRequiredErrorResponseContent": {
+        "type": "object",
+        "description": "The copy requires confirmation before granting destination-project access\nto people referenced by the template.",
+        "properties": {
+          "error": {
+            "type": "string"
+          },
+          "people": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TemplateLibraryConfirmationPerson"
+            }
+          }
+        },
+        "required": [
+          "error",
+          "people"
+        ]
+      },
       "Person": {
         "type": "object",
         "properties": {
@@ -29519,6 +30385,10 @@
           "bookmark_url": {
             "type": "string"
           },
+          "star_url": {
+            "type": "string",
+            "description": "Bucket stars collection for this project (`/buckets/{id}/stars.json`)."
+          },
           "url": {
             "type": "string"
           },
@@ -29533,7 +30403,12 @@
             "x-go-type-skip-optional-pointer": true
           },
           "bookmarked": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "True when the project is pinned on the current user's home page at all,\nwhether starred or filed into a stack."
+          },
+          "starred": {
+            "type": "boolean",
+            "description": "True only when the project carries a star on the current user's home page."
           },
           "client_company": {
             "$ref": "#/components/schemas/ClientCompany"
@@ -30795,9 +31670,11 @@
       },
       "SearchResult": {
         "type": "object",
+        "description": "One hit from account-wide search — a polymorphic projection over every\nsearchable recording type.\n\nMost result types render the common recording envelope\n(`recordings/_recording.json.jbuilder`) plus their own recordable partial,\nbut `api_search_result_template_path` special-cases four branches — chat\nlines, kanban (card table) lists, file attachments and gauge needles — and\nthe file-attachment branch writes its own projection from scratch instead\nof the envelope. Members are therefore optional unless every branch emits\nthem; the doc comments name the branches that carry each optional member.",
         "properties": {
           "id": {
             "type": "integer",
+            "description": "The recording id. Optional only because the file-attachment branch\n(`searches/_attachment.json.jbuilder`) skips the recording envelope and\nemits none of the top-level id/title/type/url/app_url keys; every other\nbranch emits all five.",
             "format": "int64"
           },
           "status": {
@@ -30810,99 +31687,308 @@
             "type": "string",
             "x-go-type": "time.Time",
             "x-go-type-import": {
-              "path": "time"
+              "path": "time"
+            }
+          },
+          "updated_at": {
+            "type": "string",
+            "x-go-type": "time.Time",
+            "x-go-type-import": {
+              "path": "time"
+            }
+          },
+          "title": {
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
+          },
+          "inherits_status": {
+            "type": "boolean"
+          },
+          "type": {
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch. A file-attachment hit is therefore recognizable by the absence\nof this key (its file keys, `filename` through `app_download_url`, are\nthe positive signal)."
+          },
+          "url": {
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
+          },
+          "app_url": {
+            "type": "string",
+            "description": "See `id` — omitted by the file-attachment branch, emitted by every other\nbranch."
+          },
+          "bookmark_url": {
+            "type": "string"
+          },
+          "subscription_url": {
+            "type": "string",
+            "description": "Subscription URL, emitted by the common recording envelope for any\nsubscribable result — kanban lists and gauge needles among the special\nbranches, plus subscribable generic-branch types (messages, todos, …)."
+          },
+          "bubble_up_url": {
+            "type": "string",
+            "description": "URL of the Bubble Up record for this recording (BC5 addition). Optional\nhere because this is a polymorphic projection:\n`recordings/_recording.json.jbuilder` emits the key only when the caller\npasses `local_assigns[:bubbleupable]`, and `todolists/_todolist` is the\nonly partial that does. So a Todolist-shaped instance carries it and the\nother recording types do not."
+          },
+          "parent": {
+            "$ref": "#/components/schemas/RecordingParent"
+          },
+          "bucket": {
+            "$ref": "#/components/schemas/RecordingBucket"
+          },
+          "creator": {
+            "$ref": "#/components/schemas/Person"
+          },
+          "content": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Always present, always null. `api/searches/show.json.jbuilder` renders the\nrecording's own partial and then unconditionally overwrites `content` with\n`nil` to strip the large HTML body out of the search payload. The key is\ntherefore guaranteed present on every result — required — and its value is\nguaranteed null. Read `plain_text_content` instead.",
+            "x-go-type": "string"
+          },
+          "description": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Always present, always null — the description-attribute counterpart to\n`content`. Read `plain_text_description` instead.",
+            "x-go-type": "string"
+          },
+          "plain_text_content": {
+            "type": "string",
+            "description": "A highlighted, truncated excerpt of the recording's content — **not** plain\ntext despite the name. `excerpt_and_highlight_matches` converts the rich\ntext with `to_plain_text`, escapes it with `html_escape_once`, then wraps\neach query match in `<mark class=\"circled-text\"><span></span>…</mark>` and\ntruncates the result to 300 characters. Treat it as an HTML fragment.\n\nOptional and non-nullable: emitted only when the underlying recordable\nresponds to `content`, so a result whose type has no content attribute\nomits the key entirely rather than sending null."
+          },
+          "plain_text_description": {
+            "type": "string",
+            "description": "The description-attribute counterpart to `plain_text_content`, with the\nsame highlighting, escaping, and 300-character truncation. Optional and\nnon-nullable — omitted when the recordable has no description attribute."
+          },
+          "content_attachments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RichTextAttachment"
+            },
+            "description": "Rich-text companion arrays carried through the polymorphic search\nprojection. A given result is one recording type, so it carries only\nthe array matching its rich-text attribute (`content_attachments` for a\nComment/Message, `description_attachments` for a Todo); a webhook-sourced\nresult carries neither. Optional (no `@required`), non-nullable.",
+            "x-go-type-skip-optional-pointer": true
+          },
+          "description_attachments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RichTextAttachment"
+            },
+            "description": "See `content_attachments` — the description-attribute companion array.",
+            "x-go-type-skip-optional-pointer": true
+          },
+          "attachments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SearchResultAttachment"
+            },
+            "description": "File attachments on the result, in either of two wire shapes — see\n`SearchResultAttachment`.\n\nFor a result whose recordable carries downloadable rich-text\nattachments, `searches/show.json.jbuilder` emits this key through the\nsame `attachments/_attachment` partial that builds the rich-text\ncompanion array above, so it repeats that array's elements. For a chat\n*upload* line, `chats/lines/_upload.json.jbuilder` instead builds a\nbespoke six-key aggregate inline — and because upload lines have no\nrich-text attribute, the show template never overwrites it, so that\ndistinct shape survives to the wire.",
+            "x-go-type-skip-optional-pointer": true
+          },
+          "subject": {
+            "type": "string"
+          },
+          "boosts_count": {
+            "type": "integer",
+            "description": "Boost count, emitted by the recording envelope when the branch passes\n`boostable` — chat lines and gauge needles.",
+            "format": "int32"
+          },
+          "boosts_url": {
+            "type": "string",
+            "description": "See `boosts_count` — the companion URL."
+          },
+          "language": {
+            "type": "string",
+            "description": "Language of a code chat line (`chats/lines/_code.json.jbuilder`);\nvalidated present on the model, so never null when the key is emitted."
+          },
+          "image_url": {
+            "type": "string",
+            "description": "Image URL of a soundtracked (play-kind) chat line whose sound carries an\nimage; such a line emits `image_url` in place of `content`."
+          },
+          "sound_url": {
+            "type": "string",
+            "description": "Sound URL of a play-kind chat line; always emitted for that kind."
+          },
+          "subscribers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Person"
+            },
+            "description": "Everyone subscribed to the kanban list, as full Person projections.",
+            "x-go-type-skip-optional-pointer": true
+          },
+          "color": {
+            "type": "string",
+            "description": "Color of a kanban list or gauge needle. Emitted unconditionally by both\nbranches with a null value when unset, so it is nullable (the enhance\npass layers `nullable: true` onto the OpenAPI).",
+            "nullable": true
+          },
+          "cards_count": {
+            "type": "integer",
+            "description": "Number of cards in the kanban list.",
+            "format": "int32"
+          },
+          "comment_count": {
+            "type": "integer",
+            "description": "Comment count of a kanban list or gauge needle (branch-partial key,\nsingular `comment_count` — distinct from the envelope's\n`comments_count`, which a needle also carries).",
+            "format": "int32"
+          },
+          "cards_url": {
+            "type": "string",
+            "description": "API URL of the kanban list's cards."
+          },
+          "on_hold": {
+            "$ref": "#/components/schemas/CardColumnOnHold"
+          },
+          "comments_count": {
+            "type": "integer",
+            "description": "Comment count, emitted by the recording envelope when the branch passes\n`commentable` — gauge needles among the special branches, plus\ncommentable generic-branch types.",
+            "format": "int32"
+          },
+          "comments_url": {
+            "type": "string",
+            "description": "See `comments_count` — the companion URL."
+          },
+          "position": {
+            "type": "integer",
+            "description": "Position of the result. Two emitters share the key: the recording\nenvelope emits list position for positioned recordings (kanban lists\namong the special branches), and the gauge-needle branch overwrites it\nwith the needle's own 0–100 gauge position.",
+            "format": "int32"
+          },
+          "filename": {
+            "type": "string",
+            "description": "Filename of a file-attachment hit. This and the following file keys are\nemitted only by the file-attachment branch — the one branch that omits\nthe id/title/type/url/app_url envelope keys."
+          },
+          "content_type": {
+            "type": "string",
+            "description": "MIME type of a file-attachment hit."
+          },
+          "byte_size": {
+            "type": "integer",
+            "description": "Size in bytes of a file-attachment hit.",
+            "format": "int64"
+          },
+          "previewable": {
+            "type": "boolean",
+            "description": "Whether the file can be previewed."
+          },
+          "width": {
+            "type": "integer",
+            "description": "Pixel width, emitted only when the file is previewable. May be\nfloat-spelled (`1024.0`) and nullable, like every other blob dimension —\nsee `RichTextAttachment.width` for the cross-SDK typing note.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
             }
           },
-          "updated_at": {
-            "type": "string",
-            "x-go-type": "time.Time",
+          "height": {
+            "type": "integer",
+            "description": "See `width` — same conditional emission and nullable/float-spelled\nbehavior.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
             "x-go-type-import": {
-              "path": "time"
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
             }
           },
-          "title": {
-            "type": "string"
-          },
-          "inherits_status": {
-            "type": "boolean"
-          },
-          "type": {
-            "type": "string"
+          "preview_url": {
+            "type": "string",
+            "description": "Full-size preview URL of a file-attachment hit."
           },
-          "url": {
-            "type": "string"
+          "thumbnail_url": {
+            "type": "string",
+            "description": "Thumbnail URL of a file-attachment hit."
           },
-          "app_url": {
-            "type": "string"
+          "download_url": {
+            "type": "string",
+            "description": "Authenticated download URL of a file-attachment hit.",
+            "x-basecamp-auth-routable-url": {}
           },
-          "bookmark_url": {
-            "type": "string"
+          "app_download_url": {
+            "type": "string",
+            "description": "Web (app-host) download URL of a file-attachment hit."
+          }
+        },
+        "required": [
+          "content",
+          "description"
+        ]
+      },
+      "SearchResultAttachment": {
+        "type": "object",
+        "description": "A file attached to a search result, in either of two wire shapes.\n\nThis is an optional-field superset over the two variants the search\nprojection emits (the TimelineAttachment approach): the rich-text\nattachment/blob shape rendered through `attachments/_attachment` +\n`blobs/_blob` — the same emitters `RichTextAttachment` models — and the\nbespoke six-key aggregate a chat upload line builds inline in\n`chats/lines/_upload.json.jbuilder`. Only the four keys both variants\nalways emit are `@required`; the rest identify their variant.",
+        "properties": {
+          "filename": {
+            "type": "string",
+            "description": "Original filename (both variants)."
           },
-          "bubble_up_url": {
+          "content_type": {
             "type": "string",
-            "description": "URL of the Bubble Up record for this recording (BC5 addition). Optional\nhere because this is a polymorphic projection:\n`recordings/_recording.json.jbuilder` emits the key only when the caller\npasses `local_assigns[:bubbleupable]`, and `todolists/_todolist` is the\nonly partial that does. So a Todolist-shaped instance carries it and the\nother recording types do not."
+            "description": "MIME type of the file (both variants)."
           },
-          "parent": {
-            "$ref": "#/components/schemas/RecordingParent"
+          "byte_size": {
+            "type": "integer",
+            "description": "Size of the file in bytes (both variants).",
+            "format": "int64"
           },
-          "bucket": {
-            "$ref": "#/components/schemas/RecordingBucket"
+          "download_url": {
+            "type": "string",
+            "description": "Authenticated download URL for the file (both variants).",
+            "x-basecamp-auth-routable-url": {}
           },
-          "creator": {
-            "$ref": "#/components/schemas/Person"
+          "id": {
+            "type": "integer",
+            "description": "Attachment id (rich-text variant).",
+            "format": "int64"
           },
-          "content": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Always present, always null. `api/searches/show.json.jbuilder` renders the\nrecording's own partial and then unconditionally overwrites `content` with\n`nil` to strip the large HTML body out of the search payload. The key is\ntherefore guaranteed present on every result — required — and its value is\nguaranteed null. Read `plain_text_content` instead.",
-            "x-go-type": "string"
+          "sgid": {
+            "type": "string",
+            "description": "Signed global id of the attachment (rich-text variant)."
           },
-          "description": {
-            "type": [
-              "string",
-              "null"
-            ],
-            "description": "Always present, always null — the description-attribute counterpart to\n`content`. Read `plain_text_description` instead.",
-            "x-go-type": "string"
+          "previewable": {
+            "type": "boolean",
+            "description": "Whether the blob can be previewed (rich-text variant)."
           },
-          "plain_text_content": {
+          "preview_url": {
             "type": "string",
-            "description": "A highlighted, truncated excerpt of the recording's content — **not** plain\ntext despite the name. `excerpt_and_highlight_matches` converts the rich\ntext with `to_plain_text`, escapes it with `html_escape_once`, then wraps\neach query match in `<mark class=\"circled-text\"><span></span>…</mark>` and\ntruncates the result to 300 characters. Treat it as an HTML fragment.\n\nOptional and non-nullable: emitted only when the underlying recordable\nresponds to `content`, so a result whose type has no content attribute\nomits the key entirely rather than sending null."
+            "description": "Full-size preview URL (rich-text variant)."
           },
-          "plain_text_description": {
+          "thumbnail_url": {
             "type": "string",
-            "description": "The description-attribute counterpart to `plain_text_content`, with the\nsame highlighting, escaping, and 300-character truncation. Optional and\nnon-nullable — omitted when the recordable has no description attribute."
+            "description": "Thumbnail URL (rich-text variant)."
           },
-          "content_attachments": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RichTextAttachment"
-            },
-            "description": "Rich-text companion arrays carried through the polymorphic search\nprojection. A given result is one recording type, so it carries only\nthe array matching its rich-text attribute (`content_attachments` for a\nComment/Message, `description_attachments` for a Todo); a webhook-sourced\nresult carries neither. Optional (no `@required`), non-nullable.\n\nSearch results additionally repeat this same array under a generic\n`attachments` key. It is a redundant projection, not a distinct\naggregate: `searches/show.json.jbuilder` emits\n`recording.downloadable_attachments`, which delegates to the recordable's\nsole `rich_text_content`, through the same `attachments/_attachment`\npartial that `recordings/_rich_text.json.jbuilder` uses to build the\ncompanion array. `RichText.rich_text_attribute` permits exactly one\nrich-text attribute per model, so the two keys always carry identical\nelements. Modeling `attachments` would duplicate the field, so it is\ndeliberately not modeled.",
-            "x-go-type-skip-optional-pointer": true
+          "width": {
+            "type": "integer",
+            "description": "Pixel width (rich-text variant) — null for non-image blobs and may be\nfloat-spelled (`1024.0`); see `RichTextAttachment.width`.",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
           },
-          "description_attachments": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RichTextAttachment"
-            },
-            "description": "See `content_attachments` — the description-attribute companion array.",
-            "x-go-type-skip-optional-pointer": true
+          "height": {
+            "type": "integer",
+            "description": "See `width` (rich-text variant).",
+            "format": "int32",
+            "nullable": true,
+            "x-go-type": "types.FlexInt",
+            "x-go-type-import": {
+              "path": "github.com/basecamp/basecamp-sdk/go/pkg/types"
+            }
           },
-          "subject": {
-            "type": "string"
+          "title": {
+            "type": "string",
+            "description": "Title of the attachment recording (chat upload-line variant)."
+          },
+          "url": {
+            "type": "string",
+            "description": "Browser preview URL of the blob (chat upload-line variant)."
           }
         },
         "required": [
-          "app_url",
-          "content",
-          "description",
-          "id",
-          "title",
-          "type",
-          "url"
+          "byte_size",
+          "content_type",
+          "download_url",
+          "filename"
         ]
       },
       "SearchType": {
@@ -30970,6 +32056,9 @@
       "SetClientVisibilityResponseContent": {
         "$ref": "#/components/schemas/Recording"
       },
+      "SpotlightRecordingResponseContent": {
+        "$ref": "#/components/schemas/Recording"
+      },
       "StorageLimitErrorResponseContent": {
         "type": "object",
         "description": "The account has reached its file storage limit.\n\nRaised by ResourceLimits#ensure_account_can_upload_files ahead of any operation\nthat stores new bytes. No retry can satisfy it: the account needs more storage,\nso this maps to `limit_exceeded` rather than a retryable server error.",
@@ -31066,6 +32155,92 @@
           "updated_at"
         ]
       },
+      "TemplateLibrary": {
+        "type": "object",
+        "properties": {
+          "bucket": {
+            "$ref": "#/components/schemas/RecordingBucket"
+          },
+          "todoset": {
+            "$ref": "#/components/schemas/RecordingParent"
+          },
+          "todolists": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Todolist"
+            }
+          }
+        },
+        "required": [
+          "bucket",
+          "todolists",
+          "todoset"
+        ]
+      },
+      "TemplateLibraryConfirmationPerson": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "name": {
+            "type": "string",
+            "format": "password",
+            "x-basecamp-sensitive": {
+              "category": "pii",
+              "redact": true
+            }
+          },
+          "avatar_url": {
+            "type": "string",
+            "format": "password",
+            "x-basecamp-sensitive": {
+              "category": "pii",
+              "redact": true
+            }
+          }
+        },
+        "required": [
+          "avatar_url",
+          "id",
+          "name"
+        ]
+      },
+      "TemplateLibraryCopy": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "status": {
+            "type": "string",
+            "description": "pending|processing|completed|failed"
+          },
+          "source_recording_id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "destination_parent_id": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "url": {
+            "type": "string"
+          },
+          "destination_todolist": {
+            "$ref": "#/components/schemas/Todolist"
+          }
+        },
+        "required": [
+          "destination_parent_id",
+          "id",
+          "source_recording_id",
+          "status",
+          "url"
+        ]
+      },
       "TimelineAttachment": {
         "type": "object",
         "description": "A single timeline-event attachment. This is an optional-field superset over\ntwo wire variants — a full Upload recording (upload-kind recordings, rendered\nby BC3's uploads/_upload partial: the complete recording projection + rich-\ntext description + the upload body) and a rich-text attachment/blob partial\n(all other recordings) — so one element type decodes either. Every field is\noptional; a given instance populates only the fields of the variant it\nrepresents. The upload-recording variant enumerates the full documented\nprojection so no documented field is silently dropped on decode.",
@@ -31912,6 +33087,9 @@
           "status": {
             "type": "string"
           },
+          "visible_to_clients": {
+            "type": "boolean"
+          },
           "created_at": {
             "type": "string",
             "x-go-type": "time.Time",
@@ -31929,15 +33107,12 @@
           "title": {
             "type": "string"
           },
-          "name": {
-            "type": "string"
-          },
-          "enabled": {
+          "inherits_status": {
             "type": "boolean"
           },
-          "position": {
-            "type": "integer",
-            "format": "int32"
+          "type": {
+            "type": "string",
+            "description": "The tool's recordable type, e.g. `Chat::Transcript`, `Todoset`, `Vault`."
           },
           "url": {
             "type": "string"
@@ -31945,17 +33120,45 @@
           "app_url": {
             "type": "string"
           },
+          "bookmark_url": {
+            "type": "string"
+          },
+          "subscription_url": {
+            "type": "string",
+            "description": "Absent for tool types that are not subscribable."
+          },
+          "position": {
+            "type": "integer",
+            "description": "Emitted only for a positioned recording. For a docked tool that makes an\nabsent position the disabled signal — disabling removes the tool from the\ndock without deleting it. Positioning is independent of dockedness, so\nthis does not generalize: a nested vault is not docked and is positioned.",
+            "format": "int32"
+          },
+          "parent": {
+            "$ref": "#/components/schemas/RecordingParent"
+          },
           "bucket": {
             "$ref": "#/components/schemas/RecordingBucket"
+          },
+          "creator": {
+            "$ref": "#/components/schemas/Person"
+          },
+          "name": {
+            "type": "string",
+            "description": "Not emitted by this projection. The dock array on a project\n(`DockItem$name`) carries the tool's slug; this key is absent from every\nGetTool/CreateTool/UpdateTool response."
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Not emitted by this projection. The dock array on a project\n(`DockItem$enabled`) is the authoritative enabled flag; on a docked tool's\nown response, an absent `position` is the equivalent signal."
           }
         },
         "required": [
           "created_at",
-          "enabled",
+          "creator",
           "id",
-          "name",
+          "inherits_status",
           "title",
-          "updated_at"
+          "type",
+          "updated_at",
+          "visible_to_clients"
         ]
       },
       "UnauthorizedErrorResponseContent": {