release: 4.11.0

.github/workflows/ci.yml

@@ -1,12 +1,14 @@
 name: CI
 on:
   push:
-    branches-ignore:
-      - 'generated'
-      - 'codegen/**'
-      - 'integrated/**'
-      - 'stl-preview-head/**'
-      - 'stl-preview-base/**'
+    branches:
+      - '**'
+      - '!integrated/**'
+      - '!stl-preview-head/**'
+      - '!stl-preview-base/**'
+      - '!generated'
+      - '!codegen/**'
+      - 'codegen/stl/**'
   pull_request:
     branches-ignore:
       - 'stl-preview-head/**'
@@ -17,7 +19,7 @@ jobs:
     timeout-minutes: 15
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/courier-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
       - uses: actions/checkout@v6
@@ -44,7 +46,7 @@ jobs:
       contents: read
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/courier-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
-    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
+    if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
       - uses: actions/checkout@v6

.gitignore

@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 .gradle
 .idea
 .kotlin

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.10.0"
+  ".": "4.11.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-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
+configured_endpoints: 89
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/courier%2Fcourier-28c3d906924905ea7f42fd645574bea0988de857d0d023770695160d8ed7435e.yml
+openapi_spec_hash: 59844e5d8943f8df663069f28aff328c
+config_hash: 1ffb164d1c97b45fb182fe619456e3f9

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 4.11.0 (2026-03-27)
+
+Full Changelog: [v4.10.0...v4.11.0](https://github.com/trycourier/courier-java/compare/v4.10.0...v4.11.0)
+
+### Features
+
+* **api:** add create/retrieve/archive/publish/replace methods, event_id param to notifications ([d0341ec](https://github.com/trycourier/courier-java/commit/d0341ecd91cd175c1fbd252f3f5caa4961a38a11))
+* **api:** add UnionMember7 variant to ElementalNode ([7427c73](https://github.com/trycourier/courier-java/commit/7427c73d38e46ed9ef2a5535ab4f5de8422e962a))
+
+
+### Bug Fixes
+
+* **client:** allow updating header/query affecting fields in `toBuilder()` ([ed456e5](https://github.com/trycourier/courier-java/commit/ed456e5be6b63dd0c16ddf1e5c90dde476d4d7e5))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([2b3cd27](https://github.com/trycourier/courier-java/commit/2b3cd2798e31d09d6e0d329e3bb46f45a73c9aac))
+* **internal:** bump ktfmt ([affb7da](https://github.com/trycourier/courier-java/commit/affb7dae80ab5957a15a0b497dcf1afd3146eec7))
+* **internal:** tweak CI branches ([1bd9068](https://github.com/trycourier/courier-java/commit/1bd906869c298547c59c2ffbc0f0ef0e37958206))
+* **internal:** update gitignore ([d801bca](https://github.com/trycourier/courier-java/commit/d801bca833d04aa2adb2f9bb4df7b6777cfb022a))
+* **internal:** update retry delay tests ([e3ecdf0](https://github.com/trycourier/courier-java/commit/e3ecdf0b1b898a83eb234cb289db18e51cfd8982))
+
+
+### Documentation
+
+* sync README from mintlify-docs (2026-03-23 19:31 UTC) ([#95](https://github.com/trycourier/courier-java/issues/95)) ([8efc854](https://github.com/trycourier/courier-java/commit/8efc8542cbe37b8ba7673d53a37995625e574785))
+
 ## 4.10.0 (2026-03-12)
 
 Full Changelog: [v4.9.1...v4.10.0](https://github.com/trycourier/courier-java/compare/v4.9.1...v4.10.0)

build.gradle.kts

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

buildSrc/src/main/kotlin/courier.kotlin.gradle.kts

@@ -40,7 +40,7 @@ tasks.withType<Test>().configureEach {
 
 val ktfmt by configurations.creating
 dependencies {
-    ktfmt("com.facebook:ktfmt:0.56")
+    ktfmt("com.facebook:ktfmt:0.61")
 }
 
 fun registerKtfmt(

courier-java-core/src/main/kotlin/com/courier/core/ClientOptions.kt

@@ -403,13 +403,14 @@ private constructor(
             headers.put("X-Stainless-Runtime", "JRE")
             headers.put("X-Stainless-Runtime-Version", getJavaVersion())
             headers.put("X-Stainless-Kotlin-Version", KotlinVersion.CURRENT.toString())
+            // We replace after all the default headers to allow end-users to overwrite them.
+            headers.replaceAll(this.headers.build())
+            queryParams.replaceAll(this.queryParams.build())
             apiKey.let {
                 if (!it.isEmpty()) {
-                    headers.put("Authorization", "Bearer $it")
+                    headers.replace("Authorization", "Bearer $it")
                 }
             }
-            headers.replaceAll(this.headers.build())
-            queryParams.replaceAll(this.queryParams.build())
 
             return ClientOptions(
                 httpClient,

courier-java-core/src/main/kotlin/com/courier/models/ElementalContent.kt

@@ -176,6 +176,10 @@ private constructor(
         fun addElement(quoteNodeWithType: ElementalQuoteNodeWithType) =
             addElement(ElementalNode.ofQuoteNodeWithType(quoteNodeWithType))
 
+        /** Alias for calling [addElement] with `ElementalNode.ofUnionMember7(unionMember7)`. */
+        fun addElement(unionMember7: ElementalNode.UnionMember7) =
+            addElement(ElementalNode.ofUnionMember7(unionMember7))
+
         /** For example, "2022-01-01" */
         fun version(version: String) = version(JsonField.of(version))