basecamp-sdk 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c53198686c7bf2b7f9fc25f60c14dec77dada2f3bbf7b6070f9a3e0639f7b529
-  data.tar.gz: f25233709c5a99476ed38728cf9ed005eb55e39457cc6dd4ea3250ac72583e60
+  metadata.gz: 7b16ed47ffa033dcc0c642c37ebc51a4bc6552fa06a088fd268cb451fa09e2f8
+  data.tar.gz: 48c691a48f55cc68f9d3d5208488c8baecb56264a230614a22e6b7746d8a7451
 SHA512:
-  metadata.gz: 3d17039b8cddadbbc8ee270f46f0f3e4665651091c0cd0371728693398002dfdc9def64bc081316c496ca477e43a1e2b4e55b65bc53a2d47124694989d5a0437
-  data.tar.gz: 9bf77edeae08a13c60d1f25f3e9d16ad9d39298dffa7cc430fa319aee4ecfa208d62c1c3ccec629473058ac9b48569faea8190b4373313923caa48556a1ab83a
+  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

@@ -516,11 +516,6 @@ module Basecamp
       service(:lineup) { Services::LineupService.new(self) }
     end
 
-    # @return [Services::AutomationService]
-    def automation
-      service(:automation) { Services::AutomationService.new(self) }
-    end
-
     # @return [Services::MessageTypesService]
     def message_types
       service(:message_types) { Services::MessageTypesService.new(self) }
@@ -612,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/lineup_service.rb

@@ -7,6 +7,14 @@ module Basecamp
     # @generated from OpenAPI spec
     class LineupService < BaseService
 
+      # List all lineup markers for the account
+      # @return [Array<Hash>] response data
+      def list_lineup_markers()
+        with_operation(service: "lineup", operation: "list_lineup_markers", is_mutation: false) do
+          http_get("/lineup/markers.json", operation: "ListLineupMarkers").json(operation: "ListLineupMarkers")
+        end
+      end
+
       # Create a new lineup marker
       # @param name [String] name
       # @param date [String] date

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:)