release: 4.25.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.24.0"
+  ".": "4.25.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 147
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-ca32540df5bca42c8113de4004e7751b74bb440e3d73267e7cbad84dd3c3e82a.yml
-openapi_spec_hash: 5576c8cf8e5be1f250b5dd1eb6d30571
-config_hash: c6cefb51165221f01d442a42ac4a13b9
+configured_endpoints: 145
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier/courier-b4485f5c4897c26d52a46aeb39b8a22415bcd529b0ad326fd43a30d7fadf1376.yml
+openapi_spec_hash: db619c8991994dc8016fc4327f6917a2
+config_hash: 3eb0070d128aef7a6da16173f7050177

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 4.25.0 (2026-07-30)
+
+Full Changelog: [v4.24.0...v4.25.0](https://github.com/trycourier/courier-java/compare/v4.24.0...v4.25.0)
+
+### Features
+
+* spec: remove inbox message delete/restore endpoints for now (C-19268) ([#182](https://github.com/trycourier/courier-java/issues/182)) ([07e30e0](https://github.com/trycourier/courier-java/commit/07e30e0228b6de99301269f039ebba887c5dff47))
+* spec: reorder API reference sections to match the Studio nav ([#180](https://github.com/trycourier/courier-java/issues/180)) ([3fe56cc](https://github.com/trycourier/courier-java/commit/3fe56ccad1fcdce5235c1ef4e3c2613879384d59))
+
 ## 4.24.0 (2026-07-29)
 
 Full Changelog: [v4.23.0...v4.24.0](https://github.com/trycourier/courier-java/compare/v4.23.0...v4.24.0)

build.gradle.kts

@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.courier"
-    version = "4.24.0" // x-release-please-version
+    version = "4.25.0" // x-release-please-version
 }
 
 subprojects {

courier-java-core/src/main/kotlin/com/courier/client/CourierClient.kt

@@ -11,7 +11,6 @@ import com.courier.services.blocking.BrandService
 import com.courier.services.blocking.BroadcastService
 import com.courier.services.blocking.DigestService
 import com.courier.services.blocking.InboundService
-import com.courier.services.blocking.InboxService
 import com.courier.services.blocking.JourneyService
 import com.courier.services.blocking.ListService
 import com.courier.services.blocking.MessageService
@@ -97,6 +96,10 @@ interface CourierClient {
      */
     fun journeys(): JourneyService
 
+    /**
+     * Create a one-off send to a list or audience, author its content, then send it immediately or
+     * schedule it for later.
+     */
     fun broadcasts(): BroadcastService
 
     /** Manage the logos, colors, and layout that give the templates you send a consistent look. */
@@ -113,8 +116,6 @@ interface CourierClient {
      */
     fun lists(): ListService
 
-    fun inbox(): InboxService
-
     /**
      * Look up the messages Courier has accepted, inspect their delivery history and rendered
      * output, and cancel, resend, or archive them.
@@ -219,6 +220,10 @@ interface CourierClient {
          */
         fun journeys(): JourneyService.WithRawResponse
 
+        /**
+         * Create a one-off send to a list or audience, author its content, then send it immediately
+         * or schedule it for later.
+         */
         fun broadcasts(): BroadcastService.WithRawResponse
 
         /**
@@ -237,8 +242,6 @@ interface CourierClient {
          */
         fun lists(): ListService.WithRawResponse
 
-        fun inbox(): InboxService.WithRawResponse
-
         /**
          * Look up the messages Courier has accepted, inspect their delivery history and rendered
          * output, and cancel, resend, or archive them.

courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsync.kt

@@ -11,7 +11,6 @@ import com.courier.services.async.BrandServiceAsync
 import com.courier.services.async.BroadcastServiceAsync
 import com.courier.services.async.DigestServiceAsync
 import com.courier.services.async.InboundServiceAsync
-import com.courier.services.async.InboxServiceAsync
 import com.courier.services.async.JourneyServiceAsync
 import com.courier.services.async.ListServiceAsync
 import com.courier.services.async.MessageServiceAsync
@@ -97,6 +96,10 @@ interface CourierClientAsync {
      */
     fun journeys(): JourneyServiceAsync
 
+    /**
+     * Create a one-off send to a list or audience, author its content, then send it immediately or
+     * schedule it for later.
+     */
     fun broadcasts(): BroadcastServiceAsync
 
     /** Manage the logos, colors, and layout that give the templates you send a consistent look. */
@@ -113,8 +116,6 @@ interface CourierClientAsync {
      */
     fun lists(): ListServiceAsync
 
-    fun inbox(): InboxServiceAsync
-
     /**
      * Look up the messages Courier has accepted, inspect their delivery history and rendered
      * output, and cancel, resend, or archive them.
@@ -223,6 +224,10 @@ interface CourierClientAsync {
          */
         fun journeys(): JourneyServiceAsync.WithRawResponse
 
+        /**
+         * Create a one-off send to a list or audience, author its content, then send it immediately
+         * or schedule it for later.
+         */
         fun broadcasts(): BroadcastServiceAsync.WithRawResponse
 
         /**
@@ -241,8 +246,6 @@ interface CourierClientAsync {
          */
         fun lists(): ListServiceAsync.WithRawResponse
 
-        fun inbox(): InboxServiceAsync.WithRawResponse
-
         /**
          * Look up the messages Courier has accepted, inspect their delivery history and rendered
          * output, and cancel, resend, or archive them.

courier-java-core/src/main/kotlin/com/courier/client/CourierClientAsyncImpl.kt

@@ -20,8 +20,6 @@ import com.courier.services.async.DigestServiceAsync
 import com.courier.services.async.DigestServiceAsyncImpl
 import com.courier.services.async.InboundServiceAsync
 import com.courier.services.async.InboundServiceAsyncImpl
-import com.courier.services.async.InboxServiceAsync
-import com.courier.services.async.InboxServiceAsyncImpl
 import com.courier.services.async.JourneyServiceAsync
 import com.courier.services.async.JourneyServiceAsyncImpl
 import com.courier.services.async.ListServiceAsync
@@ -109,10 +107,6 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
 
     private val lists: ListServiceAsync by lazy { ListServiceAsyncImpl(clientOptionsWithUserAgent) }
 
-    private val inbox: InboxServiceAsync by lazy {
-        InboxServiceAsyncImpl(clientOptionsWithUserAgent)
-    }
-
     private val messages: MessageServiceAsync by lazy {
         MessageServiceAsyncImpl(clientOptionsWithUserAgent)
     }
@@ -188,6 +182,10 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
      */
     override fun journeys(): JourneyServiceAsync = journeys
 
+    /**
+     * Create a one-off send to a list or audience, author its content, then send it immediately or
+     * schedule it for later.
+     */
     override fun broadcasts(): BroadcastServiceAsync = broadcasts
 
     /** Manage the logos, colors, and layout that give the templates you send a consistent look. */
@@ -204,8 +202,6 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
      */
     override fun lists(): ListServiceAsync = lists
 
-    override fun inbox(): InboxServiceAsync = inbox
-
     /**
      * Look up the messages Courier has accepted, inspect their delivery history and rendered
      * output, and cancel, resend, or archive them.
@@ -304,10 +300,6 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
             ListServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val inbox: InboxServiceAsync.WithRawResponse by lazy {
-            InboxServiceAsyncImpl.WithRawResponseImpl(clientOptions)
-        }
-
         private val messages: MessageServiceAsync.WithRawResponse by lazy {
             MessageServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
@@ -387,6 +379,10 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
          */
         override fun journeys(): JourneyServiceAsync.WithRawResponse = journeys
 
+        /**
+         * Create a one-off send to a list or audience, author its content, then send it immediately
+         * or schedule it for later.
+         */
         override fun broadcasts(): BroadcastServiceAsync.WithRawResponse = broadcasts
 
         /**
@@ -405,8 +401,6 @@ class CourierClientAsyncImpl(private val clientOptions: ClientOptions) : Courier
          */
         override fun lists(): ListServiceAsync.WithRawResponse = lists
 
-        override fun inbox(): InboxServiceAsync.WithRawResponse = inbox
-
         /**
          * Look up the messages Courier has accepted, inspect their delivery history and rendered
          * output, and cancel, resend, or archive them.

courier-java-core/src/main/kotlin/com/courier/client/CourierClientImpl.kt

@@ -20,8 +20,6 @@ import com.courier.services.blocking.DigestService
 import com.courier.services.blocking.DigestServiceImpl
 import com.courier.services.blocking.InboundService
 import com.courier.services.blocking.InboundServiceImpl
-import com.courier.services.blocking.InboxService
-import com.courier.services.blocking.InboxServiceImpl
 import com.courier.services.blocking.JourneyService
 import com.courier.services.blocking.JourneyServiceImpl
 import com.courier.services.blocking.ListService
@@ -101,8 +99,6 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
 
     private val lists: ListService by lazy { ListServiceImpl(clientOptionsWithUserAgent) }
 
-    private val inbox: InboxService by lazy { InboxServiceImpl(clientOptionsWithUserAgent) }
-
     private val messages: MessageService by lazy { MessageServiceImpl(clientOptionsWithUserAgent) }
 
     private val requests: RequestService by lazy { RequestServiceImpl(clientOptionsWithUserAgent) }
@@ -170,6 +166,10 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
      */
     override fun journeys(): JourneyService = journeys
 
+    /**
+     * Create a one-off send to a list or audience, author its content, then send it immediately or
+     * schedule it for later.
+     */
     override fun broadcasts(): BroadcastService = broadcasts
 
     /** Manage the logos, colors, and layout that give the templates you send a consistent look. */
@@ -186,8 +186,6 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
      */
     override fun lists(): ListService = lists
 
-    override fun inbox(): InboxService = inbox
-
     /**
      * Look up the messages Courier has accepted, inspect their delivery history and rendered
      * output, and cancel, resend, or archive them.
@@ -286,10 +284,6 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
             ListServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val inbox: InboxService.WithRawResponse by lazy {
-            InboxServiceImpl.WithRawResponseImpl(clientOptions)
-        }
-
         private val messages: MessageService.WithRawResponse by lazy {
             MessageServiceImpl.WithRawResponseImpl(clientOptions)
         }
@@ -369,6 +363,10 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
          */
         override fun journeys(): JourneyService.WithRawResponse = journeys
 
+        /**
+         * Create a one-off send to a list or audience, author its content, then send it immediately
+         * or schedule it for later.
+         */
         override fun broadcasts(): BroadcastService.WithRawResponse = broadcasts
 
         /**
@@ -387,8 +385,6 @@ class CourierClientImpl(private val clientOptions: ClientOptions) : CourierClien
          */
         override fun lists(): ListService.WithRawResponse = lists
 
-        override fun inbox(): InboxService.WithRawResponse = inbox
-
         /**
          * Look up the messages Courier has accepted, inspect their delivery history and rendered
          * output, and cancel, resend, or archive them.