trycourier · mikemilla · Jun 26, 2026 · Jun 25, 2026 · Jun 25, 2026 · Jun 25, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.18.1"
+  ".": "4.18.2"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 134
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-43eec5d4d385a6c770298238ca0e4f708c8ff9fffe5e219ff5d78c6cdfe41fce.yml
-openapi_spec_hash: a3e0abc4d8caed45f43ee83d50e5cb95
-config_hash: 83c79a6ad0a0b5dcce3b85208026343b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-97bb4b698571b6dbe884e93397d14aff0ec7e7279de272a15fa0defb3b2515d5.yml
+openapi_spec_hash: c33bf8733151f4f5693788b6e57a8344
+config_hash: 74aad10d1512ec69541ece3ca51cf7fa
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Changelog
 
+## 4.18.2 (2026-06-25)
+
+Full Changelog: [v4.18.1...v4.18.2](https://github.com/trycourier/courier-java/compare/v4.18.1...v4.18.2)
+
+### Documentation
+
+* **openapi:** add full response examples to every endpoint ([210ab8c](https://github.com/trycourier/courier-java/commit/210ab8c3f739ba985d644c099a910d491c4302f9))
+* **openapi:** reword Cancel Submission description ([8be16f8](https://github.com/trycourier/courier-java/commit/8be16f8740cc317d81f7a5ca3b3debaf746b073e))
+* **openapi:** reword Get Submission Checks description ([95daf0b](https://github.com/trycourier/courier-java/commit/95daf0b3f98a989a1c2c7cfc3b88c994936decb8))
+* **openapi:** reword Replace Submission Checks description ([878a8a7](https://github.com/trycourier/courier-java/commit/878a8a7cb71be98ed4490cfad61d4e611467dbfb))
+
 ## 4.18.1 (2026-06-24)
 
 Full Changelog: [v4.18.0...v4.18.1](https://github.com/trycourier/courier-java/compare/v4.18.0...v4.18.1)

diff --git a/build.gradle.kts b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.courier"
-    version = "4.18.1" // x-release-please-version
+    version = "4.18.2" // x-release-please-version
 }
 
 subprojects {

diff --git a/courier-java-core/src/main/kotlin/com/courier/client/CourierClient.kt b/courier-java-core/src/main/kotlin/com/courier/client/CourierClient.kt
@@ -15,7 +15,6 @@ import com.courier.services.blocking.JourneyService
 import com.courier.services.blocking.ListService
 import com.courier.services.blocking.MessageService
 import com.courier.services.blocking.NotificationService
-import com.courier.services.blocking.PreferenceSectionService
 import com.courier.services.blocking.ProfileService
 import com.courier.services.blocking.ProviderService
 import com.courier.services.blocking.RequestService
@@ -24,6 +23,7 @@ import com.courier.services.blocking.SendService
 import com.courier.services.blocking.TenantService
 import com.courier.services.blocking.TranslationService
 import com.courier.services.blocking.UserService
+import com.courier.services.blocking.WorkspacePreferenceService
 import java.util.function.Consumer
 
 /**
@@ -94,7 +94,7 @@ interface CourierClient {
 
     fun routingStrategies(): RoutingStrategyService
 
-    fun preferenceSections(): PreferenceSectionService
+    fun workspacePreferences(): WorkspacePreferenceService
 
     fun profiles(): ProfileService
 
@@ -159,7 +159,7 @@ interface CourierClient {
 
         fun routingStrategies(): RoutingStrategyService.WithRawResponse
 
-        fun preferenceSections(): PreferenceSectionService.WithRawResponse
+        fun workspacePreferences(): WorkspacePreferenceService.WithRawResponse
 
         fun profiles(): ProfileService.WithRawResponse
 

diff --git a/courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsync.kt b/courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsync.kt
@@ -15,7 +15,6 @@ import com.courier.services.async.JourneyServiceAsync
 import com.courier.services.async.ListServiceAsync
 import com.courier.services.async.MessageServiceAsync
 import com.courier.services.async.NotificationServiceAsync
-import com.courier.services.async.PreferenceSectionServiceAsync
 import com.courier.services.async.ProfileServiceAsync
 import com.courier.services.async.ProviderServiceAsync
 import com.courier.services.async.RequestServiceAsync
@@ -24,6 +23,7 @@ import com.courier.services.async.SendServiceAsync
 import com.courier.services.async.TenantServiceAsync
 import com.courier.services.async.TranslationServiceAsync
 import com.courier.services.async.UserServiceAsync
+import com.courier.services.async.WorkspacePreferenceServiceAsync
 import java.util.function.Consumer
 
 /**
@@ -94,7 +94,7 @@ interface CourierClientAsync {
 
     fun routingStrategies(): RoutingStrategyServiceAsync
 
-    fun preferenceSections(): PreferenceSectionServiceAsync
+    fun workspacePreferences(): WorkspacePreferenceServiceAsync
 
     fun profiles(): ProfileServiceAsync
 
@@ -163,7 +163,7 @@ interface CourierClientAsync {
 
         fun routingStrategies(): RoutingStrategyServiceAsync.WithRawResponse
 
-        fun preferenceSections(): PreferenceSectionServiceAsync.WithRawResponse
+        fun workspacePreferences(): WorkspacePreferenceServiceAsync.WithRawResponse
 
         fun profiles(): ProfileServiceAsync.WithRawResponse
 

diff --git a/courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsyncImpl.kt b/courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsyncImpl.kt
@@ -28,8 +28,6 @@ import com.courier.services.async.MessageServiceAsync
 import com.courier.services.async.MessageServiceAsyncImpl
 import com.courier.services.async.NotificationServiceAsync
 import com.courier.services.async.NotificationServiceAsyncImpl
-import com.courier.services.async.PreferenceSectionServiceAsync
-import com.courier.services.async.PreferenceSectionServiceAsyncImpl
 import com.courier.services.async.ProfileServiceAsync
 import com.courier.services.async.ProfileServiceAsyncImpl
 import com.courier.services.async.ProviderServiceAsync
@@ -46,6 +44,8 @@ import com.courier.services.async.TranslationServiceAsync
 import com.courier.services.async.TranslationServiceAsyncImpl
 import com.courier.services.async.UserServiceAsync
 import com.courier.services.async.UserServiceAsyncImpl
+import com.courier.services.async.WorkspacePreferenceServiceAsync
+import com.courier.services.async.WorkspacePreferenceServiceAsyncImpl
 import java.util.function.Consumer
 
 class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : CourierClientAsync {
@@ -121,8 +121,8 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
         RoutingStrategyServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
-    private val preferenceSections: PreferenceSectionServiceAsync by lazy {
-        PreferenceSectionServiceAsyncImpl(clientOptionsWithUserAgent)
+    private val workspacePreferences: WorkspacePreferenceServiceAsync by lazy {
+        WorkspacePreferenceServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
     private val profiles: ProfileServiceAsync by lazy {
@@ -178,7 +178,7 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
 
     override fun routingStrategies(): RoutingStrategyServiceAsync = routingStrategies
 
-    override fun preferenceSections(): PreferenceSectionServiceAsync = preferenceSections
+    override fun workspacePreferences(): WorkspacePreferenceServiceAsync = workspacePreferences
 
     override fun profiles(): ProfileServiceAsync = profiles
 
@@ -257,8 +257,8 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
             RoutingStrategyServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val preferenceSections: PreferenceSectionServiceAsync.WithRawResponse by lazy {
-            PreferenceSectionServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        private val workspacePreferences: WorkspacePreferenceServiceAsync.WithRawResponse by lazy {
+            WorkspacePreferenceServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
         private val profiles: ProfileServiceAsync.WithRawResponse by lazy {
@@ -317,8 +317,8 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
         override fun routingStrategies(): RoutingStrategyServiceAsync.WithRawResponse =
             routingStrategies
 
-        override fun preferenceSections(): PreferenceSectionServiceAsync.WithRawResponse =
-            preferenceSections
+        override fun workspacePreferences(): WorkspacePreferenceServiceAsync.WithRawResponse =
+            workspacePreferences
 
         override fun profiles(): ProfileServiceAsync.WithRawResponse = profiles
 

diff --git a/courier-java-core/src/main/kotlin/com/courier/client/CourierClientImpl.kt b/courier-java-core/src/main/kotlin/com/courier/client/CourierClientImpl.kt
@@ -28,8 +28,6 @@ import com.courier.services.blocking.MessageService
 import com.courier.services.blocking.MessageServiceImpl
 import com.courier.services.blocking.NotificationService
 import com.courier.services.blocking.NotificationServiceImpl
-import com.courier.services.blocking.PreferenceSectionService
-import com.courier.services.blocking.PreferenceSectionServiceImpl
 import com.courier.services.blocking.ProfileService
 import com.courier.services.blocking.ProfileServiceImpl
 import com.courier.services.blocking.ProviderService
@@ -46,6 +44,8 @@ import com.courier.services.blocking.TranslationService
 import com.courier.services.blocking.TranslationServiceImpl
 import com.courier.services.blocking.UserService
 import com.courier.services.blocking.UserServiceImpl
+import com.courier.services.blocking.WorkspacePreferenceService
+import com.courier.services.blocking.WorkspacePreferenceServiceImpl
 import java.util.function.Consumer
 
 class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClient {
@@ -109,8 +109,8 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
         RoutingStrategyServiceImpl(clientOptionsWithUserAgent)
     }
 
-    private val preferenceSections: PreferenceSectionService by lazy {
-        PreferenceSectionServiceImpl(clientOptionsWithUserAgent)
+    private val workspacePreferences: WorkspacePreferenceService by lazy {
+        WorkspacePreferenceServiceImpl(clientOptionsWithUserAgent)
     }
 
     private val profiles: ProfileService by lazy { ProfileServiceImpl(clientOptionsWithUserAgent) }
@@ -162,7 +162,7 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
 
     override fun routingStrategies(): RoutingStrategyService = routingStrategies
 
-    override fun preferenceSections(): PreferenceSectionService = preferenceSections
+    override fun workspacePreferences(): WorkspacePreferenceService = workspacePreferences
 
     override fun profiles(): ProfileService = profiles
 
@@ -241,8 +241,8 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
             RoutingStrategyServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val preferenceSections: PreferenceSectionService.WithRawResponse by lazy {
-            PreferenceSectionServiceImpl.WithRawResponseImpl(clientOptions)
+        private val workspacePreferences: WorkspacePreferenceService.WithRawResponse by lazy {
+            WorkspacePreferenceServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
         private val profiles: ProfileService.WithRawResponse by lazy {
@@ -300,8 +300,8 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
 
         override fun routingStrategies(): RoutingStrategyService.WithRawResponse = routingStrategies
 
-        override fun preferenceSections(): PreferenceSectionService.WithRawResponse =
-            preferenceSections
+        override fun workspacePreferences(): WorkspacePreferenceService.WithRawResponse =
+            workspacePreferences
 
         override fun profiles(): ProfileService.WithRawResponse = profiles
 

diff --git a/...er-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckDeleteParams.kt b/...er-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckDeleteParams.kt
@@ -12,7 +12,7 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Cancel a notification template submission. */
+/** Cancel a submission for a notification template. */
 class CheckDeleteParams
 private constructor(
     private val id: String,

diff --git a/courier-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckListParams.kt b/courier-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckListParams.kt
@@ -10,7 +10,7 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Retrieve the checks for a notification template submission. */
+/** Retrieve the submission checks for a notification template. */
 class CheckListParams
 private constructor(
     private val id: String,

diff --git a/...er-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckUpdateParams.kt b/...er-java-core/src/main/kotlin/com/courier/models/notifications/checks/CheckUpdateParams.kt
@@ -23,7 +23,7 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Replace the checks for a notification template submission. */
+/** Replace the submission checks for a notification template. */
 class CheckUpdateParams
 private constructor(
     private val id: String,

diff --git a/...ncesections/PublishPreferencesResponse.kt → ...preferences/PublishPreferencesResponse.kt b/...ncesections/PublishPreferencesResponse.kt → ...preferences/PublishPreferencesResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.courier.models.preferencesections
+package com.courier.models.workspacepreferences
 
 import com.courier.core.ExcludeMissing
 import com.courier.core.JsonField

diff --git a/...ections/PreferenceSectionArchiveParams.kt → ...ences/WorkspacePreferenceArchiveParams.kt b/...ections/PreferenceSectionArchiveParams.kt → ...ences/WorkspacePreferenceArchiveParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.courier.models.preferencesections
+package com.courier.models.workspacepreferences
 
 import com.courier.core.JsonValue
 import com.courier.core.Params
@@ -12,10 +12,10 @@ import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
- * Archive a preference section. The section must be empty: delete its topics first, otherwise the
- * request fails with 409.
+ * Archive a workspace preference. The workspace preference must be empty: delete its topics first,
+ * otherwise the request fails with 409.
  */
-class PreferenceSectionArchiveParams
+class WorkspacePreferenceArchiveParams
 private constructor(
     private val sectionId: String?,
     private val additionalHeaders: Headers,
@@ -38,16 +38,16 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): PreferenceSectionArchiveParams = builder().build()
+        @JvmStatic fun none(): WorkspacePreferenceArchiveParams = builder().build()
 
         /**
          * Returns a mutable builder for constructing an instance of
-         * [PreferenceSectionArchiveParams].
+         * [WorkspacePreferenceArchiveParams].
          */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [PreferenceSectionArchiveParams]. */
+    /** A builder for [WorkspacePreferenceArchiveParams]. */
     class Builder internal constructor() {
 
         private var sectionId: String? = null
@@ -56,13 +56,15 @@ private constructor(
         private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(preferenceSectionArchiveParams: PreferenceSectionArchiveParams) = apply {
-            sectionId = preferenceSectionArchiveParams.sectionId
-            additionalHeaders = preferenceSectionArchiveParams.additionalHeaders.toBuilder()
-            additionalQueryParams = preferenceSectionArchiveParams.additionalQueryParams.toBuilder()
-            additionalBodyProperties =
-                preferenceSectionArchiveParams.additionalBodyProperties.toMutableMap()
-        }
+        internal fun from(workspacePreferenceArchiveParams: WorkspacePreferenceArchiveParams) =
+            apply {
+                sectionId = workspacePreferenceArchiveParams.sectionId
+                additionalHeaders = workspacePreferenceArchiveParams.additionalHeaders.toBuilder()
+                additionalQueryParams =
+                    workspacePreferenceArchiveParams.additionalQueryParams.toBuilder()
+                additionalBodyProperties =
+                    workspacePreferenceArchiveParams.additionalBodyProperties.toMutableMap()
+            }
 
         fun sectionId(sectionId: String?) = apply { this.sectionId = sectionId }
 
@@ -190,12 +192,12 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [PreferenceSectionArchiveParams].
+         * Returns an immutable instance of [WorkspacePreferenceArchiveParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): PreferenceSectionArchiveParams =
-            PreferenceSectionArchiveParams(
+        fun build(): WorkspacePreferenceArchiveParams =
+            WorkspacePreferenceArchiveParams(
                 sectionId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
@@ -221,7 +223,7 @@ private constructor(
             return true
         }
 
-        return other is PreferenceSectionArchiveParams &&
+        return other is WorkspacePreferenceArchiveParams &&
             sectionId == other.sectionId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams &&
@@ -232,5 +234,5 @@ private constructor(
         Objects.hash(sectionId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
 
     override fun toString() =
-        "PreferenceSectionArchiveParams{sectionId=$sectionId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+        "WorkspacePreferenceArchiveParams{sectionId=$sectionId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
 }