basecamp-sdk 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50a6f193dfed4631d675333812b23a9d586b5f78d2a060bbd15222855c93f62c
-  data.tar.gz: 2a9ce91aff3ae13f3262701feaa2d7706f100c1d217714896bfad94006563daf
+  metadata.gz: 06b1a1a19b501f386b63739724bb50b0f1d778660d2765f04d2c6a0d2214ef14
+  data.tar.gz: 3c2b5c8409d5a334eabb01b668e430510ad79b93cefc5ead3c5475f4b8f5d661
 SHA512:
-  metadata.gz: a594aada84cb34e591e3ec6747095d799626fb37763531c14c3d7a0fdc05360e61572e6e3e9748c405c73e4c603ca30c503b22b73c24273cfc13de84891a8f9b
-  data.tar.gz: 60a1d05afbe172cd92b4ee5c75871e57df33cb52f3f664e4c0dfa2823259f7ef5593cb32e022e41cc73ee30b255b214c16c4e2d1901ceef3f48eed6e11075f3b
+  metadata.gz: 0d9134c7b9996490c035fccc0c949acd1c05faff5c52b40aa5f30ab913456c10701a8742b74df33aea35539d197dd8c4932df3a1305d73db3efe2ac3de7bfa34
+  data.tar.gz: 3a4c47cb7196bd642f1c0863d25ff02fcf8ec607e102a6ce16cafe54aa5a74ef6290561c1897e365ff848e77911bdf8d7b3d31d85395adc4ba0b0753ba21d641

data/README.md

@@ -179,7 +179,7 @@ aborts before an oversized body is buffered.
 
 ## Services
 
-The SDK provides 37 services covering the complete Basecamp API:
+The SDK provides 45 account-scoped services. The table below covers the common ones; see `lib/basecamp/generated/services/` for the authoritative, complete set:
 
 | Service | Description |
 |---------|-------------|
@@ -210,6 +210,7 @@ The SDK provides 37 services covering the complete Basecamp API:
 | `card_tables` | Card tables (kanban) |
 | `card_columns` | Card table columns |
 | `card_steps` | Card workflow steps |
+| `wormholes` | Card table wormholes (cross-project moves) |
 | `lineup` | Card lineup view |
 | `tools` | Project dock tools |
 | `search` | Full-text search |

data/lib/basecamp/client.rb

@@ -431,6 +431,11 @@ module Basecamp
       service(:card_steps) { Services::CardStepsService.new(self) }
     end
 
+    # @return [Services::WormholesService]
+    def wormholes
+      service(:wormholes) { Services::WormholesService.new(self) }
+    end
+
     # @return [Services::TemplatesService]
     def templates
       service(:templates) { Services::TemplatesService.new(self) }
@@ -496,6 +501,11 @@ module Basecamp
       service(:timeline) { Services::TimelineService.new(self) }
     end
 
+    # @return [Services::EverythingService]
+    def everything
+      service(:everything) { Services::EverythingService.new(self) }
+    end
+
     # @return [Services::TimesheetsService]
     def timesheets
       service(:timesheets) { Services::TimesheetsService.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-07-22T08:33:01Z",
+  "generated": "2026-07-28T21:34:14Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -67,6 +67,22 @@
         ]
       }
     },
+    "GetEverythingBoosts": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "GetBoost": {
       "retry": {
         "maxAttempts": 3,
@@ -131,6 +147,111 @@
         "natural": true
       }
     },
+    "UpdateWormhole": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteWormhole": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "CreateWormhole": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "ListMessageTypes": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "CreateMessageType": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetMessageType": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "UpdateMessageType": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "DeleteMessageType": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "CreateTool": {
       "retry": {
         "maxAttempts": 2,
@@ -379,7 +500,7 @@
         ]
       }
     },
-    "ListMessageTypes": {
+    "GetEverythingCompletedCards": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -392,21 +513,26 @@
       "pagination": {
         "style": "link",
         "totalCountHeader": "X-Total-Count",
-        "maxPageSize": 50
+        "maxPageSize": 5
       }
     },
-    "CreateMessageType": {
+    "GetEverythingNoDueDateCards": {
       "retry": {
-        "maxAttempts": 2,
+        "maxAttempts": 3,
         "baseDelayMs": 1000,
         "backoff": "exponential",
         "retryOn": [
           429,
           503
         ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
       }
     },
-    "GetMessageType": {
+    "GetEverythingNotNowCards": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -415,9 +541,14 @@
           429,
           503
         ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
       }
     },
-    "UpdateMessageType": {
+    "GetEverythingOpenCards": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -427,11 +558,24 @@
           503
         ]
       },
-      "idempotent": {
-        "natural": true
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
       }
     },
-    "DeleteMessageType": {
+    "GetEverythingOverdueCards": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetEverythingUnassignedCards": {
       "retry": {
         "maxAttempts": 3,
         "baseDelayMs": 1000,
@@ -441,8 +585,10 @@
           503
         ]
       },
-      "idempotent": {
-        "natural": true
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
       }
     },
     "ListCampfires": {
@@ -631,6 +777,22 @@
         ]
       }
     },
+    "GetEverythingCheckins": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "ListPingablePeople": {
       "retry": {
         "maxAttempts": 3,
@@ -728,6 +890,22 @@
         ]
       }
     },
+    "GetEverythingComments": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "GetComment": {
       "retry": {
         "maxAttempts": 3,
@@ -817,6 +995,38 @@
         "natural": true
       }
     },
+    "GetEverythingFiles": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
+    "GetEverythingForwards": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "GetGaugeNeedle": {
       "retry": {
         "maxAttempts": 3,
@@ -1020,6 +1230,22 @@
         ]
       }
     },
+    "GetEverythingMessages": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "GetMessage": {
       "retry": {
         "maxAttempts": 3,
@@ -1154,6 +1380,22 @@
         ]
       }
     },
+    "GetBubbleUps": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 50
+      }
+    },
     "MarkAsRead": {
       "retry": {
         "maxAttempts": 2,
@@ -2332,6 +2574,81 @@
         ]
       }
     },
+    "GetEverythingCompletedTodos": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
+      }
+    },
+    "GetEverythingNoDueDateTodos": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
+      }
+    },
+    "GetEverythingOpenTodos": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
+      }
+    },
+    "GetEverythingOverdueTodos": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
+    "GetEverythingUnassignedTodos": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "pagination": {
+        "style": "link",
+        "totalCountHeader": "X-Total-Count",
+        "maxPageSize": 5
+      }
+    },
     "GetTodo": {
       "retry": {
         "maxAttempts": 3,
@@ -2413,6 +2730,20 @@
         "natural": true
       }
     },
+    "RepositionTodolist": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "GetTodoset": {
       "retry": {
         "maxAttempts": 3,

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

@@ -8,7 +8,7 @@ module Basecamp
     class AutomationService < BaseService
 
       # List all lineup markers for the account
-      # @return [Hash] response data
+      # @return [Array<Hash>] response data
       def list_lineup_markers()
         with_operation(service: "automation", operation: "list_lineup_markers", is_mutation: false) do
           http_get("/lineup/markers.json").json

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

@@ -141,6 +141,19 @@ module Basecamp
         kwargs.compact
       end
 
+      # Like compact_params, but also drops empty arrays. For query filters an
+      # empty array means "no filter" and must be omitted entirely: Faraday's
+      # nested encoder would otherwise emit a bare `bucket_ids[]`, which Rails
+      # normalizes into a bogus `[0]` filter instead of the unfiltered request
+      # the caller intended. Not used for request bodies, where an explicit
+      # empty array (e.g. clearing a list) can be meaningful.
+      #
+      # @param hash [Hash] the input hash
+      # @return [Hash] hash with nil values and empty arrays removed
+      def compact_query_params(**kwargs)
+        kwargs.reject { |_, value| value.nil? || value == [] }
+      end
+
       # Build a bucket (project) path.
       # @param project_id [Integer, String] the project/bucket ID
       # @param path [String] the path suffix

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

@@ -86,7 +86,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_lines(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_lines", is_mutation: false, resource_id: campfire_id) do
-          params = compact_params(sort: sort, direction: direction)
+          params = compact_query_params(sort: sort, direction: direction)
           paginate("/chats/#{campfire_id}/lines.json", params: params)
         end
       end
@@ -142,7 +142,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list_uploads(campfire_id:, sort: nil, direction: nil)
         wrap_paginated(service: "campfires", operation: "list_uploads", is_mutation: false, resource_id: campfire_id) do
-          params = compact_params(sort: sort, direction: direction)
+          params = compact_query_params(sort: sort, direction: direction)
           paginate("/chats/#{campfire_id}/uploads.json", params: params)
         end
       end

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

@@ -13,7 +13,7 @@ module Basecamp
       # @param color [String] Valid colors: white, red, orange, yellow, green, blue, aqua, purple, gray, pink, brown
       # @return [Hash] response data
       def set_color(bucket_id:, column_id:, color:)
-        with_operation(service: "cardcolumns", operation: "set_color", is_mutation: true, resource_id: column_id) do
+        with_operation(service: "cardcolumns", operation: "set_color", is_mutation: true, project_id: bucket_id, resource_id: column_id) do
           http_put("/buckets/#{bucket_id}/card_tables/columns/#{column_id}/color.json", body: compact_params(color: color)).json
         end
       end
@@ -23,7 +23,7 @@ module Basecamp
       # @param column_id [Integer] column id ID
       # @return [Hash] response data
       def enable_on_hold(bucket_id:, column_id:)
-        with_operation(service: "cardcolumns", operation: "enable_on_hold", is_mutation: true, resource_id: column_id) do
+        with_operation(service: "cardcolumns", operation: "enable_on_hold", is_mutation: true, project_id: bucket_id, resource_id: column_id) do
           http_post("/buckets/#{bucket_id}/card_tables/columns/#{column_id}/on_hold.json").json
         end
       end
@@ -33,7 +33,7 @@ module Basecamp
       # @param column_id [Integer] column id ID
       # @return [Hash] response data
       def disable_on_hold(bucket_id:, column_id:)
-        with_operation(service: "cardcolumns", operation: "disable_on_hold", is_mutation: true, resource_id: column_id) do
+        with_operation(service: "cardcolumns", operation: "disable_on_hold", is_mutation: true, project_id: bucket_id, resource_id: column_id) do
           http_delete("/buckets/#{bucket_id}/card_tables/columns/#{column_id}/on_hold.json").json
         end
       end

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

@@ -23,8 +23,8 @@ module Basecamp
       # @param due_on [String, nil] due on (YYYY-MM-DD)
       # @param assignee_ids [Array, nil] assignee ids
       # @return [Hash] response data
-      def update(card_id:, title: nil, content: nil, due_on: nil, assignee_ids: nil)
-        with_operation(service: "cards", operation: "update", is_mutation: true, resource_id: card_id) do
+      def update_verbatim(card_id:, title: nil, content: nil, due_on: nil, assignee_ids: nil)
+        with_operation(service: "cards", operation: "update_verbatim", is_mutation: true, resource_id: card_id) do
           http_put("/card_tables/cards/#{card_id}", body: compact_params(title: title, content: content, due_on: due_on, assignee_ids: assignee_ids)).json
         end
       end

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

@@ -57,11 +57,12 @@ module Basecamp
       # Create a new question in a questionnaire
       # @param questionnaire_id [Integer] questionnaire id ID
       # @param title [String] title
-      # @param schedule [String] schedule
+      # @param schedule [Hash] schedule
+      # @param visible_to_clients [Boolean, nil] visible to clients
       # @return [Hash] response data
-      def create_question(questionnaire_id:, title:, schedule:)
+      def create_question(questionnaire_id:, title:, schedule:, visible_to_clients: nil)
         with_operation(service: "checkins", operation: "create_question", is_mutation: true, resource_id: questionnaire_id) do
-          http_post("/questionnaires/#{questionnaire_id}/questions.json", body: compact_params(title: title, schedule: schedule)).json
+          http_post("/questionnaires/#{questionnaire_id}/questions.json", body: compact_params(title: title, schedule: schedule, visible_to_clients: visible_to_clients)).json
         end
       end
 
@@ -77,7 +78,7 @@ module Basecamp
       # Update an existing question
       # @param question_id [Integer] question id ID
       # @param title [String, nil] title
-      # @param schedule [String, nil] schedule
+      # @param schedule [Hash, nil] schedule
       # @param paused [Boolean, nil] paused
       # @return [Hash] response data
       def update_question(question_id:, title: nil, schedule: nil, paused: nil)

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

@@ -13,7 +13,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientapprovals", operation: "list", is_mutation: false) do
-          params = compact_params(sort: sort, direction: direction)
+          params = compact_query_params(sort: sort, direction: direction)
           paginate("/client/approvals.json", params: params)
         end
       end

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

@@ -13,7 +13,7 @@ module Basecamp
       # @return [Enumerator<Hash>] paginated results
       def list(sort: nil, direction: nil)
         wrap_paginated(service: "clientcorrespondences", operation: "list", is_mutation: false) do
-          params = compact_params(sort: sort, direction: direction)
+          params = compact_query_params(sort: sort, direction: direction)
           paginate("/client/correspondences.json", params: params)
         end
       end

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

@@ -42,10 +42,11 @@ module Basecamp
       # @param content [String, nil] content
       # @param status [String, nil] active|drafted
       # @param subscriptions [Array, nil] subscriptions
+      # @param visible_to_clients [Boolean, nil] visible to clients
       # @return [Hash] response data
-      def create(vault_id:, title:, content: nil, status: nil, subscriptions: nil)
+      def create(vault_id:, title:, content: nil, status: nil, subscriptions: nil, visible_to_clients: nil)
         with_operation(service: "documents", operation: "create", is_mutation: true, resource_id: vault_id) do
-          http_post("/vaults/#{vault_id}/documents.json", body: compact_params(title: title, content: content, status: status, subscriptions: subscriptions)).json
+          http_post("/vaults/#{vault_id}/documents.json", body: compact_params(title: title, content: content, status: status, subscriptions: subscriptions, visible_to_clients: visible_to_clients)).json
         end
       end
     end