basecamp-sdk 0.29.1 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2620bd46c1b588d530b251109f21d2f87582d14fc9e4267c2fa79a28a8807dc4
-  data.tar.gz: f0dfcbeeacb7841d620fe75e2e41b7b293b31041c819a13cf9c6d10a4c4558eb
+  metadata.gz: ddaec5e8714ed7b9f89ba3eee0ffae9f2308b5459c356259d845b3d12337dfb1
+  data.tar.gz: '091928234df661ad893075b500d9501dcce44da5f68713a8e0161466fcf59a10'
 SHA512:
-  metadata.gz: adb8b91c0ef6d776e47bd9b2afe8109bbc9763d15eabbfc09c6fcba82a091b2513d722c923998cbcdbc8a052e3d5ec9e0e654b9dc76b6ca4595ca1049b9b41b9
-  data.tar.gz: 583fceab505a1ee471ba68e5baaa830b17bb1c6f75552c49550bf6126cc34f76ea5a02d32ee4cf3f493c454c1a8b8827182657e9119976eabb94ca0b4d0f7fb2
+  metadata.gz: 9e30f6a63f2d13cc14c8252efe1912451c0ee19a48b5c59d2c1299ee6527940474c0e0e4f3ea62c5f62a818d03aca0aa9cd2984247ac034522cc8231cc67f597
+  data.tar.gz: '0982175e0dd9119091454ee6b30be5c74c5fe276022220e8079a6d88fb73e81e411ceaf414181f612e4f39085dd914b269e4c1dea68374cd1aad3f05b1149180'

data/README.md

@@ -320,7 +320,7 @@ The SDK provides the full account-scoped service set documented in SPEC §5. The
 
 | Service | Description |
 |---------|-------------|
-| `projects` | Project management |
+| `projects` | Project management, [logo upload and removal](../PROJECT-LOGOS.md) |
 | `todos` | Todo items |
 | `todolists` | Todo lists |
 | `todosets` | Todo set containers |

data/lib/basecamp/generated/metadata.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://basecamp.com/schemas/sdk-metadata.json",
   "version": "1.0.0",
-  "generated": "2026-10-23T22:09:28Z",
+  "generated": "2026-10-27T18:50:42Z",
   "operations": {
     "GetAccount": {
       "retry": {
@@ -1203,6 +1203,17 @@
         "maxPageSize": 50
       }
     },
+    "GetFiling": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "GetEverythingForwards": {
       "retry": {
         "maxAttempts": 3,
@@ -1952,6 +1963,34 @@
         ]
       }
     },
+    "UpdateProjectLogo": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
+    "RemoveProjectLogo": {
+      "retry": {
+        "maxAttempts": 3,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      },
+      "idempotent": {
+        "natural": true
+      }
+    },
     "ListProjectPeople": {
       "retry": {
         "maxAttempts": 3,
@@ -2444,6 +2483,17 @@
         ]
       }
     },
+    "CopyRecording": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "ListEvents": {
       "retry": {
         "maxAttempts": 3,
@@ -2498,6 +2548,17 @@
         ]
       }
     },
+    "MoveRecording": {
+      "retry": {
+        "maxAttempts": 2,
+        "baseDelayMs": 1000,
+        "backoff": "exponential",
+        "retryOn": [
+          429,
+          503
+        ]
+      }
+    },
     "SpotlightRecording": {
       "retry": {
         "maxAttempts": 3,

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

@@ -71,6 +71,29 @@ module Basecamp
         end
       end
 
+      # Upload or replace the project's logo (returns 204 No Content).
+      # @param project_id [Integer] project id ID
+      # @param io [IO, String] File data to upload (IO object or string)
+      # @param filename [String] Display name for the uploaded file
+      # @param content_type [String] MIME type of the file (e.g., "image/png")
+      # @return [void]
+      def update_project_logo(project_id:, io:, filename:, content_type:)
+        with_operation(service: "projects", operation: "update_project_logo", is_mutation: true, project_id: project_id) do
+          http_put_multipart("/projects/#{project_id}/logo.json", io: io, filename: filename, content_type: content_type, field: "logo")
+          nil
+        end
+      end
+
+      # Remove the project's logo (returns 204 even when absent). Wallpaper is unchanged.
+      # @param project_id [Integer] project id ID
+      # @return [void]
+      def remove_project_logo(project_id:)
+        with_operation(service: "projects", operation: "remove_project_logo", is_mutation: true, project_id: project_id) do
+          http_delete("/projects/#{project_id}/logo.json")
+          nil
+        end
+      end
+
       # Record that the current user visited a project, moving it to the front of ListRecentProjects (returns 204 No Content).
       # @param project_id [Integer] project id ID
       # @return [void]

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

@@ -7,6 +7,15 @@ module Basecamp
     # @generated from OpenAPI spec
     class RecordingsService < BaseService
 
+      # Get the state of a move or copy started by MoveRecording or CopyRecording.
+      # @param filing_id [Integer] filing id ID
+      # @return [Hash] response data
+      def get_filing(filing_id:)
+        with_operation(service: "recordings", operation: "get_filing", is_mutation: false, resource_id: filing_id) do
+          http_get("/filings/#{filing_id}", operation: "GetFiling").json(operation: "GetFiling")
+        end
+      end
+
       # List recordings of a given type across projects
       # @param type [String] Comment|Document|Door|Kanban::Card|Kanban::Step|Message|Question::Answer|Schedule::Entry|Todo|Todolist|Upload|Vault
       # @param bucket [String, nil] bucket
@@ -23,6 +32,23 @@ module Basecamp
         end
       end
 
+      # Start copying a recording into another project; poll GetFiling for the result.
+      # @param recording_id [Integer] recording id ID
+      # @param filing_destination_id [Integer, nil] The container to copy into, from the destination project's dock: a card
+      #   table for a card, a message board for a message, a vault for a document,
+      #   upload or folder, a schedule for a schedule entry. Give this or
+      #   destination_project_id.
+      # @param destination_project_id [Integer, nil] The project to copy a dock tool to. Applies to tools only, and wins over
+      #   filing_destination_id when a request for a tool gives both.
+      # @param parent_id [Integer, nil] When copying into a vault, a folder inside it to put the copy in.
+      # @param include_comments [Boolean, nil] Copy the recording's comments too. Defaults to false.
+      # @return [Hash] response data
+      def copy(recording_id:, filing_destination_id: nil, destination_project_id: nil, parent_id: nil, include_comments: nil)
+        with_operation(service: "recordings", operation: "copy", is_mutation: true, resource_id: recording_id) do
+          http_post("/recordings/#{recording_id}/copies.json", body: compact_params(filing_destination_id: filing_destination_id, destination_project_id: destination_project_id, parent_id: parent_id, include_comments: include_comments)).json(operation: "CopyRecording")
+        end
+      end
+
       # Move a document, upload or vault into another vault in its project, or reorder it in its own vault.
       # @param recording_id [Integer] recording id ID
       # @param parent_id [Integer] The destination vault. The recording's current vault keeps it where it is
@@ -37,6 +63,22 @@ module Basecamp
         end
       end
 
+      # Start moving a recording into another project; poll GetFiling for the result.
+      # @param recording_id [Integer] recording id ID
+      # @param filing_destination_id [Integer, nil] The container to move into, from the destination project's dock: a card
+      #   table for a card, a message board for a message, a vault for a document,
+      #   upload or folder, a schedule for a schedule entry. Give this or
+      #   destination_project_id.
+      # @param destination_project_id [Integer, nil] The project to move a dock tool to. Applies to tools only, and wins over
+      #   filing_destination_id when a request for a tool gives both.
+      # @param parent_id [Integer, nil] When moving into a vault, a folder inside it to put the recording in.
+      # @return [Hash] response data
+      def move(recording_id:, filing_destination_id: nil, destination_project_id: nil, parent_id: nil)
+        with_operation(service: "recordings", operation: "move", is_mutation: true, resource_id: recording_id) do
+          http_post("/recordings/#{recording_id}/moves.json", body: compact_params(filing_destination_id: filing_destination_id, destination_project_id: destination_project_id, parent_id: parent_id)).json(operation: "MoveRecording")
+        end
+      end
+
       # Put a recording's card in the spotlight area on its project or template home page.
       # @param recording_id [Integer] recording id ID
       # @return [Hash] response data

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-10-23T22:09:29Z
+# Generated: 2026-10-27T18:50:42Z
 
 require "json"
 require "time"
@@ -1943,6 +1943,72 @@ module Basecamp
       end
     end
 
+    # Filing
+    class Filing
+      include TypeHelpers
+      attr_accessor :id, :source_recording_id, :status, :type, :url, :destination_recording
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[id source_recording_id status type url].freeze
+      end
+
+      def initialize(data = {})
+        @id = parse_integer(data["id"])
+        @source_recording_id = parse_integer(data["source_recording_id"])
+        @status = data["status"]
+        @type = data["type"]
+        @url = data["url"]
+        @destination_recording = parse_type(data["destination_recording"], "FilingDestinationRecording")
+      end
+
+      def to_h
+        {
+          "id" => @id,
+          "source_recording_id" => @source_recording_id,
+          "status" => @status,
+          "type" => @type,
+          "url" => @url,
+          "destination_recording" => @destination_recording,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
+    # FilingDestinationRecording
+    class FilingDestinationRecording
+      include TypeHelpers
+      attr_accessor :app_url, :id, :type, :url
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[app_url id type url].freeze
+      end
+
+      def initialize(data = {})
+        @app_url = data["app_url"]
+        @id = parse_integer(data["id"])
+        @type = data["type"]
+        @url = data["url"]
+      end
+
+      def to_h
+        {
+          "app_url" => @app_url,
+          "id" => @id,
+          "type" => @type,
+          "url" => @url,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # Folder
     class Folder
       include TypeHelpers
@@ -3420,7 +3486,7 @@ module Basecamp
       include TypeHelpers
       # @!attribute [rw] clientside
       #   @deprecated This shape is deprecated since 2024-01: Use Client Visibility feature instead
-      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :end_date, :purpose, :star_url, :starred, :start_date, :timesheet_enabled, :wallpaper
+      attr_accessor :app_url, :created_at, :id, :name, :status, :updated_at, :url, :bookmark_url, :bookmarked, :client_company, :clients_enabled, :clientside, :description, :dock, :end_date, :logo, :purpose, :star_url, :starred, :start_date, :timesheet_enabled, :wallpaper
 
       # @return [Array<Symbol>]
       def self.required_fields
@@ -3443,6 +3509,7 @@ module Basecamp
         @description = data["description"]
         @dock = parse_array(data["dock"], "DockItem")
         @end_date = data["end_date"]
+        @logo = parse_type(data["logo"], "ProjectLogo")
         @purpose = data["purpose"]
         @star_url = data["star_url"]
         @starred = parse_boolean(data["starred"])
@@ -3468,6 +3535,7 @@ module Basecamp
           "description" => @description,
           "dock" => @dock,
           "end_date" => @end_date,
+          "logo" => @logo,
           "purpose" => @purpose,
           "star_url" => @star_url,
           "starred" => @starred,
@@ -3589,6 +3657,31 @@ module Basecamp
       end
     end
 
+    # ProjectLogo
+    class ProjectLogo
+      include TypeHelpers
+      attr_accessor :url
+
+      # @return [Array<Symbol>]
+      def self.required_fields
+        %i[url].freeze
+      end
+
+      def initialize(data = {})
+        @url = data["url"]
+      end
+
+      def to_h
+        {
+          "url" => @url,
+        }.compact
+      end
+
+      def to_json(*args)
+        to_h.to_json(*args)
+      end
+    end
+
     # ProjectWallpaper
     class ProjectWallpaper
       include TypeHelpers

data/lib/basecamp/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Basecamp
-  VERSION = "0.29.1"
+  VERSION = "0.30.0"
   API_VERSION = "2026-10-19"
 end

data/scripts/generate-services.rb

@@ -182,6 +182,8 @@ class ServiceGenerator
     'SpotlightRecording' => 'spotlight',
     'UnspotlightRecording' => 'unspotlight',
     'MoveRecordingToVault' => 'move_to_vault',
+    'CopyRecording' => 'copy',
+    'GetFiling' => 'get_filing',
     'GetMyProfile' => 'my_profile',
     'GetTodolistOrGroup' => 'get',
     # The plain `update` name belongs to the merge-safe composite; the raw

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: basecamp-sdk
 version: !ruby/object:Gem::Version
-  version: 0.29.1
+  version: 0.30.0
 platform: ruby
 authors:
 - Basecamp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-26 00:00:00.000000000 Z
+date: 2026-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday