@37signals/basecamp 0.15.0 → 0.16.0

package/dist/generated/openapi-stripped.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Basecamp",
-    "version": "2026-08-11",
+    "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": [
@@ -18826,15 +19354,290 @@
               }
             }
           }
-        },
-        "parameters": [],
+        },
+        "parameters": [],
+        "responses": {
+          "201": {
+            "description": "CreateFolder 201 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreateFolderResponseContent"
+                }
+              }
+            }
+          },
+          "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"
+                }
+              }
+            }
+          },
+          "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": [
+          "Folders"
+        ],
+        "x-basecamp-retry": {
+          "maxAttempts": 3,
+          "baseDelayMs": 1000,
+          "backoff": "exponential",
+          "retryOn": [
+            429,
+            503
+          ]
+        }
+      }
+    },
+    "/stacks/{folderId}": {
+      "delete": {
+        "description": "Delete a folder and unpin its projects from the home screen (returns 204 No Content).\n\nThe projects themselves are not deleted and are not moved back out onto the\nhome screen; they simply stop appearing there until pinned again.",
+        "operationId": "DeleteFolder",
+        "parameters": [
+          {
+            "name": "folderId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "DeleteFolder 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"
+                }
+              }
+            }
+          },
+          "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
+          ]
+        }
+      },
+      "get": {
+        "description": "Get one folder, with the projects grouped inside it expanded under `projects`.",
+        "operationId": "GetFolder",
+        "parameters": [
+          {
+            "name": "folderId",
+            "in": "path",
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "GetFolder 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetFolderResponseContent"
+                }
+              }
+            }
+          },
+          "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": [
+          "Folders"
+        ],
+        "x-basecamp-retry": {
+          "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": {
-          "201": {
-            "description": "CreateFolder 201 response",
+          "200": {
+            "description": "UpdateFolder 200 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CreateFolderResponseContent"
+                  "$ref": "#/components/schemas/UpdateFolderResponseContent"
                 }
               }
             }
@@ -18879,16 +19682,6 @@
               }
             }
           },
-          "429": {
-            "description": "RateLimitError 429 response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
-                }
-              }
-            }
-          },
           "500": {
             "description": "InternalServerError 500 response",
             "content": {
@@ -18903,6 +19696,9 @@
         "tags": [
           "Folders"
         ],
+        "x-basecamp-idempotent": {
+          "natural": true
+        },
         "x-basecamp-retry": {
           "maxAttempts": 3,
           "baseDelayMs": 1000,
@@ -18914,24 +19710,21 @@
         }
       }
     },
-    "/stacks/{folderId}": {
-      "delete": {
-        "description": "Delete a folder and unpin its projects from the home screen (returns 204 No Content).\n\nThe projects themselves are not deleted and are not moved back out onto the\nhome screen; they simply stop appearing there until pinned again.",
-        "operationId": "DeleteFolder",
-        "parameters": [
-          {
-            "name": "folderId",
-            "in": "path",
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            },
-            "required": true
-          }
-        ],
+    "/template_library.json": {
+      "get": {
+        "description": "Get the account's to-do list template library",
+        "operationId": "GetTemplateLibrary",
+        "parameters": [],
         "responses": {
-          "204": {
-            "description": "DeleteFolder 204 response"
+          "200": {
+            "description": "GetTemplateLibrary 200 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetTemplateLibraryResponseContent"
+                }
+              }
+            }
           },
           "401": {
             "description": "UnauthorizedError 401 response",
@@ -18953,12 +19746,12 @@
               }
             }
           },
-          "404": {
-            "description": "NotFoundError 404 response",
+          "429": {
+            "description": "RateLimitError 429 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/NotFoundErrorResponseContent"
+                  "$ref": "#/components/schemas/RateLimitErrorResponseContent"
                 }
               }
             }
@@ -18975,11 +19768,8 @@
           }
         },
         "tags": [
-          "Folders"
+          "Automation"
         ],
-        "x-basecamp-idempotent": {
-          "natural": true
-        },
         "x-basecamp-retry": {
           "maxAttempts": 3,
           "baseDelayMs": 1000,
@@ -18989,28 +19779,30 @@
             503
           ]
         }
-      },
-      "get": {
-        "description": "Get one folder, with the projects grouped inside it expanded under `projects`.",
-        "operationId": "GetFolder",
-        "parameters": [
-          {
-            "name": "folderId",
-            "in": "path",
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            },
-            "required": true
-          }
-        ],
+      }
+    },
+    "/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": {
-          "200": {
-            "description": "GetFolder 200 response",
+          "201": {
+            "description": "CreateTemplateLibraryCopy 201 response",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetFolderResponseContent"
+                  "$ref": "#/components/schemas/CreateTemplateLibraryCopyResponseContent"
                 }
               }
             }
@@ -19045,6 +19837,16 @@
               }
             }
           },
+          "422": {
+            "description": "PeopleConfirmationRequiredError 422 response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PeopleConfirmationRequiredErrorResponseContent"
+                }
+              }
+            }
+          },
           "429": {
             "description": "RateLimitError 429 response",
             "content": {
@@ -19067,10 +19869,10 @@
           }
         },
         "tags": [
-          "Folders"
+          "Automation"
         ],
         "x-basecamp-retry": {
-          "maxAttempts": 3,
+          "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,
@@ -25553,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": {
@@ -26071,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": {
@@ -27956,6 +28780,12 @@
       "GetSubscriptionResponseContent": {
         "$ref": "#/components/schemas/Subscription"
       },
+      "GetTemplateLibraryCopyResponseContent": {
+        "$ref": "#/components/schemas/TemplateLibraryCopy"
+      },
+      "GetTemplateLibraryResponseContent": {
+        "$ref": "#/components/schemas/TemplateLibrary"
+      },
       "GetTemplateResponseContent": {
         "$ref": "#/components/schemas/Template"
       },
@@ -28502,6 +29332,12 @@
           "$ref": "#/components/schemas/Question"
         }
       },
+      "ListRecentProjectsResponseContent": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/Project"
+        }
+      },
       "ListRecordingBoostsResponseContent": {
         "type": "array",
         "items": {
@@ -29256,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": {
@@ -29530,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"
           },
@@ -29544,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"
@@ -31192,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.",
@@ -31288,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.",