basecamp-sdk 0.12.0 → 0.14.0

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

@@ -9,11 +9,13 @@ module Basecamp
 
       # List projects (active by default; optionally archived/trashed)
       # @param status [String, nil] active|archived|trashed
-      # @return [Enumerator<Hash>] paginated results
-      def list(status: 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(status: nil, page: nil, max_items: nil)
         wrap_paginated(service: "projects", operation: "list", is_mutation: false) do
-          params = compact_query_params(status: status)
-          paginate("/projects.json", params: params, operation: "ListProjects")
+          params = compact_query_params(status: status, page: page)
+          paginate("/projects.json", params: params, operation: "ListProjects", max_items: max_items)
         end
       end
 
@@ -58,6 +60,26 @@ module Basecamp
           nil
         end
       end
+
+      # Restore a project to active status from trash as well as from the archive (returns 204 No Content).
+      # @param project_id [Integer] project id ID
+      # @return [void]
+      def unarchive(project_id:)
+        with_operation(service: "projects", operation: "unarchive", is_mutation: true, project_id: project_id) do
+          http_put("/projects/#{project_id}/status/active.json")
+          nil
+        end
+      end
+
+      # Archive a project, removing it from the active project list (returns 204 No Content).
+      # @param project_id [Integer] project id ID
+      # @return [void]
+      def archive(project_id:)
+        with_operation(service: "projects", operation: "archive", is_mutation: true, project_id: project_id) do
+          http_put("/projects/#{project_id}/status/archived.json")
+          nil
+        end
+      end
     end
   end
 end

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

@@ -13,20 +13,13 @@ module Basecamp
       # @param status [String, nil] active|archived|trashed
       # @param sort [String, nil] created_at|updated_at
       # @param direction [String, nil] asc|desc
-      # @return [Enumerator<Hash>] paginated results
-      def list(type:, bucket: nil, status: nil, 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(type:, bucket: nil, status: nil, sort: nil, direction: nil, page: nil, max_items: nil)
         wrap_paginated(service: "recordings", operation: "list", is_mutation: false) do
-          params = compact_query_params(type: type, bucket: bucket, status: status, sort: sort, direction: direction)
-          paginate("/projects/recordings.json", params: params, operation: "ListRecordings")
-        end
-      end
-
-      # Get a single recording by id
-      # @param recording_id [Integer] recording id ID
-      # @return [Hash] response data
-      def get(recording_id:)
-        with_operation(service: "recordings", operation: "get", is_mutation: false, resource_id: recording_id) do
-          http_get("/recordings/#{recording_id}", operation: "GetRecording").json
+          params = compact_query_params(type: type, bucket: bucket, status: status, sort: sort, direction: direction, page: page)
+          paginate("/projects/recordings.json", params: params, operation: "ListRecordings", max_items: max_items)
         end
       end
 

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

@@ -8,18 +8,21 @@ module Basecamp
     class ReportsService < BaseService
 
       # Get account-wide activity feed (progress report)
-      # @return [Enumerator<Hash>] paginated results
-      def progress()
+      # @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 progress(page: nil, max_items: nil)
         wrap_paginated(service: "reports", operation: "progress", is_mutation: false) do
-          paginate("/reports/progress.json", operation: "GetProgressReport")
+          params = compact_query_params(page: page)
+          paginate("/reports/progress.json", params: params, operation: "GetProgressReport", max_items: max_items)
         end
       end
 
       # Get upcoming schedule entries and assignable items within a date window.
-      # @param window_starts_on [String, nil] window starts on
-      # @param window_ends_on [String, nil] window ends on
+      # @param window_starts_on [String] Inclusive first day of the window, `YYYY-MM-DD`. Required — BC3 answers 400 without it.
+      # @param window_ends_on [String] Inclusive last day of the window, `YYYY-MM-DD`. Required — BC3 answers 400 without it.
       # @return [Hash] response data
-      def upcoming(window_starts_on: nil, window_ends_on: nil)
+      def upcoming(window_starts_on:, window_ends_on:)
         with_operation(service: "reports", operation: "upcoming", is_mutation: false) do
           http_get("/reports/schedules/upcoming.json", params: compact_query_params(window_starts_on: window_starts_on, window_ends_on: window_ends_on), operation: "GetUpcomingSchedule").json
         end
@@ -45,10 +48,13 @@ module Basecamp
 
       # Get a person's activity timeline
       # @param person_id [Integer] person id ID
-      # @return [Hash] response data
-      def person_progress(person_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 [Hash] wrapper fields merged with a ListEnumerator of the paginated items
+      def person_progress(person_id:, page: nil, max_items: nil)
         wrap_paginated_wrapped(key: "events", service: "reports", operation: "person_progress", is_mutation: false, resource_id: person_id) do
-          paginate_wrapped("/reports/users/progress/#{person_id}.json", key: "events", operation: "GetPersonProgress")
+          params = compact_query_params(page: page)
+          paginate_wrapped("/reports/users/progress/#{person_id}.json", key: "events", params: params, operation: "GetPersonProgress", max_items: max_items)
         end
       end
     end

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

@@ -16,14 +16,16 @@ module Basecamp
         end
       end
 
-      # Update an existing schedule entry
+      # Replace a schedule entry with a new complete representation.
       # @param entry_id [Integer] entry id ID
       # @param summary [String, nil] summary
-      # @param starts_at [String, nil] starts at (RFC3339 (e.g., 2024-12-15T09:00:00Z))
-      # @param ends_at [String, nil] ends at (RFC3339 (e.g., 2024-12-15T09:00:00Z))
+      # @param starts_at [String] The entry's start, as a bare date ("2026-06-01") for an all-day entry or a
+      #   full timestamp otherwise. Same rule as CreateScheduleEntry: send it
+      #   verbatim, never parsed and re-rendered.
+      # @param ends_at [String] The entry's end. See starts_at for the date-vs-timestamp rule.
       # @param description [String, nil] description
       # @param participant_ids [Array, nil] Replaces the entry's participants.
-      #   
+      #
       #   Omitting this member preserves the current participants; sending an empty
       #   array clears them. That guarantee is BC3-side and recent: until
       #   basecamp/bc3#12425, `Schedules::EntriesController#update` called
@@ -31,12 +33,36 @@ module Basecamp
       #   including the shape in BC3's own "Update a schedule entry" doc example —
       #   silently removed every participant and notified each one. The controller
       #   now guards on the request actually addressing participants.
-      # @param all_day [Boolean, nil] all day
+      # @param all_day [Boolean, nil] Whether the entry occupies whole days rather than a time range.
+      #
+      #   Not carved out, and the carve-out list is what makes that dangerous to
+      #   forget: `schedule_entries.all_day` is NOT NULL with a `false` default, so
+      #   omitting this member on a replace resets it — silently converting an
+      #   all-day entry into a midnight-to-midnight timed one. The SDK's merge-safe
+      #   update and edit resend it from the read-back for exactly this reason.
+      #
+      #   Sending an explicit null is worse than omitting it: the column rejects
+      #   NULL, so BC3 raises rather than falling back to the default. The same is
+      #   true of highlighted.
       # @param notify [Boolean, nil] notify
+      # @param url [String, nil] The entry's join link — a video-call URL or similar, up to 2500
+      #   characters, validated as a URL when present.
+      #
+      #   Omitting this member preserves the current join link; sending an empty
+      #   string clears it. Read it back as `join_url`, never as `url`: the entry's
+      #   `url` is its own Basecamp API URL, written by a partial that renders
+      #   before this one, so BC3 emits the join link under a non-colliding key.
+      #   Echoing the response's `url` into this member would write the API URL into
+      #   the join link.
+      # @param highlighted [Boolean, nil] Whether the entry is highlighted on the schedule.
+      #
+      #   Omitting this member preserves the current highlight; sending false
+      #   removes it. Preserved on omission because until basecamp/bc3#12502 the
+      #   field was writable but never returned, so no caller could resend it.
       # @return [Hash] response data
-      def update_entry(entry_id:, summary: nil, starts_at: nil, ends_at: nil, description: nil, participant_ids: nil, all_day: nil, notify: nil)
-        with_operation(service: "schedules", operation: "update_entry", is_mutation: true, resource_id: entry_id) do
-          http_put("/schedule_entries/#{entry_id}", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify)).json
+      def replace_entry(entry_id:, starts_at:, ends_at:, summary: nil, description: nil, participant_ids: nil, all_day: nil, notify: nil, url: nil, highlighted: nil)
+        with_operation(service: "schedules", operation: "replace_entry", is_mutation: true, resource_id: entry_id) do
+          http_put("/schedule_entries/#{entry_id}", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify, url: url, highlighted: highlighted)).json
         end
       end
 
@@ -72,29 +98,77 @@ module Basecamp
       # List entries on a schedule
       # @param schedule_id [Integer] schedule id ID
       # @param status [String, nil] active|archived|trashed
-      # @return [Enumerator<Hash>] paginated results
-      def list_entries(schedule_id:, status: 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_entries(schedule_id:, status: nil, page: nil, max_items: nil)
         wrap_paginated(service: "schedules", operation: "list_entries", is_mutation: false, resource_id: schedule_id) do
-          params = compact_query_params(status: status)
-          paginate("/schedules/#{schedule_id}/entries.json", params: params, operation: "ListScheduleEntries")
+          params = compact_query_params(status: status, page: page)
+          paginate("/schedules/#{schedule_id}/entries.json", params: params, operation: "ListScheduleEntries", max_items: max_items)
         end
       end
 
       # Create a new schedule entry
       # @param schedule_id [Integer] schedule id ID
       # @param summary [String] summary
-      # @param starts_at [String] starts at (RFC3339 (e.g., 2024-12-15T09:00:00Z))
-      # @param ends_at [String] ends at (RFC3339 (e.g., 2024-12-15T09:00:00Z))
+      # @param starts_at [String] The entry's start, as a bare date ("2026-06-01") for an all-day entry or a
+      #   full timestamp ("2026-06-01T09:00:00Z") otherwise — the same two forms the
+      #   response renders, and the same two ReplaceScheduleEntry accepts.
+      #
+      #   Create and replace share one permit list:
+      #   `Schedules::Entries::BaseController#base_schedule_entry_params` is what
+      #   both `new_schedule_entry_params` and `update_schedule_entry_params` call,
+      #   and Schedule::Entry does no format-specific parsing of either bound, so
+      #   whatever one operation takes the other takes too.
+      #
+      #   Treat the value as opaque and send it verbatim. Parsing it into a
+      #   date-time type and re-rendering rewrites an all-day entry's bounds into
+      #   midnight timestamps, which is why every SDK models it as a string.
+      # @param ends_at [String] The entry's end. See starts_at for the date-vs-timestamp rule.
       # @param description [String, nil] description
       # @param participant_ids [Array, nil] participant ids
       # @param all_day [Boolean, nil] all day
       # @param notify [Boolean, nil] notify
+      # @param url [String, nil] The entry's join link — a video-call URL or similar, up to 2500
+      #   characters, validated as a URL when present. A scheme-less value is
+      #   normalized to `https://`.
+      #
+      #   Spell it `url` on the way in and read it back as `join_url`: the response
+      #   key `url` is the entry's own Basecamp API URL, written by a partial that
+      #   renders before this field, so BC3 emits the join link under a
+      #   non-colliding name. Sending `join_url` instead is silently dropped by
+      #   strong parameters — the create succeeds with no join link.
+      #
+      #   Accepted on create since long before it was documented:
+      #   `Schedules::Entries::BaseController#base_schedule_entry_params` permits it
+      #   and `new_schedule_entry_params` passes it through unchanged for API
+      #   requests. Modeling it only on ReplaceScheduleEntry forced callers into a
+      #   three-request read-modify-write for a field the create already took — and
+      #   create is the notifying write, so participants learned about a video call
+      #   before its link existed.
+      # @param highlighted [Boolean, nil] Whether the entry is highlighted on the schedule. Defaults to false.
+      #
+      #   Do not send an explicit null: `schedule_entries.highlighted` is NOT NULL,
+      #   so BC3 raises rather than falling back to the default. Omit it instead —
+      #   every SDK's request compactor already drops unset members.
+      # @param status [String, nil] Publication state at creation — `active|drafted`, defaulting to `active`
+      #   for an API create.
+      #
+      #   A top-level parameter, not part of the entry's attributes: `status` is a
+      #   Recording column, so `wrap_parameters` leaves it outside the
+      #   `schedule_entry` envelope and `Recording::StatusParam#status_param` reads
+      #   it directly. On create it accepts `drafted`, `active`, `archived` or
+      #   `trashed` and raises `ActionController::BadRequest` — a 400, not a 422 —
+      #   for anything else; the two documented values are the two worth sending.
+      #
+      #   Unlike messages and documents, schedule-entry drafts are not listed by
+      #   GetMyDrafts.
       # @param subscriptions [Array, nil] subscriptions
       # @param visible_to_clients [Boolean, nil] visible to clients
       # @return [Hash] response data
-      def create_entry(schedule_id:, summary:, starts_at:, ends_at:, description: nil, participant_ids: nil, all_day: nil, notify: nil, subscriptions: nil, visible_to_clients: nil)
+      def create_entry(schedule_id:, summary:, starts_at:, ends_at:, description: nil, participant_ids: nil, all_day: nil, notify: nil, url: nil, highlighted: nil, status: nil, subscriptions: nil, visible_to_clients: nil)
         with_operation(service: "schedules", operation: "create_entry", is_mutation: true, resource_id: schedule_id) do
-          http_post("/schedules/#{schedule_id}/entries.json", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
+          http_post("/schedules/#{schedule_id}/entries.json", body: compact_params(summary: summary, starts_at: starts_at, ends_at: ends_at, description: description, participant_ids: participant_ids, all_day: all_day, notify: notify, url: url, highlighted: highlighted, status: status, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
         end
       end
     end

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

@@ -21,11 +21,13 @@ module Basecamp
       # @param type [String, nil] Deprecated: prefer type_names[].
       # @param bucket_id [Integer, nil] Deprecated: prefer bucket_ids[].
       # @param creator_id [Integer, nil] Deprecated: prefer creator_ids[].
-      # @return [Enumerator<Hash>] paginated results
-      def search(q:, type_names: nil, bucket_ids: nil, creator_ids: nil, file_type: nil, exclude_chat: nil, since: nil, sort: nil, type: nil, bucket_id: nil, creator_id: 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 search(q:, type_names: nil, bucket_ids: nil, creator_ids: nil, file_type: nil, exclude_chat: nil, since: nil, sort: nil, type: nil, bucket_id: nil, creator_id: nil, page: nil, max_items: nil)
         wrap_paginated(service: "search", operation: "search", is_mutation: false) do
-          params = compact_query_params(q: q, type_names: type_names, bucket_ids: bucket_ids, creator_ids: creator_ids, file_type: file_type, exclude_chat: exclude_chat, since: since, sort: sort, type: type, bucket_id: bucket_id, creator_id: creator_id)
-          paginate("/search.json", params: params, operation: "Search")
+          params = compact_query_params(q: q, type_names: type_names, bucket_ids: bucket_ids, creator_ids: creator_ids, file_type: file_type, exclude_chat: exclude_chat, since: since, sort: sort, type: type, bucket_id: bucket_id, creator_id: creator_id, page: page)
+          paginate("/search.json", params: params, operation: "Search", max_items: max_items)
         end
       end
 

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

@@ -9,11 +9,13 @@ module Basecamp
 
       # List all templates visible to the current user
       # @param status [String, nil] active|archived|trashed
-      # @return [Enumerator<Hash>] paginated results
-      def list(status: 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(status: nil, page: nil, max_items: nil)
         wrap_paginated(service: "templates", operation: "list", is_mutation: false) do
-          params = compact_query_params(status: status)
-          paginate("/templates.json", params: params, operation: "ListTemplates")
+          params = compact_query_params(status: status, page: page)
+          paginate("/templates.json", params: params, operation: "ListTemplates", max_items: max_items)
         end
       end
 

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

@@ -9,10 +9,13 @@ module Basecamp
 
       # Get project timeline
       # @param project_id [Integer] project id ID
-      # @return [Enumerator<Hash>] paginated results
-      def get_project_timeline(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 get_project_timeline(project_id:, page: nil, max_items: nil)
         wrap_paginated(service: "timeline", operation: "get_project_timeline", is_mutation: false, project_id: project_id) do
-          paginate("/projects/#{project_id}/timeline.json", operation: "GetProjectTimeline")
+          params = compact_query_params(page: page)
+          paginate("/projects/#{project_id}/timeline.json", params: params, operation: "GetProjectTimeline", max_items: max_items)
         end
       end
     end

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

@@ -12,11 +12,13 @@ module Basecamp
       # @param from [String, nil] from
       # @param to [String, nil] to
       # @param person_id [Integer, nil] person id
-      # @return [Enumerator<Hash>] paginated results
-      def for_project(project_id:, from: nil, to: nil, person_id: 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 for_project(project_id:, from: nil, to: nil, person_id: nil, page: nil, max_items: nil)
         wrap_paginated(service: "timesheets", operation: "for_project", is_mutation: false, project_id: project_id) do
-          params = compact_query_params(from: from, to: to, person_id: person_id)
-          paginate("/projects/#{project_id}/timesheet.json", params: params, operation: "GetProjectTimesheet")
+          params = compact_query_params(from: from, to: to, person_id: person_id, page: page)
+          paginate("/projects/#{project_id}/timesheet.json", params: params, operation: "GetProjectTimesheet", max_items: max_items)
         end
       end
 
@@ -25,11 +27,13 @@ module Basecamp
       # @param from [String, nil] from
       # @param to [String, nil] to
       # @param person_id [Integer, nil] person id
-      # @return [Enumerator<Hash>] paginated results
-      def for_recording(recording_id:, from: nil, to: nil, person_id: 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 for_recording(recording_id:, from: nil, to: nil, person_id: nil, page: nil, max_items: nil)
         wrap_paginated(service: "timesheets", operation: "for_recording", is_mutation: false, resource_id: recording_id) do
-          params = compact_query_params(from: from, to: to, person_id: person_id)
-          paginate("/recordings/#{recording_id}/timesheet.json", params: params, operation: "GetRecordingTimesheet")
+          params = compact_query_params(from: from, to: to, person_id: person_id, page: page)
+          paginate("/recordings/#{recording_id}/timesheet.json", params: params, operation: "GetRecordingTimesheet", max_items: max_items)
         end
       end
 
@@ -78,6 +82,16 @@ module Basecamp
           http_put("/timesheet_entries/#{entry_id}", body: compact_params(date: date, hours: hours, description: description, person_id: person_id)).json
         end
       end
+
+      # Permanently delete a timesheet entry; answers 403 when the caller may not archive or trash it.
+      # @param entry_id [Integer] entry id ID
+      # @return [void]
+      def destroy(entry_id:)
+        with_operation(service: "timesheets", operation: "destroy", is_mutation: true, resource_id: entry_id) do
+          http_delete("/timesheet_entries/#{entry_id}")
+          nil
+        end
+      end
     end
   end
 end

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

@@ -13,17 +13,20 @@ module Basecamp
       # @return [void]
       def reposition(group_id:, position:)
         with_operation(service: "todolistgroups", operation: "reposition", is_mutation: true, resource_id: group_id) do
-          http_put("/todolists/#{group_id}/position.json", body: compact_params(position: position))
+          http_put("/todolists/groups/#{group_id}/position.json", body: compact_params(position: position))
           nil
         end
       end
 
       # List groups in a todolist
       # @param todolist_id [Integer] todolist id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list(todolist_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(todolist_id:, page: nil, max_items: nil)
         wrap_paginated(service: "todolistgroups", operation: "list", is_mutation: false, resource_id: todolist_id) do
-          paginate("/todolists/#{todolist_id}/groups.json", operation: "ListTodolistGroups")
+          params = compact_query_params(page: page)
+          paginate("/todolists/#{todolist_id}/groups.json", params: params, operation: "ListTodolistGroups", max_items: max_items)
         end
       end
 

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

@@ -16,13 +16,13 @@ module Basecamp
         end
       end
 
-      # Update an existing todolist or todolist group
+      # Replace a todolist (or todolist group) with a new complete representation.
       # @param id [Integer] id ID
-      # @param name [String, nil] Name (required for both Todolist and TodolistGroup)
-      # @param description [String, nil] Description (Todolist only, ignored for groups)
+      # @param name [String] Name (required for a to-do list and for a group alike) - presence-validated server-side, so omitting it is a 422, not a preserve
+      # @param description [String, nil] Description (rich text HTML) - writable for a todolist group as well as a todolist, and omitting it clears it either way
       # @return [Hash] response data
-      def update(id:, name: nil, description: nil)
-        with_operation(service: "todolists", operation: "update", is_mutation: true, resource_id: id) do
+      def replace(id:, name:, description: nil)
+        with_operation(service: "todolists", operation: "replace", is_mutation: true, resource_id: id) do
           http_put("/todolists/#{id}", body: compact_params(name: name, description: description)).json
         end
       end
@@ -41,11 +41,13 @@ module Basecamp
       # List todolists in a todoset
       # @param todoset_id [Integer] todoset id ID
       # @param status [String, nil] active|archived|trashed
-      # @return [Enumerator<Hash>] paginated results
-      def list(todoset_id:, status: 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(todoset_id:, status: nil, page: nil, max_items: nil)
         wrap_paginated(service: "todolists", operation: "list", is_mutation: false, resource_id: todoset_id) do
-          params = compact_query_params(status: status)
-          paginate("/todosets/#{todoset_id}/todolists.json", params: params, operation: "ListTodolists")
+          params = compact_query_params(status: status, page: page)
+          paginate("/todosets/#{todoset_id}/todolists.json", params: params, operation: "ListTodolists", max_items: max_items)
         end
       end
 

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

@@ -28,11 +28,13 @@ module Basecamp
       # @param todolist_id [Integer] todolist id ID
       # @param status [String, nil] active|archived|trashed
       # @param completed [Boolean, nil] completed
-      # @return [Enumerator<Hash>] paginated results
-      def list(todolist_id:, status: nil, completed: 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(todolist_id:, status: nil, completed: nil, page: nil, max_items: nil)
         wrap_paginated(service: "todos", operation: "list", is_mutation: false, resource_id: todolist_id) do
-          params = compact_query_params(status: status, completed: completed)
-          paginate("/todolists/#{todolist_id}/todos.json", params: params, operation: "ListTodos")
+          params = compact_query_params(status: status, completed: completed, page: page)
+          paginate("/todolists/#{todolist_id}/todos.json", params: params, operation: "ListTodos", max_items: max_items)
         end
       end
 
@@ -77,16 +79,6 @@ module Basecamp
         end
       end
 
-      # Trash a todo (returns 204 No Content)
-      # @param todo_id [Integer] todo id ID
-      # @return [void]
-      def trash(todo_id:)
-        with_operation(service: "todos", operation: "trash", is_mutation: true, resource_id: todo_id) do
-          http_delete("/todos/#{todo_id}")
-          nil
-        end
-      end
-
       # Mark a todo as complete
       # @param todo_id [Integer] todo id ID
       # @return [void]

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

@@ -29,19 +29,41 @@ module Basecamp
 
       # List versions of an upload
       # @param upload_id [Integer] upload id ID
-      # @return [Enumerator<Hash>] paginated results
-      def list_versions(upload_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_versions(upload_id:, max_items: nil)
         wrap_paginated(service: "uploads", operation: "list_versions", is_mutation: false, resource_id: upload_id) do
-          paginate("/uploads/#{upload_id}/versions.json", operation: "ListUploadVersions")
+          paginate("/uploads/#{upload_id}/versions.json", operation: "ListUploadVersions", max_items: max_items)
+        end
+      end
+
+      # Replace an upload's file with a new version
+      # @param upload_id [Integer] upload id ID
+      # @param attachable_sgid [String] attachable sgid
+      # @param base_name [String, nil] Omit to keep the uploaded file's own name. Sending "" also keeps it.
+      # @param description [String, nil] Presence-aware: omit to carry the previous version's description forward,
+      #   send "" to clear it, send a value to set it.
+      # @param notify [String, nil] Who to notify: "default", "everyone", or "custom" (the people in subscriptions).
+      #
+      #   Omit both this and subscriptions to notify nobody. A subscriptions array sent
+      #   without notify is read as "custom".
+      # @param subscriptions [Array, nil] People to notify about the replacement and subscribe to the upload.
+      # @return [Hash] response data
+      def create_version(upload_id:, attachable_sgid:, base_name: nil, description: nil, notify: nil, subscriptions: nil)
+        with_operation(service: "uploads", operation: "create_version", is_mutation: true, resource_id: upload_id) do
+          http_post("/uploads/#{upload_id}/versions.json", body: compact_params(attachable_sgid: attachable_sgid, base_name: base_name, description: description, notify: notify, subscriptions: subscriptions)).json
         end
       end
 
       # List uploads 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: "uploads", operation: "list", is_mutation: false, resource_id: vault_id) do
-          paginate("/vaults/#{vault_id}/uploads.json", operation: "ListUploads")
+          params = compact_query_params(page: page)
+          paginate("/vaults/#{vault_id}/uploads.json", params: params, operation: "ListUploads", max_items: max_items)
         end
       end
 

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

@@ -28,10 +28,13 @@ module Basecamp
 
       # List vaults (subfolders) 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: "vaults", operation: "list", is_mutation: false, resource_id: vault_id) do
-          paginate("/vaults/#{vault_id}/vaults.json", operation: "ListVaults")
+          params = compact_query_params(page: page)
+          paginate("/vaults/#{vault_id}/vaults.json", params: params, operation: "ListVaults", max_items: max_items)
         end
       end
 

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

@@ -9,10 +9,11 @@ module Basecamp
 
       # List all webhooks for 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: "webhooks", operation: "list", is_mutation: false, project_id: bucket_id) do
-          paginate("/buckets/#{bucket_id}/webhooks.json", operation: "ListWebhooks")
+          paginate("/buckets/#{bucket_id}/webhooks.json", operation: "ListWebhooks", max_items: max_items)
         end
       end