release: 1.33.0 (#71)

* fix(client): serialize query parameters properly

* chore(docs): add missing descriptions

* codegen metadata

* feat(api): api update

* feat(api): api update

* chore(ci): add build step

* release: 1.33.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -13,6 +13,40 @@ on:
       - 'stl-preview-base/**'
 
 jobs:
+  build:
+    timeout-minutes: 10
+    name: build
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ${{ github.repository == 'stainless-sdks/knock-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: |-
+      github.repository == 'stainless-sdks/knock-ruby' &&
+      (github.event_name == 'push' || github.event.pull_request.head.repo.fork)
+    steps:
+      - uses: actions/checkout@v6
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: false
+      - run: |-
+          bundle install
+
+      - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/knock-ruby'
+        id: github-oidc
+        uses: actions/github-script@v8
+        with:
+          script: core.setOutput('github_token', await core.getIDToken());
+
+      - name: Build and upload gem artifacts
+        if: github.repository == 'stainless-sdks/knock-ruby'
+        env:
+          URL: https://pkg.stainless.com/s
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          PACKAGE_NAME: knockapi
+        run: ./scripts/utils/upload-artifact.sh
   lint:
     timeout-minutes: 10
     name: lint

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.32.1"
+  ".": "1.33.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 90
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/knock%2Fknock-b0b2bad50557aa0fe95d42cd97c6b45e8c45f6f257950048545faafafc851a17.yml
-openapi_spec_hash: 4e26fcff8efa06e31f3b2bfc191a7006
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/knock%2Fknock-eaaacf2abf99e5ee2fd681d70e02e9d0bbc7a0216d25cf4f10bae75c5fb59df5.yml
+openapi_spec_hash: 51a8f39a76a1bcd85d29a0949d6c353a
 config_hash: 32503026a45db991d0d102f25af40a77

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 1.33.0 (2026-03-03)
+
+Full Changelog: [v1.32.1...v1.33.0](https://github.com/knocklabs/knock-ruby/compare/v1.32.1...v1.33.0)
+
+### Features
+
+* **api:** api update ([7ba6675](https://github.com/knocklabs/knock-ruby/commit/7ba667550ffe7a071924b835e6f7bbb735dc93ad))
+* **api:** api update ([9a5227f](https://github.com/knocklabs/knock-ruby/commit/9a5227feaac4df242717be5e3704e4e327783250))
+
+
+### Bug Fixes
+
+* **client:** serialize query parameters properly ([0a76966](https://github.com/knocklabs/knock-ruby/commit/0a7696661973ba7e4f461be1bda646a3654a955a))
+
+
+### Chores
+
+* **ci:** add build step ([979140d](https://github.com/knocklabs/knock-ruby/commit/979140db56dabc14ead8dd64cee25c12c38f8c40))
+* **docs:** add missing descriptions ([d1d2610](https://github.com/knocklabs/knock-ruby/commit/d1d26104b361735f37a9739d676e350d088f27b8))
+
 ## 1.32.1 (2026-02-26)
 
 Full Changelog: [v1.32.0...v1.32.1](https://github.com/knocklabs/knock-ruby/compare/v1.32.0...v1.32.1)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    knockapi (1.32.1)
+    knockapi (1.33.0)
       cgi
       connection_pool
 

README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "knockapi", "~> 1.32.1"
+gem "knockapi", "~> 1.33.0"
 ```
 
 <!-- x-release-please-end -->

lib/knockapi/client.rb

@@ -25,18 +25,26 @@ class Client < Knockapi::Internal::Transport::BaseClient
     # @return [Knockapi::Resources::Recipients]
     attr_reader :recipients
 
+    # A user is an individual from your system, represented in Knock. They are most
+    # commonly a recipient of a notification.
     # @return [Knockapi::Resources::Users]
     attr_reader :users
 
+    # An object represents a resource in your system that you want to map into Knock.
     # @return [Knockapi::Resources::Objects]
     attr_reader :objects
 
+    # A tenant represents a top-level entity from your system, like a company,
+    # organization, account, or workspace.
     # @return [Knockapi::Resources::Tenants]
     attr_reader :tenants
 
+    # A bulk operation is a set of changes applied across zero or more records
+    # triggered via a call to the Knock API and performed asynchronously.
     # @return [Knockapi::Resources::BulkOperations]
     attr_reader :bulk_operations
 
+    # A message sent to a single recipient on a channel.
     # @return [Knockapi::Resources::Messages]
     attr_reader :messages
 
@@ -46,15 +54,20 @@ class Client < Knockapi::Internal::Transport::BaseClient
     # @return [Knockapi::Resources::Integrations]
     attr_reader :integrations
 
+    # A workflow is a structured set of steps that is triggered to produce
+    # notifications sent over channels.
     # @return [Knockapi::Resources::Workflows]
     attr_reader :workflows
 
+    # A schedule is a per-recipient, timezone-aware configuration for when to invoke a
+    # workflow.
     # @return [Knockapi::Resources::Schedules]
     attr_reader :schedules
 
     # @return [Knockapi::Resources::Channels]
     attr_reader :channels
 
+    # An Audience is a segment of users.
     # @return [Knockapi::Resources::Audiences]
     attr_reader :audiences
 

lib/knockapi/internal/util.rb

@@ -490,6 +490,37 @@ def writable_enum(&blk)
       JSONL_CONTENT = %r{^application/(:?x-(?:n|l)djson)|(:?(?:x-)?jsonl)}
 
       class << self
+        # @api private
+        #
+        # @param query [Hash{Symbol=>Object}]
+        #
+        # @return [Hash{Symbol=>Object}]
+        def encode_query_params(query)
+          out = {}
+          query.each { write_query_param_element!(out, _1, _2) }
+          out
+        end
+
+        # @api private
+        #
+        # @param collection [Hash{Symbol=>Object}]
+        # @param key [String]
+        # @param element [Object]
+        #
+        # @return [nil]
+        private def write_query_param_element!(collection, key, element)
+          case element
+          in Hash
+            element.each do |name, value|
+              write_query_param_element!(collection, "#{key}[#{name}]", value)
+            end
+          in Array
+            collection["#{key}[]"] = element.map(&:to_s)
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]

lib/knockapi/resources/audiences.rb

@@ -2,6 +2,7 @@
 
 module Knockapi
   module Resources
+    # An Audience is a segment of users.
     class Audiences
       # Some parameter documentations has been truncated, see
       # {Knockapi::Models::AudienceAddMembersParams} for more details.
@@ -22,12 +23,13 @@ class Audiences
       #
       # @see Knockapi::Models::AudienceAddMembersParams
       def add_members(key, params)
-        parsed, options = Knockapi::AudienceAddMembersParams.dump_request(params)
         query_params = [:create_audience]
+        parsed, options = Knockapi::AudienceAddMembersParams.dump_request(params)
+        query = Knockapi::Internal::Util.encode_query_params(parsed.slice(*query_params))
         @client.request(
           method: :post,
           path: ["v1/audiences/%1$s/members", key],
-          query: parsed.slice(*query_params),
+          query: query,
           body: parsed.except(*query_params),
           model: NilClass,
           options: options

lib/knockapi/resources/bulk_operations.rb

@@ -2,6 +2,8 @@
 
 module Knockapi
   module Resources
+    # A bulk operation is a set of changes applied across zero or more records
+    # triggered via a call to the Knock API and performed asynchronously.
     class BulkOperations
       # Retrieves a bulk operation (if it exists) and displays the current state of it.
       #