basecamp-sdk 0.11.0 → 0.13.0

data/lib/basecamp/generated/services/documents_service.rb

@@ -16,23 +16,26 @@ module Basecamp
         end
       end
 
-      # Update an existing document
+      # Replace a document with a new complete representation.
       # @param document_id [Integer] document id ID
       # @param title [String, nil] title
       # @param content [String, nil] content
       # @return [Hash] response data
-      def update(document_id:, title: nil, content: nil)
-        with_operation(service: "documents", operation: "update", is_mutation: true, resource_id: document_id) do
+      def replace(document_id:, title: nil, content: nil)
+        with_operation(service: "documents", operation: "replace", is_mutation: true, resource_id: document_id) do
           http_put("/documents/#{document_id}", body: compact_params(title: title, content: content)).json
         end
       end
 
       # List documents in a vault
       # @param vault_id [Integer] vault id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list(vault_id:)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list(vault_id:, page: nil, max_items: nil)
         wrap_paginated(service: "documents", operation: "list", is_mutation: false, resource_id: vault_id) do
-          paginate("/vaults/#{vault_id}/documents.json", operation: "ListDocuments")
+          params = compact_query_params(page: page)
+          paginate("/vaults/#{vault_id}/documents.json", params: params, operation: "ListDocuments", max_items: max_items)
         end
       end
 

data/lib/basecamp/generated/services/drafts_service.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Drafts operations
+    #
+    # @generated from OpenAPI spec
+    class DraftsService < BaseService
+
+      # List the current user's drafts across their active projects, most recently
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list_my_drafts(page: nil, max_items: nil)
+        wrap_paginated(service: "drafts", operation: "list_my_drafts", is_mutation: false) do
+          params = compact_query_params(page: page)
+          paginate("/my/drafts.json", params: params, operation: "ListMyDrafts", max_items: max_items)
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/generated/services/events_service.rb

@@ -9,10 +9,13 @@ module Basecamp
 
       # List all events for a recording
       # @param recording_id [Integer] recording id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list(recording_id:)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list(recording_id:, page: nil, max_items: nil)
         wrap_paginated(service: "events", operation: "list", is_mutation: false, resource_id: recording_id) do
-          paginate("/recordings/#{recording_id}/events.json", operation: "ListEvents")
+          params = compact_query_params(page: page)
+          paginate("/recordings/#{recording_id}/events.json", params: params, operation: "ListEvents", max_items: max_items)
         end
       end
     end

data/lib/basecamp/generated/services/everything_service.rb

@@ -8,160 +8,207 @@ module Basecamp
     class EverythingService < BaseService
 
       # Completed cards across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_completed_cards(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_completed_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_completed_cards", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/cards/completed.json", params: params, operation: "GetEverythingCompletedCards")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/cards/completed.json", params: params, operation: "GetEverythingCompletedCards", max_items: max_items)
         end
       end
 
       # Open cards with no due date across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_no_due_date_cards(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_no_due_date_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_no_due_date_cards", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/cards/no_due_date.json", params: params, operation: "GetEverythingNoDueDateCards")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/cards/no_due_date.json", params: params, operation: "GetEverythingNoDueDateCards", max_items: max_items)
         end
       end
 
       # Cards parked in a project's "Not now" column across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_not_now_cards(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_not_now_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_not_now_cards", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/cards/not_now.json", params: params, operation: "GetEverythingNotNowCards")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/cards/not_now.json", params: params, operation: "GetEverythingNotNowCards", max_items: max_items)
         end
       end
 
       # Incomplete cards in active columns across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_open_cards(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_open_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_open_cards", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/cards/open.json", params: params, operation: "GetEverythingOpenCards")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/cards/open.json", params: params, operation: "GetEverythingOpenCards", max_items: max_items)
         end
       end
 
       # Get every overdue card across all accessible projects, oldest-due-date-first.
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
       # @return [Array<Hash>] response data
-      def get_everything_overdue_cards()
+      def get_everything_overdue_cards(assignee_ids: nil, due: nil)
         with_operation(service: "everything", operation: "get_everything_overdue_cards", is_mutation: false) do
-          http_get("/cards/overdue.json", operation: "GetEverythingOverdueCards").json
+          http_get("/cards/overdue.json", params: compact_query_params(assignee_ids: assignee_ids, due: due), operation: "GetEverythingOverdueCards").json
         end
       end
 
       # Open, unassigned cards across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_unassigned_cards(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_unassigned_cards(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_unassigned_cards", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/cards/unassigned.json", params: params, operation: "GetEverythingUnassignedCards")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/cards/unassigned.json", params: params, operation: "GetEverythingUnassignedCards", max_items: max_items)
         end
       end
 
       # Get every automatic check-in answer across all accessible projects, newest-first.
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_checkins(page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_checkins(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_checkins", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/checkins.json", params: params, operation: "GetEverythingCheckins")
+          paginate("/checkins.json", params: params, operation: "GetEverythingCheckins", max_items: max_items)
         end
       end
 
       # Get every comment across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_comments(page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_comments(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_comments", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/comments.json", params: params, operation: "GetEverythingComments")
+          paginate("/comments.json", params: params, operation: "GetEverythingComments", max_items: max_items)
         end
       end
 
       # Get every file recording across all accessible projects, newest-first (paginated).
       # @param kind [String, nil] Filter by file kind: all (default), images, pdfs, documents, or videos.
       # @param people_ids [Array, nil] Restrict to files created by the given people (repeatable).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_files(kind: nil, people_ids: nil, page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_files(kind: nil, people_ids: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_files", is_mutation: false) do
           params = compact_query_params(kind: kind, people_ids: people_ids, page: page)
-          paginate("/files.json", params: params, operation: "GetEverythingFiles")
+          paginate("/files.json", params: params, operation: "GetEverythingFiles", max_items: max_items)
         end
       end
 
       # Get every inbox forward across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_forwards(page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_forwards(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_forwards", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/forwards.json", params: params, operation: "GetEverythingForwards")
+          paginate("/forwards.json", params: params, operation: "GetEverythingForwards", max_items: max_items)
         end
       end
 
       # Get every message across all accessible projects, newest-first (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_messages(page: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_messages(page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_messages", is_mutation: false) do
           params = compact_query_params(page: page)
-          paginate("/messages.json", params: params, operation: "GetEverythingMessages")
+          paginate("/messages.json", params: params, operation: "GetEverythingMessages", max_items: max_items)
         end
       end
 
       # Completed to-dos across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_completed_todos(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_completed_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_completed_todos", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/todos/completed.json", params: params, operation: "GetEverythingCompletedTodos")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/todos/completed.json", params: params, operation: "GetEverythingCompletedTodos", max_items: max_items)
         end
       end
 
       # Open to-dos with no due date across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_no_due_date_todos(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_no_due_date_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_no_due_date_todos", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/todos/no_due_date.json", params: params, operation: "GetEverythingNoDueDateTodos")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/todos/no_due_date.json", params: params, operation: "GetEverythingNoDueDateTodos", max_items: max_items)
         end
       end
 
       # Active, incomplete to-dos across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_open_todos(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_open_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_open_todos", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/todos/open.json", params: params, operation: "GetEverythingOpenTodos")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/todos/open.json", params: params, operation: "GetEverythingOpenTodos", max_items: max_items)
         end
       end
 
       # Get every overdue to-do across all accessible projects, oldest-due-date-first.
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
       # @return [Array<Hash>] response data
-      def get_everything_overdue_todos()
+      def get_everything_overdue_todos(assignee_ids: nil, due: nil)
         with_operation(service: "everything", operation: "get_everything_overdue_todos", is_mutation: false) do
-          http_get("/todos/overdue.json", operation: "GetEverythingOverdueTodos").json
+          http_get("/todos/overdue.json", params: compact_query_params(assignee_ids: assignee_ids, due: due), operation: "GetEverythingOverdueTodos").json
         end
       end
 
       # Open, unassigned to-dos across all accessible projects, grouped by project (paginated).
-      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1.
-      # @return [Enumerator<Hash>] paginated results
-      def get_everything_unassigned_todos(page: nil)
+      # @param assignee_ids [Array, nil] Restrict to tasks assigned to at least one of the given people (repeatable).
+      #   Assignees on nested steps are not considered.
+      # @param due [String, nil] Filter by due date: with, without, or overdue. Unrecognized values are ignored.
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def get_everything_unassigned_todos(assignee_ids: nil, due: nil, page: nil, max_items: nil)
         wrap_paginated(service: "everything", operation: "get_everything_unassigned_todos", is_mutation: false) do
-          params = compact_query_params(page: page)
-          paginate("/todos/unassigned.json", params: params, operation: "GetEverythingUnassignedTodos")
+          params = compact_query_params(assignee_ids: assignee_ids, due: due, page: page)
+          paginate("/todos/unassigned.json", params: params, operation: "GetEverythingUnassignedTodos", max_items: max_items)
         end
       end
     end

data/lib/basecamp/generated/services/folders_service.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Folders operations
+    #
+    # @generated from OpenAPI spec
+    class FoldersService < BaseService
+
+      # List the authenticated user's folders in home-screen order.
+      # @return [Array<Hash>] response data
+      def list_folders()
+        with_operation(service: "folders", operation: "list_folders", is_mutation: false) do
+          http_get("/stacks.json", operation: "ListFolders").json
+        end
+      end
+
+      # Create a folder for the authenticated user and file the given projects into it.
+      # @param name [String, nil] The folder's name. Defaults to `New folder` when blank, null, or omitted.
+      # @param project_ids [Array, nil] IDs of the projects to file into the folder — the same ids the folder
+      #   reports back as `bucket_ids` and expands as `projects`. This does not
+      #   round-trip under its own name. Omit it, or send null or an empty array,
+      #   for an empty folder.
+      # @return [Hash] response data
+      def create_folder(name: nil, project_ids: nil)
+        with_operation(service: "folders", operation: "create_folder", is_mutation: true) do
+          http_post("/stacks.json", body: compact_params(name: name, project_ids: project_ids)).json
+        end
+      end
+
+      # Get one folder, with the projects grouped inside it expanded under `projects`.
+      # @param folder_id [Integer] folder id ID
+      # @return [Hash] response data
+      def get_folder(folder_id:)
+        with_operation(service: "folders", operation: "get_folder", is_mutation: false, resource_id: folder_id) do
+          http_get("/stacks/#{folder_id}", operation: "GetFolder").json
+        end
+      end
+
+      # Rename a folder.
+      # @param folder_id [Integer] folder id ID
+      # @param name [String] The folder's new name. Blank is rejected with 422 — unlike create, update
+      #   does not fall back to a default name.
+      # @return [Hash] response data
+      def update_folder(folder_id:, name:)
+        with_operation(service: "folders", operation: "update_folder", is_mutation: true, resource_id: folder_id) do
+          http_put("/stacks/#{folder_id}", body: compact_params(name: name)).json
+        end
+      end
+
+      # Delete a folder and unpin its projects from the home screen (returns 204 No Content).
+      # @param folder_id [Integer] folder id ID
+      # @return [void]
+      def delete_folder(folder_id:)
+        with_operation(service: "folders", operation: "delete_folder", is_mutation: true, resource_id: folder_id) do
+          http_delete("/stacks/#{folder_id}")
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/generated/services/forwards_service.rb

@@ -18,20 +18,13 @@ module Basecamp
 
       # List all replies to a forward
       # @param forward_id [Integer] forward id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_replies(forward_id:)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list_replies(forward_id:, page: nil, max_items: nil)
         wrap_paginated(service: "forwards", operation: "list_replies", is_mutation: false, resource_id: forward_id) do
-          paginate("/inbox_forwards/#{forward_id}/replies.json", operation: "ListForwardReplies")
-        end
-      end
-
-      # Create a reply to a forward
-      # @param forward_id [Integer] forward id ID
-      # @param content [String] content
-      # @return [Hash] response data
-      def create_reply(forward_id:, content:)
-        with_operation(service: "forwards", operation: "create_reply", is_mutation: true, resource_id: forward_id) do
-          http_post("/inbox_forwards/#{forward_id}/replies.json", body: compact_params(content: content)).json
+          params = compact_query_params(page: page)
+          paginate("/inbox_forwards/#{forward_id}/replies.json", params: params, operation: "ListForwardReplies", max_items: max_items)
         end
       end
 
@@ -58,11 +51,13 @@ module Basecamp
       # @param inbox_id [Integer] inbox id ID
       # @param sort [String, nil] created_at|updated_at
       # @param direction [String, nil] asc|desc
-      # @return [Enumerator<Hash>] paginated results
-      def list(inbox_id:, sort: nil, direction: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list(inbox_id:, sort: nil, direction: nil, page: nil, max_items: nil)
         wrap_paginated(service: "forwards", operation: "list", is_mutation: false, resource_id: inbox_id) do
-          params = compact_query_params(sort: sort, direction: direction)
-          paginate("/inboxes/#{inbox_id}/forwards.json", params: params, operation: "ListForwards")
+          params = compact_query_params(sort: sort, direction: direction, page: page)
+          paginate("/inboxes/#{inbox_id}/inbox_forwards.json", params: params, operation: "ListForwards", max_items: max_items)
         end
       end
     end

data/lib/basecamp/generated/services/gauges_service.rb

@@ -49,10 +49,13 @@ module Basecamp
 
       # List gauge needles for a project, ordered newest first.
       # @param project_id [Integer] project id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_gauge_needles(project_id:)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list_gauge_needles(project_id:, page: nil, max_items: nil)
         wrap_paginated(service: "gauges", operation: "list_gauge_needles", is_mutation: false, project_id: project_id) do
-          paginate("/projects/#{project_id}/gauge/needles.json", operation: "ListGaugeNeedles")
+          params = compact_query_params(page: page)
+          paginate("/projects/#{project_id}/gauge/needles.json", params: params, operation: "ListGaugeNeedles", max_items: max_items)
         end
       end
 
@@ -71,11 +74,13 @@ module Basecamp
       # List gauges across all projects the authenticated user has access to.
       # @param bucket_ids [String, nil] Comma-separated list of project IDs. When provided, results are returned
       #   in the order specified instead of by risk level.
-      # @return [Enumerator<Hash>] paginated results
-      def list_gauges(bucket_ids: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list_gauges(bucket_ids: nil, page: nil, max_items: nil)
         wrap_paginated(service: "gauges", operation: "list_gauges", is_mutation: false) do
-          params = compact_query_params(bucket_ids: bucket_ids)
-          paginate("/reports/gauges.json", params: params, operation: "ListGauges")
+          params = compact_query_params(bucket_ids: bucket_ids, page: page)
+          paginate("/reports/gauges.json", params: params, operation: "ListGauges", max_items: max_items)
         end
       end
     end

data/lib/basecamp/generated/services/google_documents_service.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for GoogleDocuments operations
+    #
+    # @generated from OpenAPI spec
+    class GoogleDocumentsService < BaseService
+
+      # Create a new Google document in a vault.
+      # @param bucket_id [Integer] bucket id ID
+      # @param vault_id [Integer] vault id ID
+      # @param url [String] url
+      # @param document_type [String] One of "doc", "sheet", "slide", "other". Backed by a Rails enum, so an
+      #   unrecognized value is rejected up front with a field-keyed 422
+      #   ({"errors": {"document_type": ["is not a valid document type"]}}) rather
+      #   than reaching validation.
+      # @param title [String, nil] title
+      # @param description [String, nil] description
+      # @param status [String, nil] active|drafted — defaults to drafted
+      # @param subscriptions [Array, nil] subscriptions
+      # @param visible_to_clients [Boolean, nil] Whether the document is visible to the project's clients. Applies only
+      #   when creating directly in the tool's vault — an item created inside a
+      #   folder inherits the folder's visibility and ignores this. A client caller
+      #   always creates client-visible records regardless of what is sent.
+      # @return [Hash] response data
+      def create_google_document(bucket_id:, vault_id:, url:, document_type:, title: nil, description: nil, status: nil, subscriptions: nil, visible_to_clients: nil)
+        with_operation(service: "googledocuments", operation: "create_google_document", is_mutation: true, project_id: bucket_id, resource_id: vault_id) do
+          http_post("/buckets/#{bucket_id}/vaults/#{vault_id}/google_documents.json", body: compact_params(url: url, document_type: document_type, title: title, description: description, status: status, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
+        end
+      end
+
+      # Get a single Google document by id
+      # @param google_document_id [Integer] google document id ID
+      # @return [Hash] response data
+      def get_google_document(google_document_id:)
+        with_operation(service: "googledocuments", operation: "get_google_document", is_mutation: false, resource_id: google_document_id) do
+          http_get("/google_documents/#{google_document_id}", operation: "GetGoogleDocument").json
+        end
+      end
+
+      # Replace a Google document with a new complete representation.
+      # @param google_document_id [Integer] google document id ID
+      # @param url [String] url
+      # @param document_type [String] One of "doc", "sheet", "slide", "other". Backed by a Rails enum, so an
+      #   unrecognized value is rejected up front with a field-keyed 422
+      #   ({"errors": {"document_type": ["is not a valid document type"]}}) rather
+      #   than reaching validation.
+      # @param title [String, nil] title
+      # @param description [String, nil] description
+      # @param status [String, nil] active|drafted
+      # @param subscriptions [Array, nil] subscriptions
+      # @return [Hash] response data
+      def update_google_document(google_document_id:, url:, document_type:, title: nil, description: nil, status: nil, subscriptions: nil)
+        with_operation(service: "googledocuments", operation: "update_google_document", is_mutation: true, resource_id: google_document_id) do
+          http_put("/google_documents/#{google_document_id}", body: compact_params(url: url, document_type: document_type, title: title, description: description, status: status, subscriptions: subscriptions)).json
+        end
+      end
+    end
+  end
+end

data/lib/basecamp/generated/services/message_types_service.rb

@@ -9,10 +9,11 @@ module Basecamp
 
       # List message types in a project
       # @param bucket_id [Integer] bucket id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list(bucket_id:)
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list(bucket_id:, max_items: nil)
         wrap_paginated(service: "messagetypes", operation: "list", is_mutation: false, project_id: bucket_id) do
-          paginate("/buckets/#{bucket_id}/categories.json", operation: "ListMessageTypes")
+          paginate("/buckets/#{bucket_id}/categories.json", operation: "ListMessageTypes", max_items: max_items)
         end
       end
 

data/lib/basecamp/generated/services/messages_service.rb

@@ -11,11 +11,13 @@ module Basecamp
       # @param board_id [Integer] board id ID
       # @param sort [String, nil] created_at|updated_at
       # @param direction [String, nil] asc|desc
-      # @return [Enumerator<Hash>] paginated results
-      def list(board_id:, sort: nil, direction: nil)
+      # @param page [Integer, nil] Page number for paginating through results. Defaults to 1. A positive value selects exactly that page, not a starting offset; see SPEC section 8.
+      # @param max_items [Integer, nil] cap on items yielded across pages; nil or non-positive means no cap
+      # @return [ListEnumerator<Hash>] lazily paginated results (#meta carries pagination metadata)
+      def list(board_id:, sort: nil, direction: nil, page: nil, max_items: nil)
         wrap_paginated(service: "messages", operation: "list", is_mutation: false, resource_id: board_id) do
-          params = compact_query_params(sort: sort, direction: direction)
-          paginate("/message_boards/#{board_id}/messages.json", params: params, operation: "ListMessages")
+          params = compact_query_params(sort: sort, direction: direction, page: page)
+          paginate("/message_boards/#{board_id}/messages.json", params: params, operation: "ListMessages", max_items: max_items)
         end
       end