release: 4.8.0 (#74)

* feat(api): remove brand field from ElementalContent model

* chore(internal): remove mock server code

* chore: update mock server docs

* codegen metadata

* codegen metadata

* codegen metadata

* chore(internal): codegen related update

* chore(ci): add build step

* codegen metadata

* feat(api): add provider_key/device/tracking to token params, remove body_token

* chore(internal): codegen related update

* chore(ci): skip uploading artifacts on stainless-internal branches

* feat(api): add journeys resource with list and invoke methods

* fix: mark MessageDetails timestamp fields as optional

* codegen metadata

* release: 4.8.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,44 @@ on:
       - 'stl-preview-base/**'
 
 jobs:
+  build:
+    timeout-minutes: 10
+    name: build
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ${{ github.repository == 'stainless-sdks/courier-ruby' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: |-
+      github.repository == 'stainless-sdks/courier-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/courier-ruby' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
+        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/courier-ruby' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
+        env:
+          URL: https://pkg.stainless.com/s
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          PACKAGE_NAME: courier
+        run: ./scripts/utils/upload-artifact.sh
   lint:
     timeout-minutes: 10
     name: lint

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.7.1"
+  ".": "4.8.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 81
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-3fc1c86b4a83a16393aaf17d1fb3ac6098d30dd057ba872973b57285a7a3f0d0.yml
-openapi_spec_hash: 02a545d217b13399f311e99561f9de1d
-config_hash: 0789c3cddc625bb9712b3bded274ab6c
+configured_endpoints: 83
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-19330fca8fa9bbae835ec9d9f83b37b3df364d9b462090b9623bfc9b6eae99c2.yml
+openapi_spec_hash: 0bc6889464c9ac2542b4837f569c1837
+config_hash: 1ae49ed522c8423378d9463cdd0fb880

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 4.8.0 (2026-03-12)
+
+Full Changelog: [v4.7.1...v4.8.0](https://github.com/trycourier/courier-ruby/compare/v4.7.1...v4.8.0)
+
+### Features
+
+* **api:** add journeys resource with list and invoke methods ([26a80de](https://github.com/trycourier/courier-ruby/commit/26a80de1aa75c947f63e09da0ae7cb539947ecc4))
+* **api:** add provider_key/device/tracking to token params, remove body_token ([acb3031](https://github.com/trycourier/courier-ruby/commit/acb30313188a385e2ad39be4f4040e4e5836106d))
+* **api:** remove brand field from ElementalContent model ([519fcc0](https://github.com/trycourier/courier-ruby/commit/519fcc0a2f35a1fd61e64362b5a2e7b2d8225232))
+
+
+### Bug Fixes
+
+* mark MessageDetails timestamp fields as optional ([31a0be6](https://github.com/trycourier/courier-ruby/commit/31a0be63ee9969176a7bb3a627eabeb7c26d50f6))
+
+
+### Chores
+
+* **ci:** add build step ([d07ae3d](https://github.com/trycourier/courier-ruby/commit/d07ae3dc073f38ac30af1311f1d70153e441bf51))
+* **ci:** skip uploading artifacts on stainless-internal branches ([d4c0636](https://github.com/trycourier/courier-ruby/commit/d4c06361e5ef4e7c0a3a1660215d63fe845694c5))
+* **internal:** codegen related update ([3a0f51e](https://github.com/trycourier/courier-ruby/commit/3a0f51e6a03c33097f1307ac7974a3c5ca72ac90))
+* **internal:** codegen related update ([1cce4a8](https://github.com/trycourier/courier-ruby/commit/1cce4a8be23782aae7fb9185b8ac2efd06516842))
+* **internal:** remove mock server code ([a81351a](https://github.com/trycourier/courier-ruby/commit/a81351a2fde27b8a785a79436394a991e9048d97))
+* update mock server docs ([62d69fc](https://github.com/trycourier/courier-ruby/commit/62d69fc657babf8ff535e150d74a2283ddb64459))
+
+
+### Documentation
+
+* add AUTO-GENERATED-OVERVIEW markers for README sync ([#75](https://github.com/trycourier/courier-ruby/issues/75)) ([ab86102](https://github.com/trycourier/courier-ruby/commit/ab86102437d2af03dc45beae7262371c70b6847f))
+* sync README from mintlify-docs (2026-02-20 18:11 UTC) ([#76](https://github.com/trycourier/courier-ruby/issues/76)) ([cc67458](https://github.com/trycourier/courier-ruby/commit/cc6745816e152b890b84caaf666178bdbd9d3192))
+
 ## 4.7.1 (2026-02-07)
 
 Full Changelog: [v4.7.0...v4.7.1](https://github.com/trycourier/courier-ruby/compare/v4.7.0...v4.7.1)

CONTRIBUTING.md

@@ -66,12 +66,6 @@ $ bundle exec rake
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```bash
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```bash
 $ bundle exec rake test
 ```

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    trycourier (4.7.1)
+    trycourier (4.8.0)
       cgi
       connection_pool
 

lib/courier.rb

@@ -58,6 +58,7 @@
 require_relative "courier/models/base_check"
 require_relative "courier/models/subscription_topic_new"
 require_relative "courier/models/elemental_channel_node"
+require_relative "courier/models/journeys_invoke_request"
 require_relative "courier/models/message_details"
 require_relative "courier/models/base_template_tenant_association"
 require_relative "courier/models/post_tenant_template_publish_request"
@@ -138,6 +139,11 @@
 require_relative "courier/models/inbound_track_event_response"
 require_relative "courier/models/intercom"
 require_relative "courier/models/intercom_recipient"
+require_relative "courier/models/journey"
+require_relative "courier/models/journey_invoke_params"
+require_relative "courier/models/journey_list_params"
+require_relative "courier/models/journeys_invoke_response"
+require_relative "courier/models/journeys_list_response"
 require_relative "courier/models/list_delete_params"
 require_relative "courier/models/list_filter"
 require_relative "courier/models/list_list_params"
@@ -287,6 +293,7 @@
 require_relative "courier/resources/brands"
 require_relative "courier/resources/bulk"
 require_relative "courier/resources/inbound"
+require_relative "courier/resources/journeys"
 require_relative "courier/resources/lists"
 require_relative "courier/resources/lists/subscriptions"
 require_relative "courier/resources/messages"

lib/courier/client.rb

@@ -33,6 +33,9 @@ class Client < Courier::Internal::Transport::BaseClient
     # @return [Courier::Resources::Automations]
     attr_reader :automations
 
+    # @return [Courier::Resources::Journeys]
+    attr_reader :journeys
+
     # @return [Courier::Resources::Brands]
     attr_reader :brands
 
@@ -118,6 +121,7 @@ def initialize(
       @audit_events = Courier::Resources::AuditEvents.new(client: self)
       @auth = Courier::Resources::Auth.new(client: self)
       @automations = Courier::Resources::Automations.new(client: self)
+      @journeys = Courier::Resources::Journeys.new(client: self)
       @brands = Courier::Resources::Brands.new(client: self)
       @bulk = Courier::Resources::Bulk.new(client: self)
       @inbound = Courier::Resources::Inbound.new(client: self)

lib/courier/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).join(",")
+          else
+            collection[key] = element.to_s
+          end
+        end
+
         # @api private
         #
         # @param y [Enumerator::Yielder]

lib/courier/models.rb

@@ -179,6 +179,18 @@ module Courier
 
   IntercomRecipient = Courier::Models::IntercomRecipient
 
+  Journey = Courier::Models::Journey
+
+  JourneyInvokeParams = Courier::Models::JourneyInvokeParams
+
+  JourneyListParams = Courier::Models::JourneyListParams
+
+  JourneysInvokeRequest = Courier::Models::JourneysInvokeRequest
+
+  JourneysInvokeResponse = Courier::Models::JourneysInvokeResponse
+
+  JourneysListResponse = Courier::Models::JourneysListResponse
+
   ListDeleteParams = Courier::Models::ListDeleteParams
 
   ListFilter = Courier::Models::ListFilter