basecamp-sdk 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1df4a43587230e1bfbf0403175de3fdf93b50635c42a91a71d3c2e29bb835c8
-  data.tar.gz: c2a9eb831ecd48967fdb706a808fe13a923570f97edcf7b6ed96b7e2372dfcd2
+  metadata.gz: 7b16ed47ffa033dcc0c642c37ebc51a4bc6552fa06a088fd268cb451fa09e2f8
+  data.tar.gz: 48c691a48f55cc68f9d3d5208488c8baecb56264a230614a22e6b7746d8a7451
 SHA512:
-  metadata.gz: 25fb53f7d538f519dfd7f7091e687dec7a0f9ce59f65df4c612f44fcea5cf2f3d65d8b8257dcccb8a0bc2b535e340efe911b9f435ef54f022ac0f9752953f6d5
-  data.tar.gz: 6a7f120b233a4d4dc07f5a233c97ee4c8fb3861181143bdd492a7e48998903eb8e0a465b6cfc8816511ef03ecfa0657c0af951b05f3d5a761019130332401a27
+  metadata.gz: 20f3979bfb268ce78303e4b10aadb50194a4b20818876a076753560260f54d70a9cbd42851a7a4337cdefc316a1800f6d4088437cd68994a684b2e9f60b2d016
+  data.tar.gz: 88bb6d1ec5889506b6f24660ce919befa780057f37587143526d524286d6fcd1d098aed95971f136400cfc1ab65656f28ea9f605c24ac543c5f9f0c02474fd74

data/README.md

@@ -347,6 +347,7 @@ The SDK provides the full account-scoped service set documented in SPEC §5. The
 | `card_tables` | Card tables (kanban) |
 | `card_columns` | Card table columns |
 | `card_steps` | Card workflow steps |
+| `subtasks` | Subtasks (checklist items) on to-dos and cards |
 | `wormholes` | Card table wormholes (cross-project moves) |
 | `lineup` | Card lineup view |
 | `tools` | Project dock tools |

data/lib/basecamp/client.rb

@@ -607,6 +607,11 @@ module Basecamp
       service(:boosts) { Services::BoostsService.new(self) }
     end
 
+    # @return [Services::SubtasksService]
+    def subtasks
+      service(:subtasks) { Services::SubtasksService.new(self) }
+    end
+
     # @return [Services::AccountService]
     def account
       service(:account) { Services::AccountService.new(self) }

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-09-16T14:38:22Z",
+  "generated": "2026-09-30T18:52:50Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -375,6 +375,28 @@
         ]
       }
     },
+    "CreateTemplatification": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetTemplatification": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "CreateTodosetTodo": {
       "retry": {
         "maxAttempts": 3,
@@ -2489,6 +2511,33 @@
         "natural": true
       }
     },
+    "ListSubtasks": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "CreateSubtask": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "GetRecordingTimesheet": {
       "retry": {
         "maxAttempts": 3,
@@ -2834,7 +2883,7 @@
         "natural": true
       }
     },
-    "GetTemplateLibrary": {
+    "GetSubtask": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -2845,6 +2894,98 @@
         ]
       }
     },
+    "UpdateSubtask": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteSubtask": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "CompleteSubtask": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "UncompleteSubtask": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "RepositionSubtask": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "GetTemplateLibraryCardTables": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "CreateTemplateLibraryCardTable": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "CreateTemplateLibraryCopy": {
       "retry": {
         "maxAttempts": 2,
@@ -2867,6 +3008,28 @@
         ]
       }
     },
+    "GetTemplateLibraryTodolists": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "CreateTemplateLibraryTodolist": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListTemplates": {
       "retry": {
         "maxAttempts": 3,
@@ -3566,7 +3729,35 @@
       "creator",
       "participants.[]"
     ],
+    "CreateSubtask": [
+      "assignees.[]",
+      "completer",
+      "creator"
+    ],
+    "CreateTemplateLibraryCardTable": [
+      "creator",
+      "lists.[].creator",
+      "lists.[].subscribers.[]",
+      "subscribers.[]",
+      "wormholes.[].creator"
+    ],
     "CreateTemplateLibraryCopy": [
+      "destination_card_table.creator",
+      "destination_card_table.lists.[].creator",
+      "destination_card_table.lists.[].subscribers.[]",
+      "destination_card_table.subscribers.[]",
+      "destination_card_table.wormholes.[].creator",
+      "destination_todolist.creator"
+    ],
+    "CreateTemplateLibraryTodolist": [
+      "creator"
+    ],
+    "CreateTemplatification": [
+      "destination_card_table.creator",
+      "destination_card_table.lists.[].creator",
+      "destination_card_table.lists.[].subscribers.[]",
+      "destination_card_table.subscribers.[]",
+      "destination_card_table.wormholes.[].creator",
       "destination_todolist.creator"
     ],
     "CreateTimesheetEntry": [
@@ -3914,10 +4105,31 @@
     "GetSubscription": [
       "subscribers.[]"
     ],
-    "GetTemplateLibrary": [
-      "todolists.[].creator"
+    "GetSubtask": [
+      "assignees.[]",
+      "completer",
+      "creator"
+    ],
+    "GetTemplateLibraryCardTables": [
+      "card_tables.[].creator"
     ],
     "GetTemplateLibraryCopy": [
+      "destination_card_table.creator",
+      "destination_card_table.lists.[].creator",
+      "destination_card_table.lists.[].subscribers.[]",
+      "destination_card_table.subscribers.[]",
+      "destination_card_table.wormholes.[].creator",
+      "destination_todolist.creator"
+    ],
+    "GetTemplateLibraryTodolists": [
+      "todolists.[].creator"
+    ],
+    "GetTemplatification": [
+      "destination_card_table.creator",
+      "destination_card_table.lists.[].creator",
+      "destination_card_table.lists.[].subscribers.[]",
+      "destination_card_table.subscribers.[]",
+      "destination_card_table.wormholes.[].creator",
       "destination_todolist.creator"
     ],
     "GetTimesheetEntry": [
@@ -4047,6 +4259,11 @@
       "[].creator",
       "[].participants.[]"
     ],
+    "ListSubtasks": [
+      "[].assignees.[]",
+      "[].completer",
+      "[].creator"
+    ],
     "ListTodolistGroups": [
       "[].creator"
     ],
@@ -4162,6 +4379,11 @@
     "UpdateSubscription": [
       "subscribers.[]"
     ],
+    "UpdateSubtask": [
+      "assignees.[]",
+      "completer",
+      "creator"
+    ],
     "UpdateTimesheetEntry": [
       "creator",
       "person"

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

@@ -10,7 +10,9 @@ module Basecamp
       # Reposition a step within a card
       # @param card_id [Integer] card id ID
       # @param source_id [Integer] source id
-      # @param position [Integer] 0-indexed position
+      # @param position [Integer] The 1-based position to move it to (1 = top), the same `reposition_to`
+      #   a to-do uses. bc3's doc said "Zero indexed" until BC3 #12659 corrected
+      #   it; the server never was.
       # @return [void]
       def reposition(card_id:, source_id:, position:)
         with_operation(service: "cardsteps", operation: "reposition", is_mutation: true, resource_id: card_id) do

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

@@ -34,7 +34,8 @@ module Basecamp
       end
 
       # Mark specified items as read
-      # @param readables [Array] Array of readable_sgid values identifying the items to mark as read
+      # @param readables [Array] Array of readable_sgid values identifying the items to mark as read.
+      #   At most 500 per request.
       # @return [void]
       def mark_as_read(readables:)
         with_operation(service: "mynotifications", operation: "mark_as_read", is_mutation: true) do

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

@@ -52,7 +52,7 @@ module Basecamp
         end
       end
 
-      # Archive a recording
+      # Archive a recording; bc3 answers 403 for types it never lets be archived, timesheet entries among them
       # @param recording_id [Integer] recording id ID
       # @return [void]
       def archive(recording_id:)
@@ -62,7 +62,7 @@ module Basecamp
         end
       end
 
-      # Trash a recording
+      # Trash a recording; bc3 answers 403 for types it never lets be trashed, timesheet entries among them (DestroyTimesheetEntry removes those, permanently)
       # @param recording_id [Integer] recording id ID
       # @return [void]
       def trash(recording_id:)

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

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Basecamp
+  module Services
+    # Service for Subtasks operations
+    #
+    # @generated from OpenAPI spec
+    class SubtasksService < BaseService
+
+      # List a recording's subtasks, in position order
+      # @param recording_id [Integer] recording id 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: "subtasks", operation: "list", is_mutation: false, resource_id: recording_id) do
+          params = compact_query_params(page: page)
+          paginate("/recordings/#{recording_id}/subtasks.json", params: params, operation: "ListSubtasks", max_items: max_items)
+        end
+      end
+
+      # Create a subtask under a to-do or a card
+      # @param recording_id [Integer] recording id ID
+      # @param title [String] title
+      # @param due_on [String, nil] due on (YYYY-MM-DD)
+      # @param assignee_ids [Array, nil] assignee ids
+      # @return [Hash] response data
+      def create(recording_id:, title:, due_on: nil, assignee_ids: nil)
+        with_operation(service: "subtasks", operation: "create", is_mutation: true, resource_id: recording_id) do
+          http_post("/recordings/#{recording_id}/subtasks.json", body: compact_params(title: title, due_on: due_on, assignee_ids: assignee_ids)).json(operation: "CreateSubtask")
+        end
+      end
+
+      # Get a subtask by ID
+      # @param subtask_id [Integer] subtask id ID
+      # @return [Hash] response data
+      def get(subtask_id:)
+        with_operation(service: "subtasks", operation: "get", is_mutation: false, resource_id: subtask_id) do
+          http_get("/subtasks/#{subtask_id}", operation: "GetSubtask").json(operation: "GetSubtask")
+        end
+      end
+
+      # Update a subtask
+      # @param subtask_id [Integer] subtask id ID
+      # @param title [String, nil] title
+      # @param due_on [String, nil] due on (YYYY-MM-DD)
+      # @param assignee_ids [Array, nil] assignee ids
+      # @return [Hash] response data
+      def update(subtask_id:, title: nil, due_on: nil, assignee_ids: nil)
+        with_operation(service: "subtasks", operation: "update", is_mutation: true, resource_id: subtask_id) do
+          http_put("/subtasks/#{subtask_id}", body: compact_params(title: title, due_on: due_on, assignee_ids: assignee_ids)).json(operation: "UpdateSubtask")
+        end
+      end
+
+      # Delete a subtask
+      # @param subtask_id [Integer] subtask id ID
+      # @return [void]
+      def delete(subtask_id:)
+        with_operation(service: "subtasks", operation: "delete", is_mutation: true, resource_id: subtask_id) do
+          http_delete("/subtasks/#{subtask_id}")
+          nil
+        end
+      end
+
+      # Mark a subtask as completed
+      # @param subtask_id [Integer] subtask id ID
+      # @return [void]
+      def complete(subtask_id:)
+        with_operation(service: "subtasks", operation: "complete", is_mutation: true, resource_id: subtask_id) do
+          http_post("/subtasks/#{subtask_id}/completion.json")
+          nil
+        end
+      end
+
+      # Mark a subtask as not completed
+      # @param subtask_id [Integer] subtask id ID
+      # @return [void]
+      def uncomplete(subtask_id:)
+        with_operation(service: "subtasks", operation: "uncomplete", is_mutation: true, resource_id: subtask_id) do
+          http_delete("/subtasks/#{subtask_id}/completion.json")
+          nil
+        end
+      end
+
+      # Move a subtask to a new position among its siblings
+      # @param subtask_id [Integer] subtask id ID
+      # @param position [Integer] The 1-based position to move it to
+      # @return [void]
+      def reposition(subtask_id:, position:)
+        with_operation(service: "subtasks", operation: "reposition", is_mutation: true, resource_id: subtask_id) do
+          http_put("/subtasks/#{subtask_id}/position.json", body: compact_params(position: position))
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -7,22 +7,63 @@ module Basecamp
     # @generated from OpenAPI spec
     class TemplatesService < BaseService
 
-      # Get the account's to-do list template library
+      # Templatify a to-do list or card table
+      # @param bucket_id [Integer] bucket id ID
+      # @param recording_id [Integer] The to-do list or card table to templatify. Anything else is a 403.
+      # @param template_name [String, nil] What to call the template. Defaults to the source recording's own title.
+      # @param copy_comments [Boolean, nil] Carry the comments across.
+      # @param copy_assignments [Boolean, nil] Carry assignees and the people involved across, adding them to the library
+      #   if they are not already there.
+      # @param move_cards_to_triage [Boolean, nil] Gather the cards into Triage. Card tables only, and ignored otherwise.
       # @return [Hash] response data
-      def get_library()
-        with_operation(service: "templates", operation: "get_library", is_mutation: false) do
-          http_get("/template_library.json", operation: "GetTemplateLibrary").json(operation: "GetTemplateLibrary")
+      def create_templatification(bucket_id:, recording_id:, template_name: nil, copy_comments: nil, copy_assignments: nil, move_cards_to_triage: nil)
+        with_operation(service: "templates", operation: "create_templatification", is_mutation: true, project_id: bucket_id, resource_id: recording_id) do
+          http_post("/buckets/#{bucket_id}/recordings/#{recording_id}/templatifications.json", body: compact_params(template_name: template_name, copy_comments: copy_comments, copy_assignments: copy_assignments, move_cards_to_triage: move_cards_to_triage)).json(operation: "CreateTemplatification")
         end
       end
 
-      # Start copying a to-do list template into a project
-      # @param template_recording_id [Integer] template recording id
-      # @param destination_parent_id [Integer] destination parent id
+      # Get a templatification
+      # @param bucket_id [Integer] bucket id ID
+      # @param recording_id [Integer] recording id ID
+      # @param templatification_id [Integer] templatification id ID
+      # @return [Hash] response data
+      def get_templatification(bucket_id:, recording_id:, templatification_id:)
+        with_operation(service: "templates", operation: "get_templatification", is_mutation: false, project_id: bucket_id, resource_id: templatification_id) do
+          http_get("/buckets/#{bucket_id}/recordings/#{recording_id}/templatifications/#{templatification_id}", operation: "GetTemplatification").json(operation: "GetTemplatification")
+        end
+      end
+
+      # Get the account's card table templates
+      # @return [Hash] response data
+      def get_library_card_tables()
+        with_operation(service: "templates", operation: "get_library_card_tables", is_mutation: false) do
+          http_get("/template_library/card_tables.json", operation: "GetTemplateLibraryCardTables").json(operation: "GetTemplateLibraryCardTables")
+        end
+      end
+
+      # Create a card table template with the default columns
+      # @param name [String] The template's name. Write-only: the response carries it as `title`.
+      # @return [Hash] response data
+      def create_library_card_table(name:)
+        with_operation(service: "templates", operation: "create_library_card_table", is_mutation: true) do
+          http_post("/template_library/card_tables.json", body: compact_params(name: name)).json(operation: "CreateTemplateLibraryCardTable")
+        end
+      end
+
+      # Start copying a to-do list or card table template into a project
+      # @param template_recording_id [Integer] The to-do list or card table in the library to copy.
+      # @param destination_project_id [Integer, nil] The destination project. Basecamp resolves the container from the
+      #   template's kind, so a caller naming a project needs to know nothing about
+      #   docks or to-do sets. Supply this or destination_parent_id; if both are
+      #   sent, destination_parent_id wins.
+      # @param destination_parent_id [Integer, nil] The container to copy into, for a caller that already holds one: the
+      #   project's to-do set for a to-do list template, or its dock for a card
+      #   table. A caller who may not edit it gets 404, not 403.
       # @param adding_people_confirmed [Boolean, nil] Confirm granting destination-project access to people referenced by the template.
       # @return [Hash] response data
-      def create_library_copy(template_recording_id:, destination_parent_id:, adding_people_confirmed: nil)
+      def create_library_copy(template_recording_id:, destination_project_id: nil, destination_parent_id: nil, adding_people_confirmed: nil)
         with_operation(service: "templates", operation: "create_library_copy", is_mutation: true) do
-          http_post("/template_library/copies.json", body: compact_params(template_recording_id: template_recording_id, destination_parent_id: destination_parent_id, adding_people_confirmed: adding_people_confirmed)).json(operation: "CreateTemplateLibraryCopy")
+          http_post("/template_library/copies.json", body: compact_params(template_recording_id: template_recording_id, destination_project_id: destination_project_id, destination_parent_id: destination_parent_id, adding_people_confirmed: adding_people_confirmed)).json(operation: "CreateTemplateLibraryCopy")
         end
       end
 
@@ -35,6 +76,24 @@ module Basecamp
         end
       end
 
+      # Get the account's to-do list templates
+      # @return [Hash] response data
+      def get_library_todolists()
+        with_operation(service: "templates", operation: "get_library_todolists", is_mutation: false) do
+          http_get("/template_library/todolists.json", operation: "GetTemplateLibraryTodolists").json(operation: "GetTemplateLibraryTodolists")
+        end
+      end
+
+      # Create an empty to-do list template
+      # @param name [String] What to call the template.
+      # @param description [String, nil] Rich text describing the template.
+      # @return [Hash] response data
+      def create_library_todolist(name:, description: nil)
+        with_operation(service: "templates", operation: "create_library_todolist", is_mutation: true) do
+          http_post("/template_library/todolists.json", body: compact_params(name: name, description: description)).json(operation: "CreateTemplateLibraryTodolist")
+        end
+      end
+
       # List all templates visible to the current user
       # @param status [String, nil] active|archived|trashed
       # @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.

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

@@ -83,7 +83,7 @@ module Basecamp
         end
       end
 
-      # Permanently delete a timesheet entry; answers 403 when the caller may not archive or trash it.
+      # Permanently delete a timesheet entry, which never appears in the trash and cannot be restored; this is the only way to remove one, since bc3 answers 403 to TrashRecording and ArchiveRecording for every timesheet entry, and it answers 403 when the caller may not remove the entry.
       # @param entry_id [Integer] entry id ID
       # @return [void]
       def destroy(entry_id:)

data/lib/basecamp/generated/types.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Auto-generated from OpenAPI spec. Do not edit manually.
-# Generated: 2026-09-16T11:13:05Z
+# Generated: 2026-09-30T18:52:50Z
 
 require "json"
 require "time"
@@ -594,7 +594,7 @@ module Basecamp
     # Card
     class Card
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :description_attachments, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completed_at, :completer, :completion_subscribers, :completion_url, :content, :description, :due_on, :position, :steps, :subscription_url
+      attr_accessor :app_url, :bucket, :created_at, :creator, :description_attachments, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completed_at, :completer, :completion_subscribers, :completion_url, :content, :description, :due_on, :position, :steps, :subscription_url, :subtasks_completed_count, :subtasks_count, :subtasks_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -631,8 +631,11 @@ module Basecamp
         @description = data["description"]
         @due_on = data["due_on"]
         @position = parse_integer(data["position"])
-        @steps = parse_array(data["steps"], "CardStep")
+        @steps = parse_array(data["steps"], "Subtask")
         @subscription_url = data["subscription_url"]
+        @subtasks_completed_count = parse_integer(data["subtasks_completed_count"])
+        @subtasks_count = parse_integer(data["subtasks_count"])
+        @subtasks_url = data["subtasks_url"]
       end
 
       def to_h
@@ -668,6 +671,9 @@ module Basecamp
           "position" => @position,
           "steps" => @steps,
           "subscription_url" => @subscription_url,
+          "subtasks_completed_count" => @subtasks_completed_count,
+          "subtasks_count" => @subtasks_count,
+          "subtasks_url" => @subtasks_url,
         }.compact
       end
 
@@ -782,75 +788,10 @@ module Basecamp
       end
     end
 
-    # CardStep
-    class CardStep
-      include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :completed, :completed_at, :completer, :completion_url, :due_on, :position
-
-      # @return [Array<Symbol>]
-      def self.required_fields
-        %i[app_url bucket created_at creator id inherits_status parent status title type updated_at url visible_to_clients].freeze
-      end
-
-      def initialize(data = {})
-        @app_url = data["app_url"]
-        @bucket = parse_type(data["bucket"], "TodoBucket")
-        @created_at = parse_datetime(data["created_at"])
-        @creator = parse_type(data["creator"], "Person")
-        @id = parse_integer(data["id"])
-        @inherits_status = parse_boolean(data["inherits_status"])
-        @parent = parse_type(data["parent"], "RecordingParent")
-        @status = data["status"]
-        @title = data["title"]
-        @type = data["type"]
-        @updated_at = parse_datetime(data["updated_at"])
-        @url = data["url"]
-        @visible_to_clients = parse_boolean(data["visible_to_clients"])
-        @assignees = parse_array(data["assignees"], "Person")
-        @bookmark_url = data["bookmark_url"]
-        @completed = parse_boolean(data["completed"])
-        @completed_at = parse_datetime(data["completed_at"])
-        @completer = parse_type(data["completer"], "Person")
-        @completion_url = data["completion_url"]
-        @due_on = data["due_on"]
-        @position = parse_integer(data["position"])
-      end
-
-      def to_h
-        {
-          "app_url" => @app_url,
-          "bucket" => @bucket,
-          "created_at" => @created_at,
-          "creator" => @creator,
-          "id" => @id,
-          "inherits_status" => @inherits_status,
-          "parent" => @parent,
-          "status" => @status,
-          "title" => @title,
-          "type" => @type,
-          "updated_at" => @updated_at,
-          "url" => @url,
-          "visible_to_clients" => @visible_to_clients,
-          "assignees" => @assignees,
-          "bookmark_url" => @bookmark_url,
-          "completed" => @completed,
-          "completed_at" => @completed_at,
-          "completer" => @completer,
-          "completion_url" => @completion_url,
-          "due_on" => @due_on,
-          "position" => @position,
-        }.compact
-      end
-
-      def to_json(*args)
-        to_h.to_json(*args)
-      end
-    end
-
     # CardTable
     class CardTable
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :lists, :subscribers, :subscription_url, :wormholes
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :lists, :parent, :position, :public_link_url, :subscribers, :subscription_url, :wormholes
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -872,6 +813,9 @@ module Basecamp
         @visible_to_clients = parse_boolean(data["visible_to_clients"])
         @bookmark_url = data["bookmark_url"]
         @lists = parse_array(data["lists"], "CardColumn")
+        @parent = parse_type(data["parent"], "RecordingParent")
+        @position = parse_integer(data["position"])
+        @public_link_url = data["public_link_url"]
         @subscribers = parse_array(data["subscribers"], "Person")
         @subscription_url = data["subscription_url"]
         @wormholes = parse_array(data["wormholes"], "Wormhole")
@@ -893,6 +837,9 @@ module Basecamp
           "visible_to_clients" => @visible_to_clients,
           "bookmark_url" => @bookmark_url,
           "lists" => @lists,
+          "parent" => @parent,
+          "position" => @position,
+          "public_link_url" => @public_link_url,
           "subscribers" => @subscribers,
           "subscription_url" => @subscription_url,
           "wormholes" => @wormholes,
@@ -3819,7 +3766,7 @@ module Basecamp
     # Recording
     class Recording
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :boosts_count, :boosts_url, :bubble_up_url, :category, :comments_count, :comments_url, :content, :content_attachments, :description, :description_attachments, :from, :group_on, :parent, :position, :replies_count, :replies_url, :service, :subject, :subscription_url
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :status, :title, :type, :updated_at, :url, :visible_to_clients, :bookmark_url, :boosts_count, :boosts_url, :bubble_up_url, :category, :comments_count, :comments_url, :content, :content_attachments, :description, :description_attachments, :from, :group_on, :parent, :position, :replies_count, :replies_url, :service, :subject, :subscription_url, :subtasks_completed_count, :subtasks_count, :subtasks_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -3859,6 +3806,9 @@ module Basecamp
         @service = parse_type(data["service"], "DoorService")
         @subject = data["subject"]
         @subscription_url = data["subscription_url"]
+        @subtasks_completed_count = parse_integer(data["subtasks_completed_count"])
+        @subtasks_count = parse_integer(data["subtasks_count"])
+        @subtasks_url = data["subtasks_url"]
       end
 
       def to_h
@@ -3895,6 +3845,9 @@ module Basecamp
           "service" => @service,
           "subject" => @subject,
           "subscription_url" => @subscription_url,
+          "subtasks_completed_count" => @subtasks_completed_count,
+          "subtasks_count" => @subtasks_count,
+          "subtasks_url" => @subtasks_url,
         }.compact
       end
 
@@ -4462,6 +4415,71 @@ module Basecamp
       end
     end
 
+    # Subtask
+    class Subtask
+      include TypeHelpers
+      attr_accessor :app_url, :bucket, :created_at, :creator, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :completed, :completed_at, :completer, :completion_url, :due_on, :position
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url bucket created_at creator id inherits_status parent status title type updated_at url visible_to_clients].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @bucket = parse_type(data["bucket"], "TodoBucket")
+        @created_at = parse_datetime(data["created_at"])
+        @creator = parse_type(data["creator"], "Person")
+        @id = parse_integer(data["id"])
+        @inherits_status = parse_boolean(data["inherits_status"])
+        @parent = parse_type(data["parent"], "RecordingParent")
+        @status = data["status"]
+        @title = data["title"]
+        @type = data["type"]
+        @updated_at = parse_datetime(data["updated_at"])
+        @url = data["url"]
+        @visible_to_clients = parse_boolean(data["visible_to_clients"])
+        @assignees = parse_array(data["assignees"], "Person")
+        @bookmark_url = data["bookmark_url"]
+        @completed = parse_boolean(data["completed"])
+        @completed_at = parse_datetime(data["completed_at"])
+        @completer = parse_type(data["completer"], "Person")
+        @completion_url = data["completion_url"]
+        @due_on = data["due_on"]
+        @position = parse_integer(data["position"])
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "bucket" => @bucket,
+          "created_at" => @created_at,
+          "creator" => @creator,
+          "id" => @id,
+          "inherits_status" => @inherits_status,
+          "parent" => @parent,
+          "status" => @status,
+          "title" => @title,
+          "type" => @type,
+          "updated_at" => @updated_at,
+          "url" => @url,
+          "visible_to_clients" => @visible_to_clients,
+          "assignees" => @assignees,
+          "bookmark_url" => @bookmark_url,
+          "completed" => @completed,
+          "completed_at" => @completed_at,
+          "completer" => @completer,
+          "completion_url" => @completion_url,
+          "due_on" => @due_on,
+          "position" => @position,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Template
     class Template
       include TypeHelpers
@@ -4503,27 +4521,27 @@ module Basecamp
       end
     end
 
-    # TemplateLibrary
-    class TemplateLibrary
+    # TemplateLibraryCardTables
+    class TemplateLibraryCardTables
       include TypeHelpers
-      attr_accessor :bucket, :todolists, :todoset
+      attr_accessor :bucket, :card_tables, :kanban_boardset
 
       # @return [Array<Symbol>]
       def self.required_fields
-        %i[bucket todolists todoset].freeze
+        %i[bucket card_tables kanban_boardset].freeze
       end
 
       def initialize(data = {})
         @bucket = parse_type(data["bucket"], "RecordingBucket")
-        @todolists = parse_array(data["todolists"], "Todolist")
-        @todoset = parse_type(data["todoset"], "RecordingParent")
+        @card_tables = parse_array(data["card_tables"], "Recording")
+        @kanban_boardset = data["kanban_boardset"]
       end
 
       def to_h
         {
           "bucket" => @bucket,
-          "todolists" => @todolists,
-          "todoset" => @todoset,
+          "card_tables" => @card_tables,
+          "kanban_boardset" => @kanban_boardset,
         }.compact
       end
 
@@ -4564,7 +4582,7 @@ module Basecamp
     # TemplateLibraryCopy
     class TemplateLibraryCopy
       include TypeHelpers
-      attr_accessor :destination_parent_id, :id, :source_recording_id, :status, :url, :destination_todolist
+      attr_accessor :destination_parent_id, :id, :source_recording_id, :status, :url, :destination_card_table, :destination_todolist
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -4577,6 +4595,7 @@ module Basecamp
         @source_recording_id = parse_integer(data["source_recording_id"])
         @status = data["status"]
         @url = data["url"]
+        @destination_card_table = parse_type(data["destination_card_table"], "CardTable")
         @destination_todolist = parse_type(data["destination_todolist"], "Todolist")
       end
 
@@ -4587,6 +4606,71 @@ module Basecamp
           "source_recording_id" => @source_recording_id,
           "status" => @status,
           "url" => @url,
+          "destination_card_table" => @destination_card_table,
+          "destination_todolist" => @destination_todolist,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # TemplateLibraryTodolists
+    class TemplateLibraryTodolists
+      include TypeHelpers
+      attr_accessor :bucket, :todolists, :todoset
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[bucket todolists todoset].freeze
+      end
+
+      def initialize(data = {})
+        @bucket = parse_type(data["bucket"], "RecordingBucket")
+        @todolists = parse_array(data["todolists"], "Todolist")
+        @todoset = parse_type(data["todoset"], "RecordingParent")
+      end
+
+      def to_h
+        {
+          "bucket" => @bucket,
+          "todolists" => @todolists,
+          "todoset" => @todoset,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # Templatification
+    class Templatification
+      include TypeHelpers
+      attr_accessor :id, :source_recording_id, :status, :url, :destination_card_table, :destination_todolist
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[id source_recording_id status url].freeze
+      end
+
+      def initialize(data = {})
+        @id = parse_integer(data["id"])
+        @source_recording_id = parse_integer(data["source_recording_id"])
+        @status = data["status"]
+        @url = data["url"]
+        @destination_card_table = parse_type(data["destination_card_table"], "CardTable")
+        @destination_todolist = parse_type(data["destination_todolist"], "Todolist")
+      end
+
+      def to_h
+        {
+          "id" => @id,
+          "source_recording_id" => @source_recording_id,
+          "status" => @status,
+          "url" => @url,
+          "destination_card_table" => @destination_card_table,
           "destination_todolist" => @destination_todolist,
         }.compact
       end
@@ -4827,7 +4911,7 @@ module Basecamp
     # Todo
     class Todo
       include TypeHelpers
-      attr_accessor :app_url, :bucket, :content, :created_at, :creator, :description_attachments, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completion_subscribers, :completion_url, :description, :due_on, :position, :starts_on, :steps, :subscription_url
+      attr_accessor :app_url, :bucket, :content, :created_at, :creator, :description_attachments, :id, :inherits_status, :parent, :status, :title, :type, :updated_at, :url, :visible_to_clients, :assignees, :bookmark_url, :boosts_count, :boosts_url, :comments_count, :comments_url, :completed, :completion_subscribers, :completion_url, :description, :due_on, :position, :starts_on, :steps, :subscription_url, :subtasks_completed_count, :subtasks_count, :subtasks_url
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -4863,8 +4947,11 @@ module Basecamp
         @due_on = data["due_on"]
         @position = parse_integer(data["position"])
         @starts_on = data["starts_on"]
-        @steps = parse_array(data["steps"], "CardStep")
+        @steps = parse_array(data["steps"], "Subtask")
         @subscription_url = data["subscription_url"]
+        @subtasks_completed_count = parse_integer(data["subtasks_completed_count"])
+        @subtasks_count = parse_integer(data["subtasks_count"])
+        @subtasks_url = data["subtasks_url"]
       end
 
       def to_h
@@ -4899,6 +4986,9 @@ module Basecamp
           "starts_on" => @starts_on,
           "steps" => @steps,
           "subscription_url" => @subscription_url,
+          "subtasks_completed_count" => @subtasks_completed_count,
+          "subtasks_count" => @subtasks_count,
+          "subtasks_url" => @subtasks_url,
         }.compact
       end
 
@@ -5875,5 +5965,9 @@ module Basecamp
         to_h.to_json(*args)
       end
     end
+
+    # CardStep
+    # @deprecated renamed to Subtask, the same Kanban::Step record.
+    CardStep = Subtask
   end
 end

data/lib/basecamp/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Basecamp
-  VERSION = "0.20.0"
-  API_VERSION = "2026-09-02"
+  VERSION = "0.21.0"
+  API_VERSION = "2026-09-15"
 end

data/scripts/generate-services.rb

@@ -82,6 +82,7 @@ class ServiceGenerator
     'Projects' => 'Projects',
     'ClientFeatures' => 'ClientFeatures',
     'Boosts' => 'Boosts',
+    'Subtasks' => 'Subtasks',
     'Untagged' => 'Miscellaneous'
   }.freeze
 
@@ -214,7 +215,10 @@ class ServiceGenerator
     'Search' => 'search',
     'CreateProjectFromTemplate' => 'create_project',
     'GetProjectConstruction' => 'get_construction',
-    'GetTemplateLibrary' => 'get_library',
+    'GetTemplateLibraryTodolists' => 'get_library_todolists',
+    'GetTemplateLibraryCardTables' => 'get_library_card_tables',
+    'CreateTemplateLibraryCardTable' => 'create_library_card_table',
+    'CreateTemplateLibraryTodolist' => 'create_library_todolist',
     'CreateTemplateLibraryCopy' => 'create_library_copy',
     'GetTemplateLibraryCopy' => 'get_library_copy',
     'GetRecordingTimesheet' => 'for_recording',
@@ -358,7 +362,7 @@ class ServiceGenerator
     lineupmarker clientapproval clientapprovals clientcorrespondence
     clientcorrespondences clientreply clientreplies forwardreply
     forwardreplies campfireline campfirelines todolistgroup todolistgroups
-    todolistorgroup uploadversions hillchart hillcharts
+    todolistorgroup uploadversions hillchart hillcharts subtask subtasks
     wormhole wormholes
   ].freeze
 
@@ -791,7 +795,7 @@ class ServiceGenerator
     op[:path_params].each do |p|
       ruby_name = to_snake_case(p[:name])
       type = p[:type] || 'Integer'
-      desc = p[:description] || "#{ruby_name.gsub('_', ' ')} ID"
+      desc = yard_param_description(p[:description] || "#{ruby_name.gsub('_', ' ')} ID")
       lines << "      # @param #{ruby_name} [#{type}] #{desc}"
     end
 

data/scripts/generate-types.rb

@@ -132,6 +132,59 @@ def deprecation_doc_lines(reason, indent:, tag_prefix: '')
   out
 end
 
+# Whether the main loop emits a class for this component. The alias pass checks
+# its targets against exactly this predicate, so an alias can never name a
+# class that was not emitted (a *RequestContent target used to produce
+# `Alias = CreateCardStepRequestContent`, a NameError the moment types.rb loads).
+def emits_class?(name, schema)
+  return false if SKIP_PATTERNS.any? { |p| name.match?(p) }
+
+  schema.is_a?(Hash) && schema['type'] == 'object' && !(schema['properties'] || {}).empty?
+end
+
+DEPRECATED_ALIAS_KEYS = %w[$ref deprecated description x-deprecated-reason].freeze
+
+# A component that is nothing but a deprecated $ref: a rename kept for
+# compatibility, e.g. CardStep -> Subtask. `deprecated` must be the JSON boolean
+# true, as in every other generator; 1 or "false" is not an alias.
+def deprecated_alias?(schema)
+  schema.is_a?(Hash) && schema['deprecated'] == true && schema['$ref'].is_a?(String) &&
+    (schema.keys - DEPRECATED_ALIAS_KEYS).empty?
+end
+
+# Constants Basecamp::Types already holds besides the generated classes.
+RESERVED_TYPE_CONSTANTS = %w[TypeHelpers].freeze
+
+# Every deprecated alias as [alias, target], sorted by alias. Aborts on one this
+# generator cannot place, the same cases every SDK generator refuses: a missing
+# target, an alias of an alias (rejected, not resolved), a target that is not an
+# object model, a target this generator does not emit, and a name collision.
+def deprecated_aliases(schemas)
+  schemas.keys.sort.filter_map do |name|
+    schema = schemas[name]
+    next unless deprecated_alias?(schema)
+
+    target = schema['$ref'].split('/').last
+    target_schema = schemas[target]
+    problem =
+      if !schemas.key?(target)
+        'target schema does not exist'
+      elsif deprecated_alias?(target_schema)
+        "target is itself a deprecated alias; point #{name} at the model directly"
+      elsif !(target_schema.is_a?(Hash) && target_schema['type'] == 'object' &&
+              !(target_schema['properties'] || {}).empty?)
+        'target is not an object model'
+      elsif !emits_class?(target, target_schema)
+        'target class was not emitted (SKIP_PATTERNS excludes it)'
+      elsif RESERVED_TYPE_CONSTANTS.include?(name)
+        "#{name} collides with an existing constant in Basecamp::Types"
+      end
+    abort "Error: deprecated alias #{name} -> #{target}: #{problem}" if problem
+
+    [ name, target ]
+  end
+end
+
 # Main execution
 if __FILE__ == $PROGRAM_NAME
   openapi_path = ARGV[0] || File.expand_path('../../openapi.json', __dir__)
@@ -141,6 +194,13 @@ if __FILE__ == $PROGRAM_NAME
     exit 1
   end
 
+  # UTF-8 regardless of process locale — see generate-metadata.rb
+  schemas = JSON.parse(File.read(openapi_path, encoding: 'UTF-8'))['components']['schemas'] || {}
+  sorted = schemas.keys.sort
+  # Validated before the first line is printed, so a refusal leaves no partial
+  # types.rb on stdout.
+  aliases = deprecated_aliases(schemas)
+
   puts header
   puts generate_helpers
   puts ''
@@ -148,18 +208,11 @@ if __FILE__ == $PROGRAM_NAME
   puts '  module Types'
   puts '    include TypeHelpers'
 
-  # UTF-8 regardless of process locale — see generate-metadata.rb
-  schemas = JSON.parse(File.read(openapi_path, encoding: 'UTF-8'))['components']['schemas'] || {}
-  sorted = schemas.keys.sort
-
   sorted.each do |name|
-    next if SKIP_PATTERNS.any? { |p| name.match?(p) }
-
     schema = schemas[name]
-    next unless schema['type'] == 'object'
+    next unless emits_class?(name, schema)
 
-    properties = schema['properties'] || {}
-    next if properties.empty?
+    properties = schema['properties']
 
     required_fields = schema['required'] || []
     required_set = required_fields.to_set
@@ -273,6 +326,17 @@ if __FILE__ == $PROGRAM_NAME
     puts '    end'
   end
 
+  # Deprecated former names (see deprecated_aliases), emitted after every class
+  # because the alias must reference an already-defined constant. The alias
+  # also keeps Basecamp::Types.const_get("CardStep") resolving.
+  aliases.each do |name, target|
+    schema = schemas[name]
+    puts ''
+    puts "    # #{name}"
+    puts deprecation_doc_lines(schema['x-deprecated-reason'] || 'deprecated', indent: '    ')
+    puts "    #{name} = #{target}"
+  end
+
   puts '  end'
   puts 'end'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basecamp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-20 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -224,6 +224,7 @@ files:
 - lib/basecamp/generated/services/schedules_service.rb
 - lib/basecamp/generated/services/search_service.rb
 - lib/basecamp/generated/services/subscriptions_service.rb
+- lib/basecamp/generated/services/subtasks_service.rb
 - lib/basecamp/generated/services/templates_service.rb
 - lib/basecamp/generated/services/timeline_service.rb
 - lib/basecamp/generated/services/timesheets_service.rb