From dd2bca38596e4ef7626ef23d1a73ce7678a4375e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 6 Jan 2026 05:33:42 +0000
Subject: [PATCH 01/63] feat(client): add `HttpRequest#url()` method

---
 LICENSE                                       |   2 +-
 .../com/blooio/api/core/http/HttpRequest.kt   |  30 +++++
 .../blooio/api/core/http/HttpRequestTest.kt   | 110 ++++++++++++++++++
 3 files changed, 141 insertions(+), 1 deletion(-)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestTest.kt

diff --git a/LICENSE b/LICENSE
index 789f1c0..ce4ae4d 100644
--- a/LICENSE
+++ b/LICENSE
@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Blooio
+   Copyright 2026 Blooio
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequest.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequest.kt
index 7c10228..5bb901b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequest.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequest.kt
@@ -2,6 +2,7 @@ package com.blooio.api.core.http
 
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
+import java.net.URLEncoder
 
 class HttpRequest
 private constructor(
@@ -13,6 +14,35 @@ private constructor(
     @get:JvmName("body") val body: HttpRequestBody?,
 ) {
 
+    fun url(): String = buildString {
+        append(baseUrl)
+
+        pathSegments.forEach { segment ->
+            if (!endsWith("/")) {
+                append("/")
+            }
+            append(URLEncoder.encode(segment, "UTF-8"))
+        }
+
+        if (queryParams.isEmpty()) {
+            return@buildString
+        }
+
+        append("?")
+        var isFirst = true
+        queryParams.keys().forEach { key ->
+            queryParams.values(key).forEach { value ->
+                if (!isFirst) {
+                    append("&")
+                }
+                append(URLEncoder.encode(key, "UTF-8"))
+                append("=")
+                append(URLEncoder.encode(value, "UTF-8"))
+                isFirst = false
+            }
+        }
+    }
+
     fun toBuilder(): Builder = Builder().from(this)
 
     override fun toString(): String =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestTest.kt
new file mode 100644
index 0000000..57d1430
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestTest.kt
@@ -0,0 +1,110 @@
+package com.blooio.api.core.http
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class HttpRequestTest {
+
+    enum class UrlTestCase(val request: HttpRequest, val expectedUrl: String) {
+        BASE_URL_ONLY(
+            HttpRequest.builder().method(HttpMethod.GET).baseUrl("https://api.example.com").build(),
+            expectedUrl = "https://api.example.com",
+        ),
+        BASE_URL_WITH_TRAILING_SLASH(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com/")
+                .build(),
+            expectedUrl = "https://api.example.com/",
+        ),
+        SINGLE_PATH_SEGMENT(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .build(),
+            expectedUrl = "https://api.example.com/users",
+        ),
+        MULTIPLE_PATH_SEGMENTS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegments("users", "123", "profile")
+                .build(),
+            expectedUrl = "https://api.example.com/users/123/profile",
+        ),
+        PATH_SEGMENT_WITH_SPECIAL_CHARS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("user name")
+                .build(),
+            expectedUrl = "https://api.example.com/user+name",
+        ),
+        SINGLE_QUERY_PARAM(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParam("limit", "10")
+                .build(),
+            expectedUrl = "https://api.example.com/users?limit=10",
+        ),
+        MULTIPLE_QUERY_PARAMS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParam("limit", "10")
+                .putQueryParam("offset", "20")
+                .build(),
+            expectedUrl = "https://api.example.com/users?limit=10&offset=20",
+        ),
+        QUERY_PARAM_WITH_SPECIAL_CHARS(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("search")
+                .putQueryParam("q", "hello world")
+                .build(),
+            expectedUrl = "https://api.example.com/search?q=hello+world",
+        ),
+        MULTIPLE_VALUES_SAME_PARAM(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com")
+                .addPathSegment("users")
+                .putQueryParams("tags", listOf("admin", "user"))
+                .build(),
+            expectedUrl = "https://api.example.com/users?tags=admin&tags=user",
+        ),
+        BASE_URL_WITH_TRAILING_SLASH_AND_PATH(
+            HttpRequest.builder()
+                .method(HttpMethod.GET)
+                .baseUrl("https://api.example.com/")
+                .addPathSegment("users")
+                .build(),
+            expectedUrl = "https://api.example.com/users",
+        ),
+        COMPLEX_URL(
+            HttpRequest.builder()
+                .method(HttpMethod.POST)
+                .baseUrl("https://api.example.com")
+                .addPathSegments("v1", "users", "123")
+                .putQueryParams("include", listOf("profile", "settings"))
+                .putQueryParam("format", "json")
+                .build(),
+            expectedUrl =
+                "https://api.example.com/v1/users/123?include=profile&include=settings&format=json",
+        ),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun url(testCase: UrlTestCase) {
+        val actualUrl = testCase.request.url()
+
+        assertThat(actualUrl).isEqualTo(testCase.expectedUrl)
+    }
+}

From 4f0db3097b9b0c1876887115146216c0b3a50c30 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 9 Jan 2026 04:54:47 +0000
Subject: [PATCH 02/63] feat(client): allow configuring dispatcher executor
 service

---
 .../api/client/okhttp/BlooioOkHttpClient.kt   | 22 +++++++++++++++++++
 .../client/okhttp/BlooioOkHttpClientAsync.kt  | 22 +++++++++++++++++++
 .../blooio/api/client/okhttp/OkHttpClient.kt  |  9 ++++++++
 3 files changed, 53 insertions(+)

diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index 1d24917..e4722d3 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -16,6 +16,7 @@ import java.net.Proxy
 import java.time.Clock
 import java.time.Duration
 import java.util.Optional
+import java.util.concurrent.ExecutorService
 import javax.net.ssl.HostnameVerifier
 import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.X509TrustManager
@@ -44,11 +45,31 @@ class BlooioOkHttpClient private constructor() {
     class Builder internal constructor() {
 
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
+        private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
         private var hostnameVerifier: HostnameVerifier? = null
 
+        /**
+         * The executor service to use for running HTTP requests.
+         *
+         * Defaults to OkHttp's
+         * [default executor service](https://github.com/square/okhttp/blob/ace792f443b2ffb17974f5c0d1cecdf589309f26/okhttp/src/commonJvmAndroid/kotlin/okhttp3/Dispatcher.kt#L98-L104).
+         *
+         * This class takes ownership of the executor service and shuts it down when closed.
+         */
+        fun dispatcherExecutorService(dispatcherExecutorService: ExecutorService?) = apply {
+            this.dispatcherExecutorService = dispatcherExecutorService
+        }
+
+        /**
+         * Alias for calling [Builder.dispatcherExecutorService] with
+         * `dispatcherExecutorService.orElse(null)`.
+         */
+        fun dispatcherExecutorService(dispatcherExecutorService: Optional<ExecutorService>) =
+            dispatcherExecutorService(dispatcherExecutorService.getOrNull())
+
         fun proxy(proxy: Proxy?) = apply { this.proxy = proxy }
 
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
@@ -297,6 +318,7 @@ class BlooioOkHttpClient private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .dispatcherExecutorService(dispatcherExecutorService)
                             .sslSocketFactory(sslSocketFactory)
                             .trustManager(trustManager)
                             .hostnameVerifier(hostnameVerifier)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index d5e7916..3572e6a 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -16,6 +16,7 @@ import java.net.Proxy
 import java.time.Clock
 import java.time.Duration
 import java.util.Optional
+import java.util.concurrent.ExecutorService
 import javax.net.ssl.HostnameVerifier
 import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.X509TrustManager
@@ -44,11 +45,31 @@ class BlooioOkHttpClientAsync private constructor() {
     class Builder internal constructor() {
 
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
+        private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
         private var hostnameVerifier: HostnameVerifier? = null
 
+        /**
+         * The executor service to use for running HTTP requests.
+         *
+         * Defaults to OkHttp's
+         * [default executor service](https://github.com/square/okhttp/blob/ace792f443b2ffb17974f5c0d1cecdf589309f26/okhttp/src/commonJvmAndroid/kotlin/okhttp3/Dispatcher.kt#L98-L104).
+         *
+         * This class takes ownership of the executor service and shuts it down when closed.
+         */
+        fun dispatcherExecutorService(dispatcherExecutorService: ExecutorService?) = apply {
+            this.dispatcherExecutorService = dispatcherExecutorService
+        }
+
+        /**
+         * Alias for calling [Builder.dispatcherExecutorService] with
+         * `dispatcherExecutorService.orElse(null)`.
+         */
+        fun dispatcherExecutorService(dispatcherExecutorService: Optional<ExecutorService>) =
+            dispatcherExecutorService(dispatcherExecutorService.getOrNull())
+
         fun proxy(proxy: Proxy?) = apply { this.proxy = proxy }
 
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
@@ -297,6 +318,7 @@ class BlooioOkHttpClientAsync private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .dispatcherExecutorService(dispatcherExecutorService)
                             .sslSocketFactory(sslSocketFactory)
                             .trustManager(trustManager)
                             .hostnameVerifier(hostnameVerifier)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
index a5565a5..91b0eff 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
@@ -15,11 +15,13 @@ import java.net.Proxy
 import java.time.Duration
 import java.util.concurrent.CancellationException
 import java.util.concurrent.CompletableFuture
+import java.util.concurrent.ExecutorService
 import javax.net.ssl.HostnameVerifier
 import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.X509TrustManager
 import okhttp3.Call
 import okhttp3.Callback
+import okhttp3.Dispatcher
 import okhttp3.HttpUrl.Companion.toHttpUrl
 import okhttp3.MediaType
 import okhttp3.MediaType.Companion.toMediaType
@@ -198,6 +200,7 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
 
         private var timeout: Timeout = Timeout.default()
         private var proxy: Proxy? = null
+        private var dispatcherExecutorService: ExecutorService? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
         private var hostnameVerifier: HostnameVerifier? = null
@@ -208,6 +211,10 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
 
         fun proxy(proxy: Proxy?) = apply { this.proxy = proxy }
 
+        fun dispatcherExecutorService(dispatcherExecutorService: ExecutorService?) = apply {
+            this.dispatcherExecutorService = dispatcherExecutorService
+        }
+
         fun sslSocketFactory(sslSocketFactory: SSLSocketFactory?) = apply {
             this.sslSocketFactory = sslSocketFactory
         }
@@ -229,6 +236,8 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
                     .callTimeout(timeout.request())
                     .proxy(proxy)
                     .apply {
+                        dispatcherExecutorService?.let { dispatcher(Dispatcher(it)) }
+
                         val sslSocketFactory = sslSocketFactory
                         val trustManager = trustManager
                         if (sslSocketFactory != null && trustManager != null) {

From d7905093b659e696e05478ee514fbbad370cc9d0 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 13 Jan 2026 08:40:08 +0000
Subject: [PATCH 03/63] chore(internal): support uploading Maven repo artifacts
 to stainless package server

---
 .github/workflows/ci.yml                      | 18 ++++
 .../src/main/kotlin/blooio.publish.gradle.kts |  8 ++
 scripts/upload-artifacts                      | 96 +++++++++++++++++++
 3 files changed, 122 insertions(+)
 create mode 100755 scripts/upload-artifacts

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7a7202d..66fee98 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -40,6 +40,9 @@ jobs:
   build:
     timeout-minutes: 15
     name: build
+    permissions:
+      contents: read
+      id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
@@ -61,6 +64,21 @@ jobs:
       - name: Build SDK
         run: ./scripts/build
 
+      - name: Get GitHub OIDC Token
+        if: github.repository == 'stainless-sdks/blooio-java'
+        id: github-oidc
+        uses: actions/github-script@v6
+        with:
+          script: core.setOutput('github_token', await core.getIDToken());
+
+      - name: Build and upload Maven artifacts
+        if: github.repository == 'stainless-sdks/blooio-java'
+        env:
+          URL: https://pkg.stainless.com/s
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          PROJECT: blooio-java
+        run: ./scripts/upload-artifacts
   test:
     timeout-minutes: 15
     name: test
diff --git a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
index 89bd9b0..e83dae5 100644
--- a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
@@ -39,6 +39,14 @@ configure<PublishingExtension> {
             }
         }
     }
+    repositories {
+        if (project.hasProperty("publishLocal")) {
+            maven {
+                name = "LocalFileSystem"
+                url = uri("${rootProject.layout.buildDirectory.get()}/local-maven-repo")
+            }
+        }
+    }
 }
 
 signing {
diff --git a/scripts/upload-artifacts b/scripts/upload-artifacts
new file mode 100755
index 0000000..729e6f2
--- /dev/null
+++ b/scripts/upload-artifacts
@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# ANSI Color Codes
+GREEN='\033[32m'
+RED='\033[31m'
+NC='\033[0m' # No Color
+
+log_error() {
+    local msg="$1"
+    local headers="$2"
+    local body="$3"
+    echo -e "${RED}${msg}${NC}"
+    [[ -f "$headers" ]] && echo -e "${RED}Headers:$(cat "$headers")${NC}"
+    echo -e "${RED}Body: ${body}${NC}"
+    exit 1
+}
+
+upload_file() {
+    local file_name="$1"
+    local tmp_headers
+    tmp_headers=$(mktemp)
+
+    if [ -f "$file_name" ]; then
+        echo -e "${GREEN}Processing file: $file_name${NC}"
+        pkg_file_name="mvn${file_name#./build/local-maven-repo}"
+
+        # Get signed URL for uploading artifact file
+        signed_url_response=$(curl -X POST -G "$URL" \
+            -sS --retry 5 \
+            -D "$tmp_headers" \
+            --data-urlencode "filename=$pkg_file_name" \
+            -H "Authorization: Bearer $AUTH" \
+            -H "Content-Type: application/json")
+
+        # Validate JSON and extract URL
+        if ! signed_url=$(echo "$signed_url_response" | jq -e -r '.url' 2>/dev/null) || [[ "$signed_url" == "null" ]]; then
+            log_error "Failed to get valid signed URL" "$tmp_headers" "$signed_url_response"
+        fi
+
+        # Set content-type based on file extension
+        local extension="${file_name##*.}"
+        local content_type
+        case "$extension" in
+            jar)                    content_type="application/java-archive" ;;
+            md5|sha1|sha256|sha512) content_type="text/plain" ;;
+            module)                 content_type="application/json" ;;
+            pom|xml)                content_type="application/xml" ;;
+            *)                      content_type="application/octet-stream" ;;
+        esac
+
+        # Upload file
+        upload_response=$(curl -v -X PUT \
+            --retry 5 \
+            -D "$tmp_headers" \
+            -H "Content-Type: $content_type" \
+            --data-binary "@${file_name}" "$signed_url" 2>&1)
+
+        if ! echo "$upload_response" | grep -q "HTTP/[0-9.]* 200"; then
+            log_error "Failed upload artifact file" "$tmp_headers" "$upload_response"
+        fi
+
+        # Insert small throttle to reduce rate limiting risk
+        sleep 0.1
+    fi
+}
+
+walk_tree() {
+    local current_dir="$1"
+
+    for entry in "$current_dir"/*; do
+        # Check that entry is valid
+        [ -e "$entry" ] || [ -h "$entry" ] || continue
+
+        if [ -d "$entry" ]; then
+            walk_tree "$entry"
+        else
+            upload_file "$entry"
+        fi
+    done
+}
+
+cd "$(dirname "$0")/.."
+
+echo "::group::Creating local Maven content"
+./gradlew publishMavenPublicationToLocalFileSystemRepository -PpublishLocal
+echo "::endgroup::"
+
+echo "::group::Uploading to pkg.stainless.com"
+walk_tree "./build/local-maven-repo"
+echo "::endgroup::"
+
+echo "::group::Generating instructions"
+echo "Configure maven or gradle to use the repo located at 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'"
+echo "::endgroup::"

From d441da9aa8607881a63e2ed14b9037fcccf1600d Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 16 Jan 2026 04:25:14 +0000
Subject: [PATCH 04/63] chore(internal): clean up maven repo artifact script
 and add html documentation to repo root

---
 scripts/upload-artifacts | 44 +++++++++++++++++++++++++++++++++++++---
 1 file changed, 41 insertions(+), 3 deletions(-)

diff --git a/scripts/upload-artifacts b/scripts/upload-artifacts
index 729e6f2..df0c8d9 100755
--- a/scripts/upload-artifacts
+++ b/scripts/upload-artifacts
@@ -7,6 +7,8 @@ GREEN='\033[32m'
 RED='\033[31m'
 NC='\033[0m' # No Color
 
+MAVEN_REPO_PATH="./build/local-maven-repo"
+
 log_error() {
     local msg="$1"
     local headers="$2"
@@ -24,7 +26,7 @@ upload_file() {
 
     if [ -f "$file_name" ]; then
         echo -e "${GREEN}Processing file: $file_name${NC}"
-        pkg_file_name="mvn${file_name#./build/local-maven-repo}"
+        pkg_file_name="mvn${file_name#"${MAVEN_REPO_PATH}"}"
 
         # Get signed URL for uploading artifact file
         signed_url_response=$(curl -X POST -G "$URL" \
@@ -47,6 +49,7 @@ upload_file() {
             md5|sha1|sha256|sha512) content_type="text/plain" ;;
             module)                 content_type="application/json" ;;
             pom|xml)                content_type="application/xml" ;;
+            html)                   content_type="text/html" ;;
             *)                      content_type="application/octet-stream" ;;
         esac
 
@@ -81,6 +84,41 @@ walk_tree() {
     done
 }
 
+generate_instructions() {
+    cat << EOF > "$MAVEN_REPO_PATH/index.html"
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Maven Repo</title>
+</head>
+<body>
+    <h1>Stainless SDK Maven Repository</h1>
+    <p>This is the Maven repository for your Stainless Java SDK build.</p>
+
+    <h1>Directions</h1>
+    <p>To use the uploaded Maven repository, add the following to your project's <code>pom.xml</code>:</p>
+    <pre>&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;stainless-sdk-repo&lt;/id&gt;
+        &lt;url&gt;https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn&lt;/url&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;</pre>
+
+    <p>If you're using Gradle, add the following to your <code>build.gradle</code> file:</p>
+    <pre>repositories {
+    maven {
+        url 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'
+    }
+}</pre>
+</body>
+</html>
+EOF
+    upload_file "${MAVEN_REPO_PATH}/index.html"
+
+    echo "Configure maven or gradle to use the repo located at 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'"
+    echo "For more details, see the directions in https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn/index.html"
+}
+
 cd "$(dirname "$0")/.."
 
 echo "::group::Creating local Maven content"
@@ -88,9 +126,9 @@ echo "::group::Creating local Maven content"
 echo "::endgroup::"
 
 echo "::group::Uploading to pkg.stainless.com"
-walk_tree "./build/local-maven-repo"
+walk_tree "$MAVEN_REPO_PATH"
 echo "::endgroup::"
 
 echo "::group::Generating instructions"
-echo "Configure maven or gradle to use the repo located at 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'"
+generate_instructions
 echo "::endgroup::"

From b2ac60a271022b4f389feee2e73467927b2c7a51 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 05:57:36 +0000
Subject: [PATCH 05/63] chore: test on Jackson 2.14.0 to avoid encountering
 FasterXML/jackson-databind#3240 in tests fix: date time deserialization
 leniency

---
 README.md                                     |  2 ++
 blooio-java-core/build.gradle.kts             | 18 +++++-----
 .../com/blooio/api/core/ObjectMappers.kt      | 33 ++++++++++++-------
 .../com/blooio/api/core/ObjectMappersTest.kt  | 16 +++------
 blooio-java-proguard-test/build.gradle.kts    |  2 +-
 5 files changed, 38 insertions(+), 33 deletions(-)

diff --git a/README.md b/README.md
index 0ec93d0..2fc28b7 100644
--- a/README.md
+++ b/README.md
@@ -258,6 +258,8 @@ If the SDK threw an exception, but you're _certain_ the version is compatible, t
 > [!CAUTION]
 > We make no guarantee that the SDK works correctly when the Jackson version check is disabled.
 
+Also note that there are bugs in older Jackson versions that can affect the SDK. We don't work around all Jackson bugs ([example](https://github.com/FasterXML/jackson-databind/issues/3240)) and expect users to upgrade Jackson for those instead.
+
 ## Network options
 
 ### Retries
diff --git a/blooio-java-core/build.gradle.kts b/blooio-java-core/build.gradle.kts
index 813acf4..8a19d0f 100644
--- a/blooio-java-core/build.gradle.kts
+++ b/blooio-java-core/build.gradle.kts
@@ -5,14 +5,16 @@ plugins {
 
 configurations.all {
     resolutionStrategy {
-        // Compile and test against a lower Jackson version to ensure we're compatible with it.
-        // We publish with a higher version (see below) to ensure users depend on a secure version by default.
-        force("com.fasterxml.jackson.core:jackson-core:2.13.4")
-        force("com.fasterxml.jackson.core:jackson-databind:2.13.4")
-        force("com.fasterxml.jackson.core:jackson-annotations:2.13.4")
-        force("com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.13.4")
-        force("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.13.4")
-        force("com.fasterxml.jackson.module:jackson-module-kotlin:2.13.4")
+        // Compile and test against a lower Jackson version to ensure we're compatible with it. Note that
+        // we generally support 2.13.4, but test against 2.14.0 because 2.13.4 has some annoying (but
+        // niche) bugs (users should upgrade if they encounter them). We publish with a higher version
+        // (see below) to ensure users depend on a secure version by default.
+        force("com.fasterxml.jackson.core:jackson-core:2.14.0")
+        force("com.fasterxml.jackson.core:jackson-databind:2.14.0")
+        force("com.fasterxml.jackson.core:jackson-annotations:2.14.0")
+        force("com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.14.0")
+        force("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.14.0")
+        force("com.fasterxml.jackson.module:jackson-module-kotlin:2.14.0")
     }
 }
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
index 555296c..259dcc0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
@@ -24,6 +24,7 @@ import java.io.InputStream
 import java.time.DateTimeException
 import java.time.LocalDate
 import java.time.LocalDateTime
+import java.time.OffsetDateTime
 import java.time.ZonedDateTime
 import java.time.format.DateTimeFormatter
 import java.time.temporal.ChronoField
@@ -36,7 +37,7 @@ fun jsonMapper(): JsonMapper =
         .addModule(
             SimpleModule()
                 .addSerializer(InputStreamSerializer)
-                .addDeserializer(LocalDateTime::class.java, LenientLocalDateTimeDeserializer())
+                .addDeserializer(OffsetDateTime::class.java, LenientOffsetDateTimeDeserializer())
         )
         .withCoercionConfig(LogicalType.Boolean) {
             it.setCoercion(CoercionInputShape.Integer, CoercionAction.Fail)
@@ -64,6 +65,12 @@ fun jsonMapper(): JsonMapper =
                 .setCoercion(CoercionInputShape.Array, CoercionAction.Fail)
                 .setCoercion(CoercionInputShape.Object, CoercionAction.Fail)
         }
+        .withCoercionConfig(LogicalType.DateTime) {
+            it.setCoercion(CoercionInputShape.Integer, CoercionAction.Fail)
+                .setCoercion(CoercionInputShape.Float, CoercionAction.Fail)
+                .setCoercion(CoercionInputShape.Array, CoercionAction.Fail)
+                .setCoercion(CoercionInputShape.Object, CoercionAction.Fail)
+        }
         .withCoercionConfig(LogicalType.Array) {
             it.setCoercion(CoercionInputShape.Boolean, CoercionAction.Fail)
                 .setCoercion(CoercionInputShape.Integer, CoercionAction.Fail)
@@ -124,10 +131,10 @@ private object InputStreamSerializer : BaseSerializer<InputStream>(InputStream::
 }
 
 /**
- * A deserializer that can deserialize [LocalDateTime] from datetimes, dates, and zoned datetimes.
+ * A deserializer that can deserialize [OffsetDateTime] from datetimes, dates, and zoned datetimes.
  */
-private class LenientLocalDateTimeDeserializer :
-    StdDeserializer<LocalDateTime>(LocalDateTime::class.java) {
+private class LenientOffsetDateTimeDeserializer :
+    StdDeserializer<OffsetDateTime>(OffsetDateTime::class.java) {
 
     companion object {
 
@@ -141,7 +148,7 @@ private class LenientLocalDateTimeDeserializer :
 
     override fun logicalType(): LogicalType = LogicalType.DateTime
 
-    override fun deserialize(p: JsonParser, context: DeserializationContext?): LocalDateTime {
+    override fun deserialize(p: JsonParser, context: DeserializationContext): OffsetDateTime {
         val exceptions = mutableListOf<Exception>()
 
         for (formatter in DATE_TIME_FORMATTERS) {
@@ -149,18 +156,20 @@ private class LenientLocalDateTimeDeserializer :
                 val temporal = formatter.parse(p.text)
 
                 return when {
-                    !temporal.isSupported(ChronoField.HOUR_OF_DAY) ->
-                        LocalDate.from(temporal).atStartOfDay()
-                    !temporal.isSupported(ChronoField.OFFSET_SECONDS) ->
-                        LocalDateTime.from(temporal)
-                    else -> ZonedDateTime.from(temporal).toLocalDateTime()
-                }
+                        !temporal.isSupported(ChronoField.HOUR_OF_DAY) ->
+                            LocalDate.from(temporal).atStartOfDay()
+                        !temporal.isSupported(ChronoField.OFFSET_SECONDS) ->
+                            LocalDateTime.from(temporal)
+                        else -> ZonedDateTime.from(temporal).toLocalDateTime()
+                    }
+                    .atZone(context.timeZone.toZoneId())
+                    .toOffsetDateTime()
             } catch (e: DateTimeException) {
                 exceptions.add(e)
             }
         }
 
-        throw JsonParseException(p, "Cannot parse `LocalDateTime` from value: ${p.text}").apply {
+        throw JsonParseException(p, "Cannot parse `OffsetDateTime` from value: ${p.text}").apply {
             exceptions.forEach { addSuppressed(it) }
         }
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
index a6a39a5..68e7cd1 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
@@ -3,7 +3,7 @@ package com.blooio.api.core
 import com.fasterxml.jackson.annotation.JsonProperty
 import com.fasterxml.jackson.databind.exc.MismatchedInputException
 import com.fasterxml.jackson.module.kotlin.readValue
-import java.time.LocalDateTime
+import java.time.OffsetDateTime
 import kotlin.reflect.KClass
 import org.assertj.core.api.Assertions.assertThat
 import org.assertj.core.api.Assertions.catchThrowable
@@ -58,14 +58,6 @@ internal class ObjectMappersTest {
                     LONG to DOUBLE,
                     LONG to INTEGER,
                     CLASS to MAP,
-                    // These aren't actually valid, but coercion configs don't work for String until
-                    // v2.14.0: https://github.com/FasterXML/jackson-databind/issues/3240
-                    // We currently test on v2.13.4.
-                    BOOLEAN to STRING,
-                    FLOAT to STRING,
-                    DOUBLE to STRING,
-                    INTEGER to STRING,
-                    LONG to STRING,
                 )
         }
     }
@@ -84,7 +76,7 @@ internal class ObjectMappersTest {
         }
     }
 
-    enum class LenientLocalDateTimeTestCase(val string: String) {
+    enum class LenientOffsetDateTimeTestCase(val string: String) {
         DATE("1998-04-21"),
         DATE_TIME("1998-04-21T04:00:00"),
         ZONED_DATE_TIME_1("1998-04-21T04:00:00+03:00"),
@@ -93,10 +85,10 @@ internal class ObjectMappersTest {
 
     @ParameterizedTest
     @EnumSource
-    fun readLocalDateTime_lenient(testCase: LenientLocalDateTimeTestCase) {
+    fun readOffsetDateTime_lenient(testCase: LenientOffsetDateTimeTestCase) {
         val jsonMapper = jsonMapper()
         val json = jsonMapper.writeValueAsString(testCase.string)
 
-        assertDoesNotThrow { jsonMapper().readValue<LocalDateTime>(json) }
+        assertDoesNotThrow { jsonMapper().readValue<OffsetDateTime>(json) }
     }
 }
diff --git a/blooio-java-proguard-test/build.gradle.kts b/blooio-java-proguard-test/build.gradle.kts
index 720f493..732343e 100644
--- a/blooio-java-proguard-test/build.gradle.kts
+++ b/blooio-java-proguard-test/build.gradle.kts
@@ -19,7 +19,7 @@ dependencies {
     testImplementation(kotlin("test"))
     testImplementation("org.junit.jupiter:junit-jupiter-api:5.9.3")
     testImplementation("org.assertj:assertj-core:3.25.3")
-    testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.13.4")
+    testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.14.0")
 }
 
 tasks.shadowJar {

From 24c2d4b5b8e3295a5218d2f999fd796fef269b88 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 05:59:54 +0000
Subject: [PATCH 06/63] chore(internal): improve maven repo docs

---
 scripts/upload-artifacts | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/scripts/upload-artifacts b/scripts/upload-artifacts
index df0c8d9..548d152 100755
--- a/scripts/upload-artifacts
+++ b/scripts/upload-artifacts
@@ -56,12 +56,13 @@ upload_file() {
         # Upload file
         upload_response=$(curl -v -X PUT \
             --retry 5 \
+            --retry-all-errors \
             -D "$tmp_headers" \
             -H "Content-Type: $content_type" \
             --data-binary "@${file_name}" "$signed_url" 2>&1)
 
         if ! echo "$upload_response" | grep -q "HTTP/[0-9.]* 200"; then
-            log_error "Failed upload artifact file" "$tmp_headers" "$upload_response"
+            log_error "Failed to upload artifact file" "$tmp_headers" "$upload_response"
         fi
 
         # Insert small throttle to reduce rate limiting risk
@@ -110,6 +111,10 @@ generate_instructions() {
         url 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'
     }
 }</pre>
+
+    <p>Once you've added the repository, you can include dependencies from it as usual. See your
+    <a href="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/blob/${GITHUB_SHA}/README.md">project README</a>
+    for more details.</p>
 </body>
 </html>
 EOF

From 3ee28c5e8bd033c3d96134fb13903941de2e8735 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:03:53 +0000
Subject: [PATCH 07/63] fix(client): disallow coercion from float to int

---
 .../src/main/kotlin/com/blooio/api/core/ObjectMappers.kt      | 1 +
 .../src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt  | 4 ----
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
index 259dcc0..b6bb175 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
@@ -48,6 +48,7 @@ fun jsonMapper(): JsonMapper =
         }
         .withCoercionConfig(LogicalType.Integer) {
             it.setCoercion(CoercionInputShape.Boolean, CoercionAction.Fail)
+                .setCoercion(CoercionInputShape.Float, CoercionAction.Fail)
                 .setCoercion(CoercionInputShape.String, CoercionAction.Fail)
                 .setCoercion(CoercionInputShape.Array, CoercionAction.Fail)
                 .setCoercion(CoercionInputShape.Object, CoercionAction.Fail)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
index 68e7cd1..9d24494 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
@@ -46,11 +46,7 @@ internal class ObjectMappersTest {
             val VALID_CONVERSIONS =
                 listOf(
                     FLOAT to DOUBLE,
-                    FLOAT to INTEGER,
-                    FLOAT to LONG,
                     DOUBLE to FLOAT,
-                    DOUBLE to INTEGER,
-                    DOUBLE to LONG,
                     INTEGER to FLOAT,
                     INTEGER to DOUBLE,
                     INTEGER to LONG,

From 8cfab13629687564f829968a161b50843d8ddc73 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:04:29 +0000
Subject: [PATCH 08/63] chore(internal): update `actions/checkout` version

---
 .github/workflows/ci.yml               | 6 +++---
 .github/workflows/publish-sonatype.yml | 2 +-
 .github/workflows/release-doctor.yml   | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 66fee98..54ddc37 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -20,7 +20,7 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
         uses: actions/setup-java@v4
@@ -47,7 +47,7 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
         uses: actions/setup-java@v4
@@ -85,7 +85,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
         uses: actions/setup-java@v4
diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
index 11f4929..ca320c6 100644
--- a/.github/workflows/publish-sonatype.yml
+++ b/.github/workflows/publish-sonatype.yml
@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Java
         uses: actions/setup-java@v4
diff --git a/.github/workflows/release-doctor.yml b/.github/workflows/release-doctor.yml
index 53c616f..2d36b26 100644
--- a/.github/workflows/release-doctor.yml
+++ b/.github/workflows/release-doctor.yml
@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'Blooio/blooio-java-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Check release environment
         run: |

From 2ddb8126d441b260c80b9ef3b87a24f9ce20b5be Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:05:51 +0000
Subject: [PATCH 09/63] fix(client): fully respect max retries fix(client):
 send retry count header for max retries 0 chore(internal): depend on packages
 directly in example

---
 .../blooio/api/client/okhttp/OkHttpClient.kt  |  2 ++
 .../api/core/http/RetryingHttpClient.kt       | 20 +++++++++----------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
index 91b0eff..f01ac88 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
@@ -230,6 +230,8 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
         fun build(): OkHttpClient =
             OkHttpClient(
                 okhttp3.OkHttpClient.Builder()
+                    // `RetryingHttpClient` handles retries if the user enabled them.
+                    .retryOnConnectionFailure(false)
                     .connectTimeout(timeout.connect())
                     .readTimeout(timeout.read())
                     .writeTimeout(timeout.write())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
index 6f34419..f261e5f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
@@ -31,10 +31,6 @@ private constructor(
 ) : HttpClient {
 
     override fun execute(request: HttpRequest, requestOptions: RequestOptions): HttpResponse {
-        if (!isRetryable(request) || maxRetries <= 0) {
-            return httpClient.execute(request, requestOptions)
-        }
-
         var modifiedRequest = maybeAddIdempotencyHeader(request)
 
         // Don't send the current retry count in the headers if the caller set their own value.
@@ -48,6 +44,10 @@ private constructor(
                 modifiedRequest = setRetryCountHeader(modifiedRequest, retries)
             }
 
+            if (!isRetryable(modifiedRequest)) {
+                return httpClient.execute(modifiedRequest, requestOptions)
+            }
+
             val response =
                 try {
                     val response = httpClient.execute(modifiedRequest, requestOptions)
@@ -75,10 +75,6 @@ private constructor(
         request: HttpRequest,
         requestOptions: RequestOptions,
     ): CompletableFuture<HttpResponse> {
-        if (!isRetryable(request) || maxRetries <= 0) {
-            return httpClient.executeAsync(request, requestOptions)
-        }
-
         val modifiedRequest = maybeAddIdempotencyHeader(request)
 
         // Don't send the current retry count in the headers if the caller set their own value.
@@ -94,8 +90,12 @@ private constructor(
             val requestWithRetryCount =
                 if (shouldSendRetryCount) setRetryCountHeader(request, retries) else request
 
-            return httpClient
-                .executeAsync(requestWithRetryCount, requestOptions)
+            val responseFuture = httpClient.executeAsync(requestWithRetryCount, requestOptions)
+            if (!isRetryable(requestWithRetryCount)) {
+                return responseFuture
+            }
+
+            return responseFuture
                 .handleAsync(
                     fun(
                         response: HttpResponse?,

From 67eb04e66d48b47097af4e8d66f093688ff1f8ef Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 17 Jan 2026 06:06:37 +0000
Subject: [PATCH 10/63] chore(ci): upgrade `actions/setup-java`

---
 .github/workflows/ci.yml               | 6 +++---
 .github/workflows/publish-sonatype.yml | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 54ddc37..7db322c 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -23,7 +23,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
@@ -50,7 +50,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
@@ -88,7 +88,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |
diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
index ca320c6..2d81e3a 100644
--- a/.github/workflows/publish-sonatype.yml
+++ b/.github/workflows/publish-sonatype.yml
@@ -17,7 +17,7 @@ jobs:
       - uses: actions/checkout@v6
 
       - name: Set up Java
-        uses: actions/setup-java@v4
+        uses: actions/setup-java@v5
         with:
           distribution: temurin
           java-version: |

From 025972007906b16f60bb8dc09ff3433c752f4be0 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 22 Jan 2026 04:18:44 +0000
Subject: [PATCH 11/63] chore(internal): update maven repo doc to include
 authentication

---
 scripts/upload-artifacts | 64 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 59 insertions(+), 5 deletions(-)

diff --git a/scripts/upload-artifacts b/scripts/upload-artifacts
index 548d152..10f3c70 100755
--- a/scripts/upload-artifacts
+++ b/scripts/upload-artifacts
@@ -96,8 +96,52 @@ generate_instructions() {
     <h1>Stainless SDK Maven Repository</h1>
     <p>This is the Maven repository for your Stainless Java SDK build.</p>
 
-    <h1>Directions</h1>
-    <p>To use the uploaded Maven repository, add the following to your project's <code>pom.xml</code>:</p>
+    <h2>Project configuration</h2>
+
+    <p>The details depend on whether you're using Maven or Gradle as your build tool.</p>
+
+    <h3>Maven</h3>
+
+    <p>Add the following to your project's <code>pom.xml</code>:</p>
+    <pre>&lt;repositories&gt;
+    &lt;repository&gt;
+        &lt;id&gt;stainless-sdk-repo&lt;/id&gt;
+        &lt;url&gt;https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn&lt;/url&gt;
+    &lt;/repository&gt;
+&lt;/repositories&gt;</pre>
+
+    <h3>Gradle</h3>
+    <p>Add the following to your <code>build.gradle</code> file:</p>
+    <pre>repositories {
+    maven {
+        url "https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn"
+    }
+}</pre>
+
+    <details>
+    <summary><h3 style="display:inline-block">Configuring authentication (if required)<h3></summary>
+
+    <p>Some accounts may require authentication to access the repository. If so, use the
+    following instructions, replacing <code>YOUR_STAINLESS_API_TOKEN</code> with your actual token.</p>
+
+    <h3>Maven with authentication</h3>
+
+    <p>First, ensure you have the following in your Maven <code>settings.xml</code> for repo authentication:</p>
+    <pre>&lt;servers&gt;
+    &lt;server&gt;
+        &lt;id&gt;stainless-sdk-repo&lt;/id&gt;
+        &lt;configuration&gt;
+            &lt;httpHeaders&gt;
+                &lt;property&gt;
+                    &lt;name&gt;Authorization&lt;/name&gt;
+                    &lt;value&gt;Bearer YOUR_STAINLESS_API_TOKEN&lt;/value&gt;
+                &lt;/property&gt;
+            &lt;/httpHeaders&gt;
+        &lt;/configuration&gt;
+    &lt;/server&gt;
+&lt;/servers&gt;</pre>
+
+    <p>Then, add the following to your project's <code>pom.xml</code>:</p>
     <pre>&lt;repositories&gt;
     &lt;repository&gt;
         &lt;id&gt;stainless-sdk-repo&lt;/id&gt;
@@ -105,14 +149,24 @@ generate_instructions() {
     &lt;/repository&gt;
 &lt;/repositories&gt;</pre>
 
-    <p>If you're using Gradle, add the following to your <code>build.gradle</code> file:</p>
+    <h3>Gradle with authentication</h3>
+    <p>Add the following to your <code>build.gradle</code> file:</p>
     <pre>repositories {
     maven {
-        url 'https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn'
+        url "https://pkg.stainless.com/s/${PROJECT}/${SHA}/mvn"
+        credentials(HttpHeaderCredentials) {
+            name = "Authorization"
+            value = "Bearer YOUR_STAINLESS_API_TOKEN"
+        }
+        authentication {
+            header(HttpHeaderAuthentication)
+        }
     }
 }</pre>
+    </details>
 
-    <p>Once you've added the repository, you can include dependencies from it as usual. See your
+    <h2>Using the repository</h2>
+    <p>Once you've configured the repository, you can include dependencies from it as usual. See your
     <a href="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/blob/${GITHUB_SHA}/README.md">project README</a>
     for more details.</p>
 </body>

From f6d45cddc950b7443fb661d4804c4986ef89c187 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 22 Jan 2026 04:19:24 +0000
Subject: [PATCH 12/63] feat(client): send `X-Stainless-Kotlin-Version` header

---
 .../src/main/kotlin/com/blooio/api/core/ClientOptions.kt         | 1 +
 1 file changed, 1 insertion(+)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
index 815c3e2..5d2f3a9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
@@ -404,6 +404,7 @@ private constructor(
             headers.put("X-Stainless-Package-Version", getPackageVersion())
             headers.put("X-Stainless-Runtime", "JRE")
             headers.put("X-Stainless-Runtime-Version", getJavaVersion())
+            headers.put("X-Stainless-Kotlin-Version", KotlinVersion.CURRENT.toString())
             apiKey.let {
                 if (!it.isEmpty()) {
                     headers.put("Authorization", "Bearer $it")

From a636226690a94e032e7b7d6e8fcf9d2f373bcfc3 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 23 Jan 2026 05:45:03 +0000
Subject: [PATCH 13/63] docs: add comment for arbitrary value fields

---
 .../blooio/api/models/me/MeRetrieveResponse.kt | 18 ++++++++++++++++--
 .../models/messages/MessageRetrieveResponse.kt |  9 ++++++++-
 .../api/models/messages/MessageSendParams.kt   | 18 ++++++++++++++++--
 3 files changed, 40 insertions(+), 5 deletions(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
index 05b1a17..fb7c24c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
@@ -71,7 +71,14 @@ private constructor(
     fun integrationDetails(): Optional<IntegrationDetails> =
         integrationDetails.getOptional("integration_details")
 
-    /** Custom metadata associated with the API key. */
+    /**
+     * Custom metadata associated with the API key.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = meRetrieveResponse.metadata().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
 
     /**
@@ -614,7 +621,14 @@ private constructor(
         fun customerWebhookUrl(): Optional<String> =
             customerWebhookUrl.getOptional("customer_webhook_url")
 
-        /** Integration-specific metadata. */
+        /**
+         * Integration-specific metadata.
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = integrationDetails.metadata().convert(MyClass.class);
+         * ```
+         */
         @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt
index 38a65f1..59a17ee 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt
@@ -97,7 +97,14 @@ private constructor(
      */
     fun messageId(): Optional<String> = messageId.getOptional("message_id")
 
-    /** Original metadata provided plus system generated fields. */
+    /**
+     * Original metadata provided plus system generated fields.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = messageRetrieveResponse.metadata().convert(MyClass.class);
+     * ```
+     */
     @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt
index cf098d3..abccdd8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt
@@ -56,7 +56,14 @@ private constructor(
      */
     fun attachments(): Optional<List<String>> = body.attachments()
 
-    /** Arbitrary key/value pairs to associate with the message. */
+    /**
+     * Arbitrary key/value pairs to associate with the message.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = messageSendParams.metadata().convert(MyClass.class);
+     * ```
+     */
     fun _metadata(): JsonValue = body._metadata()
 
     /**
@@ -377,7 +384,14 @@ private constructor(
          */
         fun attachments(): Optional<List<String>> = attachments.getOptional("attachments")
 
-        /** Arbitrary key/value pairs to associate with the message. */
+        /**
+         * Arbitrary key/value pairs to associate with the message.
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = body.metadata().convert(MyClass.class);
+         * ```
+         */
         @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
 
         /**

From d3c3b9c5e26275edbc5897780f4338d88e65eb7d Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 23 Jan 2026 05:45:48 +0000
Subject: [PATCH 14/63] chore(internal): correct cache invalidation for
 `SKIP_MOCK_TESTS`

---
 buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts b/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts
index 42465f2..2ae7785 100644
--- a/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts
@@ -33,6 +33,9 @@ kotlin {
 tasks.withType<Test>().configureEach {
     systemProperty("junit.jupiter.execution.parallel.enabled", true)
     systemProperty("junit.jupiter.execution.parallel.mode.default", "concurrent")
+
+    // `SKIP_MOCK_TESTS` affects which tests run so it must be added as input for proper cache invalidation.
+    inputs.property("skipMockTests", System.getenv("SKIP_MOCK_TESTS")).optional(true)
 }
 
 val ktfmt by configurations.creating

From 573fcaf71930c387314fb18231334b542df8a47f Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 23 Jan 2026 05:48:29 +0000
Subject: [PATCH 15/63] fix(client): preserve time zone in lenient date-time
 parsing

---
 .../com/blooio/api/core/ObjectMappers.kt      | 19 +++++----
 .../com/blooio/api/core/ObjectMappersTest.kt  | 41 +++++++++++++++----
 2 files changed, 44 insertions(+), 16 deletions(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
index b6bb175..47b2466 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
@@ -25,7 +25,7 @@ import java.time.DateTimeException
 import java.time.LocalDate
 import java.time.LocalDateTime
 import java.time.OffsetDateTime
-import java.time.ZonedDateTime
+import java.time.ZoneId
 import java.time.format.DateTimeFormatter
 import java.time.temporal.ChronoField
 
@@ -157,14 +157,15 @@ private class LenientOffsetDateTimeDeserializer :
                 val temporal = formatter.parse(p.text)
 
                 return when {
-                        !temporal.isSupported(ChronoField.HOUR_OF_DAY) ->
-                            LocalDate.from(temporal).atStartOfDay()
-                        !temporal.isSupported(ChronoField.OFFSET_SECONDS) ->
-                            LocalDateTime.from(temporal)
-                        else -> ZonedDateTime.from(temporal).toLocalDateTime()
-                    }
-                    .atZone(context.timeZone.toZoneId())
-                    .toOffsetDateTime()
+                    !temporal.isSupported(ChronoField.HOUR_OF_DAY) ->
+                        LocalDate.from(temporal)
+                            .atStartOfDay()
+                            .atZone(ZoneId.of("UTC"))
+                            .toOffsetDateTime()
+                    !temporal.isSupported(ChronoField.OFFSET_SECONDS) ->
+                        LocalDateTime.from(temporal).atZone(ZoneId.of("UTC")).toOffsetDateTime()
+                    else -> OffsetDateTime.from(temporal)
+                }
             } catch (e: DateTimeException) {
                 exceptions.add(e)
             }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
index 9d24494..a787581 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ObjectMappersTest.kt
@@ -3,12 +3,14 @@ package com.blooio.api.core
 import com.fasterxml.jackson.annotation.JsonProperty
 import com.fasterxml.jackson.databind.exc.MismatchedInputException
 import com.fasterxml.jackson.module.kotlin.readValue
+import java.time.LocalDate
+import java.time.LocalTime
 import java.time.OffsetDateTime
+import java.time.ZoneOffset
 import kotlin.reflect.KClass
 import org.assertj.core.api.Assertions.assertThat
 import org.assertj.core.api.Assertions.catchThrowable
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.assertDoesNotThrow
 import org.junit.jupiter.params.ParameterizedTest
 import org.junit.jupiter.params.provider.EnumSource
 import org.junitpioneer.jupiter.cartesian.CartesianTest
@@ -72,11 +74,34 @@ internal class ObjectMappersTest {
         }
     }
 
-    enum class LenientOffsetDateTimeTestCase(val string: String) {
-        DATE("1998-04-21"),
-        DATE_TIME("1998-04-21T04:00:00"),
-        ZONED_DATE_TIME_1("1998-04-21T04:00:00+03:00"),
-        ZONED_DATE_TIME_2("1998-04-21T04:00:00Z"),
+    enum class LenientOffsetDateTimeTestCase(
+        val string: String,
+        val expectedOffsetDateTime: OffsetDateTime,
+    ) {
+        DATE(
+            "1998-04-21",
+            expectedOffsetDateTime =
+                OffsetDateTime.of(LocalDate.of(1998, 4, 21), LocalTime.of(0, 0), ZoneOffset.UTC),
+        ),
+        DATE_TIME(
+            "1998-04-21T04:00:00",
+            expectedOffsetDateTime =
+                OffsetDateTime.of(LocalDate.of(1998, 4, 21), LocalTime.of(4, 0), ZoneOffset.UTC),
+        ),
+        ZONED_DATE_TIME_1(
+            "1998-04-21T04:00:00+03:00",
+            expectedOffsetDateTime =
+                OffsetDateTime.of(
+                    LocalDate.of(1998, 4, 21),
+                    LocalTime.of(4, 0),
+                    ZoneOffset.ofHours(3),
+                ),
+        ),
+        ZONED_DATE_TIME_2(
+            "1998-04-21T04:00:00Z",
+            expectedOffsetDateTime =
+                OffsetDateTime.of(LocalDate.of(1998, 4, 21), LocalTime.of(4, 0), ZoneOffset.UTC),
+        ),
     }
 
     @ParameterizedTest
@@ -85,6 +110,8 @@ internal class ObjectMappersTest {
         val jsonMapper = jsonMapper()
         val json = jsonMapper.writeValueAsString(testCase.string)
 
-        assertDoesNotThrow { jsonMapper().readValue<OffsetDateTime>(json) }
+        val offsetDateTime = jsonMapper().readValue<OffsetDateTime>(json)
+
+        assertThat(offsetDateTime).isEqualTo(testCase.expectedOffsetDateTime)
     }
 }

From a32a19dcfbeff710c7c6c0b4daaa8ed98107294a Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 24 Jan 2026 05:31:26 +0000
Subject: [PATCH 16/63] chore(ci): upgrade `actions/github-script`

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7db322c..2915cd2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -67,7 +67,7 @@ jobs:
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/blooio-java'
         id: github-oidc
-        uses: actions/github-script@v6
+        uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 

From a8da67050906f36094fdf4cf4fb278d6abe01f58 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 31 Jan 2026 06:45:51 +0000
Subject: [PATCH 17/63] chore(internal): allow passing args to `./scripts/test`

---
 scripts/build | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/build b/scripts/build
index f406348..16a2b00 100755
--- a/scripts/build
+++ b/scripts/build
@@ -5,4 +5,4 @@ set -e
 cd "$(dirname "$0")/.."
 
 echo "==> Building classes"
-./gradlew build testClasses -x test
+./gradlew build testClasses "$@" -x test

From 0c278a7a62ba05270a09d4ad6d4e0c1eadebd280 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 7 Feb 2026 08:04:15 +0000
Subject: [PATCH 18/63] chore(internal): upgrade AssertJ

---
 blooio-java-client-okhttp/build.gradle.kts | 2 +-
 blooio-java-core/build.gradle.kts          | 2 +-
 blooio-java-proguard-test/build.gradle.kts | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/blooio-java-client-okhttp/build.gradle.kts b/blooio-java-client-okhttp/build.gradle.kts
index 3449d62..e556e32 100644
--- a/blooio-java-client-okhttp/build.gradle.kts
+++ b/blooio-java-client-okhttp/build.gradle.kts
@@ -10,6 +10,6 @@ dependencies {
     implementation("com.squareup.okhttp3:logging-interceptor:4.12.0")
 
     testImplementation(kotlin("test"))
-    testImplementation("org.assertj:assertj-core:3.25.3")
+    testImplementation("org.assertj:assertj-core:3.27.7")
     testImplementation("com.github.tomakehurst:wiremock-jre8:2.35.2")
 }
diff --git a/blooio-java-core/build.gradle.kts b/blooio-java-core/build.gradle.kts
index 8a19d0f..f647be8 100644
--- a/blooio-java-core/build.gradle.kts
+++ b/blooio-java-core/build.gradle.kts
@@ -33,7 +33,7 @@ dependencies {
     testImplementation(kotlin("test"))
     testImplementation(project(":blooio-java-client-okhttp"))
     testImplementation("com.github.tomakehurst:wiremock-jre8:2.35.2")
-    testImplementation("org.assertj:assertj-core:3.25.3")
+    testImplementation("org.assertj:assertj-core:3.27.7")
     testImplementation("org.junit.jupiter:junit-jupiter-api:5.9.3")
     testImplementation("org.junit.jupiter:junit-jupiter-params:5.9.3")
     testImplementation("org.junit-pioneer:junit-pioneer:1.9.1")
diff --git a/blooio-java-proguard-test/build.gradle.kts b/blooio-java-proguard-test/build.gradle.kts
index 732343e..34ff8aa 100644
--- a/blooio-java-proguard-test/build.gradle.kts
+++ b/blooio-java-proguard-test/build.gradle.kts
@@ -18,7 +18,7 @@ dependencies {
     testImplementation(project(":blooio-java"))
     testImplementation(kotlin("test"))
     testImplementation("org.junit.jupiter:junit-jupiter-api:5.9.3")
-    testImplementation("org.assertj:assertj-core:3.25.3")
+    testImplementation("org.assertj:assertj-core:3.27.7")
     testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.14.0")
 }
 

From d5926e0c1019ba3d777459623b0b847a286c7b97 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 18 Feb 2026 05:29:34 +0000
Subject: [PATCH 19/63] chore(internal): codegen related update

---
 .../com/blooio/api/TestServerExtension.kt       | 17 ++---------------
 1 file changed, 2 insertions(+), 15 deletions(-)

diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
index c92a329..240b2e0 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
@@ -15,25 +15,12 @@ class TestServerExtension : BeforeAllCallback, ExecutionCondition {
         } catch (e: Exception) {
             throw RuntimeException(
                 """
-                The test suite will not run without a mock Prism server running against your OpenAPI spec.
+                The test suite will not run without a mock server running against your OpenAPI spec.
 
                 You can set the environment variable `SKIP_MOCK_TESTS` to `true` to skip running any tests
                 that require the mock server.
 
-                To fix:
-
-                1. Install Prism (requires Node 16+):
-
-                  With npm:
-                    $ npm install -g @stoplight/prism-cli
-
-                  With yarn:
-                    $ yarn global add @stoplight/prism-cli
-
-                2. Run the mock server
-
-                  To run the server, pass in the path of your OpenAPI spec to the prism command:
-                    $ prism mock path/to/your.openapi.yml
+                To fix run `./scripts/mock` in a separate terminal.
                 """
                     .trimIndent(),
                 e,

From cdac773c08fdbc1cfa3ddc812efaa40fb2da4a90 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 19 Feb 2026 05:29:07 +0000
Subject: [PATCH 20/63] chore(internal): codegen related update

---
 README.md                                     | 19 ++++++++
 .../api/client/okhttp/BlooioOkHttpClient.kt   | 44 +++++++++++++++++++
 .../client/okhttp/BlooioOkHttpClientAsync.kt  | 44 +++++++++++++++++++
 .../blooio/api/client/okhttp/OkHttpClient.kt  | 44 ++++++++++++++++++-
 4 files changed, 150 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2fc28b7..1215874 100644
--- a/README.md
+++ b/README.md
@@ -333,6 +333,25 @@ BlooioClient client = BlooioOkHttpClient.builder()
     .build();
 ```
 
+### Connection pooling
+
+To customize the underlying OkHttp connection pool, configure the client using the `maxIdleConnections` and `keepAliveDuration` methods:
+
+```java
+import com.blooio.api.client.BlooioClient;
+import com.blooio.api.client.okhttp.BlooioOkHttpClient;
+import java.time.Duration;
+
+BlooioClient client = BlooioOkHttpClient.builder()
+    .fromEnv()
+    // If `maxIdleConnections` is set, then `keepAliveDuration` must be set, and vice versa.
+    .maxIdleConnections(10)
+    .keepAliveDuration(Duration.ofMinutes(2))
+    .build();
+```
+
+If both options are unset, OkHttp's default connection pool settings are used.
+
 ### HTTPS
 
 > [!NOTE]
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index e4722d3..c409e2c 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -47,6 +47,8 @@ class BlooioOkHttpClient private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var maxIdleConnections: Int? = null
+        private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
         private var hostnameVerifier: HostnameVerifier? = null
@@ -75,6 +77,46 @@ class BlooioOkHttpClient private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * The maximum number of idle connections kept by the underlying OkHttp connection pool.
+         *
+         * If this is set, then [keepAliveDuration] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun maxIdleConnections(maxIdleConnections: Int?) = apply {
+            this.maxIdleConnections = maxIdleConnections
+        }
+
+        /**
+         * Alias for [Builder.maxIdleConnections].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxIdleConnections(maxIdleConnections: Int) =
+            maxIdleConnections(maxIdleConnections as Int?)
+
+        /**
+         * Alias for calling [Builder.maxIdleConnections] with `maxIdleConnections.orElse(null)`.
+         */
+        fun maxIdleConnections(maxIdleConnections: Optional<Int>) =
+            maxIdleConnections(maxIdleConnections.getOrNull())
+
+        /**
+         * The keep-alive duration for idle connections in the underlying OkHttp connection pool.
+         *
+         * If this is set, then [maxIdleConnections] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun keepAliveDuration(keepAliveDuration: Duration?) = apply {
+            this.keepAliveDuration = keepAliveDuration
+        }
+
+        /** Alias for calling [Builder.keepAliveDuration] with `keepAliveDuration.orElse(null)`. */
+        fun keepAliveDuration(keepAliveDuration: Optional<Duration>) =
+            keepAliveDuration(keepAliveDuration.getOrNull())
+
         /**
          * The socket factory used to secure HTTPS connections.
          *
@@ -318,6 +360,8 @@ class BlooioOkHttpClient private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .maxIdleConnections(maxIdleConnections)
+                            .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
                             .sslSocketFactory(sslSocketFactory)
                             .trustManager(trustManager)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index 3572e6a..ccc14ff 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -47,6 +47,8 @@ class BlooioOkHttpClientAsync private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var maxIdleConnections: Int? = null
+        private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
         private var hostnameVerifier: HostnameVerifier? = null
@@ -75,6 +77,46 @@ class BlooioOkHttpClientAsync private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * The maximum number of idle connections kept by the underlying OkHttp connection pool.
+         *
+         * If this is set, then [keepAliveDuration] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun maxIdleConnections(maxIdleConnections: Int?) = apply {
+            this.maxIdleConnections = maxIdleConnections
+        }
+
+        /**
+         * Alias for [Builder.maxIdleConnections].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxIdleConnections(maxIdleConnections: Int) =
+            maxIdleConnections(maxIdleConnections as Int?)
+
+        /**
+         * Alias for calling [Builder.maxIdleConnections] with `maxIdleConnections.orElse(null)`.
+         */
+        fun maxIdleConnections(maxIdleConnections: Optional<Int>) =
+            maxIdleConnections(maxIdleConnections.getOrNull())
+
+        /**
+         * The keep-alive duration for idle connections in the underlying OkHttp connection pool.
+         *
+         * If this is set, then [maxIdleConnections] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun keepAliveDuration(keepAliveDuration: Duration?) = apply {
+            this.keepAliveDuration = keepAliveDuration
+        }
+
+        /** Alias for calling [Builder.keepAliveDuration] with `keepAliveDuration.orElse(null)`. */
+        fun keepAliveDuration(keepAliveDuration: Optional<Duration>) =
+            keepAliveDuration(keepAliveDuration.getOrNull())
+
         /**
          * The socket factory used to secure HTTPS connections.
          *
@@ -318,6 +360,8 @@ class BlooioOkHttpClientAsync private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .maxIdleConnections(maxIdleConnections)
+                            .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
                             .sslSocketFactory(sslSocketFactory)
                             .trustManager(trustManager)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
index f01ac88..ccb1cdf 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
@@ -16,11 +16,13 @@ import java.time.Duration
 import java.util.concurrent.CancellationException
 import java.util.concurrent.CompletableFuture
 import java.util.concurrent.ExecutorService
+import java.util.concurrent.TimeUnit
 import javax.net.ssl.HostnameVerifier
 import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.X509TrustManager
 import okhttp3.Call
 import okhttp3.Callback
+import okhttp3.ConnectionPool
 import okhttp3.Dispatcher
 import okhttp3.HttpUrl.Companion.toHttpUrl
 import okhttp3.MediaType
@@ -33,7 +35,7 @@ import okhttp3.logging.HttpLoggingInterceptor
 import okio.BufferedSink
 
 class OkHttpClient
-private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClient) : HttpClient {
+internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClient) : HttpClient {
 
     override fun execute(request: HttpRequest, requestOptions: RequestOptions): HttpResponse {
         val call = newCall(request, requestOptions)
@@ -200,6 +202,8 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
 
         private var timeout: Timeout = Timeout.default()
         private var proxy: Proxy? = null
+        private var maxIdleConnections: Int? = null
+        private var keepAliveDuration: Duration? = null
         private var dispatcherExecutorService: ExecutorService? = null
         private var sslSocketFactory: SSLSocketFactory? = null
         private var trustManager: X509TrustManager? = null
@@ -211,6 +215,28 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
 
         fun proxy(proxy: Proxy?) = apply { this.proxy = proxy }
 
+        /**
+         * Sets the maximum number of idle connections kept by the underlying [ConnectionPool].
+         *
+         * If this is set, then [keepAliveDuration] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun maxIdleConnections(maxIdleConnections: Int?) = apply {
+            this.maxIdleConnections = maxIdleConnections
+        }
+
+        /**
+         * Sets the keep-alive duration for idle connections in the underlying [ConnectionPool].
+         *
+         * If this is set, then [maxIdleConnections] must also be set.
+         *
+         * If unset, then OkHttp's default is used.
+         */
+        fun keepAliveDuration(keepAliveDuration: Duration?) = apply {
+            this.keepAliveDuration = keepAliveDuration
+        }
+
         fun dispatcherExecutorService(dispatcherExecutorService: ExecutorService?) = apply {
             this.dispatcherExecutorService = dispatcherExecutorService
         }
@@ -240,6 +266,22 @@ private constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClien
                     .apply {
                         dispatcherExecutorService?.let { dispatcher(Dispatcher(it)) }
 
+                        val maxIdleConnections = maxIdleConnections
+                        val keepAliveDuration = keepAliveDuration
+                        if (maxIdleConnections != null && keepAliveDuration != null) {
+                            connectionPool(
+                                ConnectionPool(
+                                    maxIdleConnections,
+                                    keepAliveDuration.toNanos(),
+                                    TimeUnit.NANOSECONDS,
+                                )
+                            )
+                        } else {
+                            check((maxIdleConnections != null) == (keepAliveDuration != null)) {
+                                "Both or none of `maxIdleConnections` and `keepAliveDuration` must be set, but only one was set"
+                            }
+                        }
+
                         val sslSocketFactory = sslSocketFactory
                         val trustManager = trustManager
                         if (sslSocketFactory != null && trustManager != null) {

From 2720979743e942537ebb7314e83b8f64bc8e3455 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 20 Feb 2026 06:38:50 +0000
Subject: [PATCH 21/63] chore(internal): remove mock server code

---
 .../com/blooio/api/TestServerExtension.kt     | 49 -------------------
 .../services/async/BatchServiceAsyncTest.kt   | 27 ++--------
 .../services/async/ContactServiceAsyncTest.kt |  9 +---
 .../api/services/async/MeServiceAsyncTest.kt  |  9 +---
 .../services/async/MessageServiceAsyncTest.kt | 27 ++--------
 .../async/config/WebhookServiceAsyncTest.kt   | 15 +-----
 .../api/services/blocking/BatchServiceTest.kt | 27 ++--------
 .../services/blocking/ContactServiceTest.kt   |  9 +---
 .../api/services/blocking/MeServiceTest.kt    |  9 +---
 .../services/blocking/MessageServiceTest.kt   | 27 ++--------
 .../blocking/config/WebhookServiceTest.kt     | 15 +-----
 scripts/mock                                  | 41 ----------------
 scripts/test                                  | 46 -----------------
 13 files changed, 24 insertions(+), 286 deletions(-)
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
 delete mode 100755 scripts/mock

diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
deleted file mode 100644
index 240b2e0..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/TestServerExtension.kt
+++ /dev/null
@@ -1,49 +0,0 @@
-package com.blooio.api
-
-import java.lang.RuntimeException
-import java.net.URL
-import org.junit.jupiter.api.extension.BeforeAllCallback
-import org.junit.jupiter.api.extension.ConditionEvaluationResult
-import org.junit.jupiter.api.extension.ExecutionCondition
-import org.junit.jupiter.api.extension.ExtensionContext
-
-class TestServerExtension : BeforeAllCallback, ExecutionCondition {
-
-    override fun beforeAll(context: ExtensionContext?) {
-        try {
-            URL(BASE_URL).openConnection().connect()
-        } catch (e: Exception) {
-            throw RuntimeException(
-                """
-                The test suite will not run without a mock server running against your OpenAPI spec.
-
-                You can set the environment variable `SKIP_MOCK_TESTS` to `true` to skip running any tests
-                that require the mock server.
-
-                To fix run `./scripts/mock` in a separate terminal.
-                """
-                    .trimIndent(),
-                e,
-            )
-        }
-    }
-
-    override fun evaluateExecutionCondition(context: ExtensionContext): ConditionEvaluationResult {
-        return if (System.getenv(SKIP_TESTS_ENV).toBoolean()) {
-            ConditionEvaluationResult.disabled(
-                "Environment variable $SKIP_TESTS_ENV is set to true"
-            )
-        } else {
-            ConditionEvaluationResult.enabled(
-                "Environment variable $SKIP_TESTS_ENV is not set to true"
-            )
-        }
-    }
-
-    companion object {
-
-        val BASE_URL = System.getenv("TEST_API_BASE_URL") ?: "http://localhost:4010"
-
-        const val SKIP_TESTS_ENV: String = "SKIP_MOCK_TESTS"
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
index 25bef59..f71204f 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.async
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class BatchServiceAsyncTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun create() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val batchServiceAsync = client.batches()
 
         val future = batchServiceAsync.create()
@@ -29,11 +22,7 @@ internal class BatchServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val batchServiceAsync = client.batches()
 
         val future = batchServiceAsync.retrieve("batchId")
@@ -44,11 +33,7 @@ internal class BatchServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun listMessages() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val batchServiceAsync = client.batches()
 
         val future = batchServiceAsync.listMessages("batchId")
@@ -59,11 +44,7 @@ internal class BatchServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieveStatus() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val batchServiceAsync = client.batches()
 
         val future = batchServiceAsync.retrieveStatus("batchId")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
index 91bdb19..ebf5ff2 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.async
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class ContactServiceAsyncTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun checkCapabilities() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val contactServiceAsync = client.contacts()
 
         val responseFuture = contactServiceAsync.checkCapabilities("contact")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
index 4e391ee..77b2fea 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.async
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class MeServiceAsyncTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val meServiceAsync = client.me()
 
         val meFuture = meServiceAsync.retrieve()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
index 88d904c..0210e70 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
@@ -2,25 +2,18 @@
 
 package com.blooio.api.services.async
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
 import com.blooio.api.core.JsonValue
 import com.blooio.api.models.messages.MessageSendParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class MessageServiceAsyncTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val messageServiceAsync = client.messages()
 
         val messageFuture = messageServiceAsync.retrieve("messageId")
@@ -32,11 +25,7 @@ internal class MessageServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun cancel() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val messageServiceAsync = client.messages()
 
         val responseFuture = messageServiceAsync.cancel("messageId")
@@ -48,11 +37,7 @@ internal class MessageServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun getStatus() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val messageServiceAsync = client.messages()
 
         val responseFuture = messageServiceAsync.getStatus("messageId")
@@ -64,11 +49,7 @@ internal class MessageServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun send() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val messageServiceAsync = client.messages()
 
         val responseFuture =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
index b639375..b29c278 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
@@ -2,24 +2,17 @@
 
 package com.blooio.api.services.async.config
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
 import com.blooio.api.models.config.webhook.WebhookUpdateParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class WebhookServiceAsyncTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val webhookServiceAsync = client.config().webhook()
 
         val webhookFuture = webhookServiceAsync.retrieve()
@@ -31,11 +24,7 @@ internal class WebhookServiceAsyncTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun update() {
-        val client =
-            BlooioOkHttpClientAsync.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val webhookServiceAsync = client.config().webhook()
 
         val webhookFuture =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
index ea136e9..5bd76ac 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.blocking
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class BatchServiceTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun create() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val batchService = client.batches()
 
         batchService.create()
@@ -27,11 +20,7 @@ internal class BatchServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val batchService = client.batches()
 
         batchService.retrieve("batchId")
@@ -40,11 +29,7 @@ internal class BatchServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun listMessages() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val batchService = client.batches()
 
         batchService.listMessages("batchId")
@@ -53,11 +38,7 @@ internal class BatchServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieveStatus() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val batchService = client.batches()
 
         batchService.retrieveStatus("batchId")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
index 1c5eea4..d3a0a4c 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.blocking
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class ContactServiceTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun checkCapabilities() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val contactService = client.contacts()
 
         val response = contactService.checkCapabilities("contact")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
index c41e96c..383b436 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
@@ -2,23 +2,16 @@
 
 package com.blooio.api.services.blocking
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class MeServiceTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val meService = client.me()
 
         val me = meService.retrieve()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
index ae6efb6..734072a 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
@@ -2,25 +2,18 @@
 
 package com.blooio.api.services.blocking
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import com.blooio.api.core.JsonValue
 import com.blooio.api.models.messages.MessageSendParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class MessageServiceTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val messageService = client.messages()
 
         val message = messageService.retrieve("messageId")
@@ -31,11 +24,7 @@ internal class MessageServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun cancel() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val messageService = client.messages()
 
         val response = messageService.cancel("messageId")
@@ -46,11 +35,7 @@ internal class MessageServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun getStatus() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val messageService = client.messages()
 
         val response = messageService.getStatus("messageId")
@@ -61,11 +46,7 @@ internal class MessageServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun send() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val messageService = client.messages()
 
         val response =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
index db48dbf..efad51d 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
@@ -2,24 +2,17 @@
 
 package com.blooio.api.services.blocking.config
 
-import com.blooio.api.TestServerExtension
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import com.blooio.api.models.config.webhook.WebhookUpdateParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
-import org.junit.jupiter.api.extension.ExtendWith
 
-@ExtendWith(TestServerExtension::class)
 internal class WebhookServiceTest {
 
     @Disabled("Prism tests are disabled")
     @Test
     fun retrieve() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val webhookService = client.config().webhook()
 
         val webhook = webhookService.retrieve()
@@ -30,11 +23,7 @@ internal class WebhookServiceTest {
     @Disabled("Prism tests are disabled")
     @Test
     fun update() {
-        val client =
-            BlooioOkHttpClient.builder()
-                .baseUrl(TestServerExtension.BASE_URL)
-                .apiKey("My API Key")
-                .build()
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val webhookService = client.config().webhook()
 
         val webhook =
diff --git a/scripts/mock b/scripts/mock
deleted file mode 100755
index 0b28f6e..0000000
--- a/scripts/mock
+++ /dev/null
@@ -1,41 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-
-cd "$(dirname "$0")/.."
-
-if [[ -n "$1" && "$1" != '--'* ]]; then
-  URL="$1"
-  shift
-else
-  URL="$(grep 'openapi_spec_url' .stats.yml | cut -d' ' -f2)"
-fi
-
-# Check if the URL is empty
-if [ -z "$URL" ]; then
-  echo "Error: No OpenAPI spec path/url provided or found in .stats.yml"
-  exit 1
-fi
-
-echo "==> Starting mock server with URL ${URL}"
-
-# Run prism mock on the given spec
-if [ "$1" == "--daemon" ]; then
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL" &> .prism.log &
-
-  # Wait for server to come online
-  echo -n "Waiting for server"
-  while ! grep -q "✖  fatal\|Prism is listening" ".prism.log" ; do
-    echo -n "."
-    sleep 0.1
-  done
-
-  if grep -q "✖  fatal" ".prism.log"; then
-    cat .prism.log
-    exit 1
-  fi
-
-  echo
-else
-  npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock "$URL"
-fi
diff --git a/scripts/test b/scripts/test
index 047bc1d..904aea6 100755
--- a/scripts/test
+++ b/scripts/test
@@ -4,53 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-NC='\033[0m' # No Color
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
-}
-
-kill_server_on_port() {
-  pids=$(lsof -t -i tcp:"$1" || echo "")
-  if [ "$pids" != "" ]; then
-    kill "$pids"
-    echo "Stopped $pids."
-  fi
-}
-
-function is_overriding_api_base_url() {
-  [ -n "$TEST_API_BASE_URL" ]
-}
-
-if ! is_overriding_api_base_url && ! prism_is_running ; then
-  # When we exit this script, make sure to kill the background mock server process
-  trap 'kill_server_on_port 4010' EXIT
-
-  # Start the dev server
-  ./scripts/mock --daemon
-fi
-
-if is_overriding_api_base_url ; then
-  echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
-  echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
-  echo -e "running against your OpenAPI spec."
-  echo
-  echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
-  echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
-  echo
-
-  exit 1
-else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
-  echo
-fi
 
 echo "==> Running tests"
 ./gradlew test "$@"

From 00e0cf57e1fb18ddcc685aeea1cce58ac6decf0c Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 20 Feb 2026 06:39:30 +0000
Subject: [PATCH 22/63] chore: update mock server docs

---
 .../kotlin/com/blooio/api/services/ServiceParamsTest.kt   | 2 +-
 .../blooio/api/services/async/BatchServiceAsyncTest.kt    | 8 ++++----
 .../blooio/api/services/async/ContactServiceAsyncTest.kt  | 2 +-
 .../com/blooio/api/services/async/MeServiceAsyncTest.kt   | 2 +-
 .../blooio/api/services/async/MessageServiceAsyncTest.kt  | 8 ++++----
 .../api/services/async/config/WebhookServiceAsyncTest.kt  | 4 ++--
 .../com/blooio/api/services/blocking/BatchServiceTest.kt  | 8 ++++----
 .../blooio/api/services/blocking/ContactServiceTest.kt    | 2 +-
 .../com/blooio/api/services/blocking/MeServiceTest.kt     | 2 +-
 .../blooio/api/services/blocking/MessageServiceTest.kt    | 8 ++++----
 .../api/services/blocking/config/WebhookServiceTest.kt    | 4 ++--
 11 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/ServiceParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/ServiceParamsTest.kt
index ac6f723..5964716 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/ServiceParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/ServiceParamsTest.kt
@@ -34,7 +34,7 @@ internal class ServiceParamsTest {
                 .build()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val meService = client.me()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
index f71204f..4c2ef1e 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class BatchServiceAsyncTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun create() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -19,7 +19,7 @@ internal class BatchServiceAsyncTest {
         val response = future.get()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -30,7 +30,7 @@ internal class BatchServiceAsyncTest {
         val response = future.get()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun listMessages() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -41,7 +41,7 @@ internal class BatchServiceAsyncTest {
         val response = future.get()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieveStatus() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
index ebf5ff2..514c6b7 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class ContactServiceAsyncTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun checkCapabilities() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
index 77b2fea..4ccc4ef 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MeServiceAsyncTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class MeServiceAsyncTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
index 0210e70..a738bdc 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
@@ -10,7 +10,7 @@ import org.junit.jupiter.api.Test
 
 internal class MessageServiceAsyncTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -22,7 +22,7 @@ internal class MessageServiceAsyncTest {
         message.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun cancel() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -34,7 +34,7 @@ internal class MessageServiceAsyncTest {
         response.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun getStatus() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -46,7 +46,7 @@ internal class MessageServiceAsyncTest {
         response.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun send() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
index b29c278..c05c0a4 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
@@ -9,7 +9,7 @@ import org.junit.jupiter.api.Test
 
 internal class WebhookServiceAsyncTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
@@ -21,7 +21,7 @@ internal class WebhookServiceAsyncTest {
         webhook.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun update() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
index 5bd76ac..c85ee5d 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class BatchServiceTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun create() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -17,7 +17,7 @@ internal class BatchServiceTest {
         batchService.create()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -26,7 +26,7 @@ internal class BatchServiceTest {
         batchService.retrieve("batchId")
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun listMessages() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -35,7 +35,7 @@ internal class BatchServiceTest {
         batchService.listMessages("batchId")
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieveStatus() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
index d3a0a4c..4d44676 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class ContactServiceTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun checkCapabilities() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
index 383b436..822b9e8 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MeServiceTest.kt
@@ -8,7 +8,7 @@ import org.junit.jupiter.api.Test
 
 internal class MeServiceTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
index 734072a..04c796e 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
@@ -10,7 +10,7 @@ import org.junit.jupiter.api.Test
 
 internal class MessageServiceTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -21,7 +21,7 @@ internal class MessageServiceTest {
         message.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun cancel() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -32,7 +32,7 @@ internal class MessageServiceTest {
         response.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun getStatus() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -43,7 +43,7 @@ internal class MessageServiceTest {
         response.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun send() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
index efad51d..aae8744 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
@@ -9,7 +9,7 @@ import org.junit.jupiter.api.Test
 
 internal class WebhookServiceTest {
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
@@ -20,7 +20,7 @@ internal class WebhookServiceTest {
         webhook.validate()
     }
 
-    @Disabled("Prism tests are disabled")
+    @Disabled("Mock server tests are disabled")
     @Test
     fun update() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()

From d9397764180aeb78502302531fbc19c928fa1ab5 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 24 Feb 2026 07:01:28 +0000
Subject: [PATCH 23/63] chore(internal): codegen related update

---
 blooio-java-core/build.gradle.kts             |   2 -
 .../kotlin/com/blooio/api/core/Properties.kt  |   6 +-
 .../blooio/api/core/http/HttpRequestBodies.kt | 295 +++++--
 .../api/core/http/HttpRequestBodiesTest.kt    | 729 ++++++++++++++++++
 4 files changed, 949 insertions(+), 83 deletions(-)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestBodiesTest.kt

diff --git a/blooio-java-core/build.gradle.kts b/blooio-java-core/build.gradle.kts
index f647be8..18b3914 100644
--- a/blooio-java-core/build.gradle.kts
+++ b/blooio-java-core/build.gradle.kts
@@ -27,8 +27,6 @@ dependencies {
     implementation("com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.18.2")
     implementation("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.18.2")
     implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.18.2")
-    implementation("org.apache.httpcomponents.core5:httpcore5:5.2.4")
-    implementation("org.apache.httpcomponents.client5:httpclient5:5.3.1")
 
     testImplementation(kotlin("test"))
     testImplementation(project(":blooio-java-client-okhttp"))
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Properties.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Properties.kt
index 5aa1fbd..60ca187 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Properties.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Properties.kt
@@ -34,9 +34,9 @@ fun getOsName(): String {
     }
 }
 
-fun getOsVersion(): String = System.getProperty("os.version", "unknown")
+fun getOsVersion(): String = System.getProperty("os.version", "unknown") ?: "unknown"
 
 fun getPackageVersion(): String =
-    BlooioClient::class.java.`package`.implementationVersion ?: "unknown"
+    BlooioClient::class.java.`package`?.implementationVersion ?: "unknown"
 
-fun getJavaVersion(): String = System.getProperty("java.version", "unknown")
+fun getJavaVersion(): String = System.getProperty("java.version", "unknown") ?: "unknown"
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequestBodies.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequestBodies.kt
index c2c707d..6febc5e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequestBodies.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/HttpRequestBodies.kt
@@ -5,16 +5,16 @@
 package com.blooio.api.core.http
 
 import com.blooio.api.core.MultipartField
+import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.fasterxml.jackson.databind.JsonNode
 import com.fasterxml.jackson.databind.json.JsonMapper
 import com.fasterxml.jackson.databind.node.JsonNodeType
+import java.io.ByteArrayInputStream
 import java.io.InputStream
 import java.io.OutputStream
+import java.util.UUID
 import kotlin.jvm.optionals.getOrNull
-import org.apache.hc.client5.http.entity.mime.MultipartEntityBuilder
-import org.apache.hc.core5.http.ContentType
-import org.apache.hc.core5.http.HttpEntity
 
 @JvmSynthetic
 internal inline fun <reified T> json(jsonMapper: JsonMapper, value: T): HttpRequestBody =
@@ -37,92 +37,231 @@ internal fun multipartFormData(
     jsonMapper: JsonMapper,
     fields: Map<String, MultipartField<*>>,
 ): HttpRequestBody =
-    object : HttpRequestBody {
-        private val entity: HttpEntity by lazy {
-            MultipartEntityBuilder.create()
-                .apply {
-                    fields.forEach { (name, field) ->
-                        val knownValue = field.value.asKnown().getOrNull()
-                        val parts =
-                            if (knownValue is InputStream) {
-                                // Read directly from the `InputStream` instead of reading it all
-                                // into memory due to the `jsonMapper` serialization below.
-                                sequenceOf(name to knownValue)
-                            } else {
-                                val node = jsonMapper.valueToTree<JsonNode>(field.value)
-                                serializePart(name, node)
+    MultipartBody.Builder()
+        .apply {
+            fields.forEach { (name, field) ->
+                val knownValue = field.value.asKnown().getOrNull()
+                val parts =
+                    if (knownValue is InputStream) {
+                        // Read directly from the `InputStream` instead of reading it all
+                        // into memory due to the `jsonMapper` serialization below.
+                        sequenceOf(name to knownValue)
+                    } else {
+                        val node = jsonMapper.valueToTree<JsonNode>(field.value)
+                        serializePart(name, node)
+                    }
+
+                parts.forEach { (name, bytes) ->
+                    val partBody =
+                        if (bytes is ByteArrayInputStream) {
+                            val byteArray = bytes.readBytes()
+
+                            object : HttpRequestBody {
+
+                                override fun writeTo(outputStream: OutputStream) {
+                                    outputStream.write(byteArray)
+                                }
+
+                                override fun contentType(): String = field.contentType
+
+                                override fun contentLength(): Long = byteArray.size.toLong()
+
+                                override fun repeatable(): Boolean = true
+
+                                override fun close() {}
                             }
+                        } else {
+                            object : HttpRequestBody {
+
+                                override fun writeTo(outputStream: OutputStream) {
+                                    bytes.copyTo(outputStream)
+                                }
+
+                                override fun contentType(): String = field.contentType
+
+                                override fun contentLength(): Long = -1L
 
-                        parts.forEach { (name, bytes) ->
-                            addBinaryBody(
-                                name,
-                                bytes,
-                                ContentType.parseLenient(field.contentType),
-                                field.filename().getOrNull(),
-                            )
+                                override fun repeatable(): Boolean = false
+
+                                override fun close() = bytes.close()
+                            }
                         }
-                    }
+
+                    addPart(
+                        MultipartBody.Part.create(
+                            name,
+                            field.filename().getOrNull(),
+                            field.contentType,
+                            partBody,
+                        )
+                    )
                 }
-                .build()
+            }
         }
+        .build()
 
-        private fun serializePart(
-            name: String,
-            node: JsonNode,
-        ): Sequence<Pair<String, InputStream>> =
-            when (node.nodeType) {
-                JsonNodeType.MISSING,
-                JsonNodeType.NULL -> emptySequence()
-                JsonNodeType.BINARY -> sequenceOf(name to node.binaryValue().inputStream())
-                JsonNodeType.STRING -> sequenceOf(name to node.textValue().inputStream())
-                JsonNodeType.BOOLEAN ->
-                    sequenceOf(name to node.booleanValue().toString().inputStream())
-                JsonNodeType.NUMBER ->
-                    sequenceOf(name to node.numberValue().toString().inputStream())
-                JsonNodeType.ARRAY ->
-                    sequenceOf(
-                        name to
-                            node
-                                .elements()
-                                .asSequence()
-                                .mapNotNull { element ->
-                                    when (element.nodeType) {
-                                        JsonNodeType.MISSING,
-                                        JsonNodeType.NULL -> null
-                                        JsonNodeType.STRING -> node.textValue()
-                                        JsonNodeType.BOOLEAN -> node.booleanValue().toString()
-                                        JsonNodeType.NUMBER -> node.numberValue().toString()
-                                        null,
-                                        JsonNodeType.BINARY,
-                                        JsonNodeType.ARRAY,
-                                        JsonNodeType.OBJECT,
-                                        JsonNodeType.POJO ->
-                                            throw BlooioInvalidDataException(
-                                                "Unexpected JsonNode type in array: ${node.nodeType}"
-                                            )
-                                    }
-                                }
-                                .joinToString(",")
-                                .inputStream()
-                    )
-                JsonNodeType.OBJECT ->
-                    node.fields().asSequence().flatMap { (key, value) ->
-                        serializePart("$name[$key]", value)
-                    }
-                JsonNodeType.POJO,
-                null ->
-                    throw BlooioInvalidDataException("Unexpected JsonNode type: ${node.nodeType}")
+private fun serializePart(name: String, node: JsonNode): Sequence<Pair<String, InputStream>> =
+    when (node.nodeType) {
+        JsonNodeType.MISSING,
+        JsonNodeType.NULL -> emptySequence()
+        JsonNodeType.BINARY -> sequenceOf(name to node.binaryValue().inputStream())
+        JsonNodeType.STRING -> sequenceOf(name to node.textValue().byteInputStream())
+        JsonNodeType.BOOLEAN -> sequenceOf(name to node.booleanValue().toString().byteInputStream())
+        JsonNodeType.NUMBER -> sequenceOf(name to node.numberValue().toString().byteInputStream())
+        JsonNodeType.ARRAY ->
+            sequenceOf(
+                name to
+                    node
+                        .elements()
+                        .asSequence()
+                        .mapNotNull { element ->
+                            when (element.nodeType) {
+                                JsonNodeType.MISSING,
+                                JsonNodeType.NULL -> null
+                                JsonNodeType.STRING -> element.textValue()
+                                JsonNodeType.BOOLEAN -> element.booleanValue().toString()
+                                JsonNodeType.NUMBER -> element.numberValue().toString()
+                                null,
+                                JsonNodeType.BINARY,
+                                JsonNodeType.ARRAY,
+                                JsonNodeType.OBJECT,
+                                JsonNodeType.POJO ->
+                                    throw BlooioInvalidDataException(
+                                        "Unexpected JsonNode type in array: ${element.nodeType}"
+                                    )
+                            }
+                        }
+                        .joinToString(",")
+                        .byteInputStream()
+            )
+        JsonNodeType.OBJECT ->
+            node.fields().asSequence().flatMap { (key, value) ->
+                serializePart("$name[$key]", value)
+            }
+        JsonNodeType.POJO,
+        null -> throw BlooioInvalidDataException("Unexpected JsonNode type: ${node.nodeType}")
+    }
+
+private class MultipartBody
+private constructor(private val boundary: String, private val parts: List<Part>) : HttpRequestBody {
+    private val boundaryBytes: ByteArray = boundary.toByteArray()
+    private val contentType = "multipart/form-data; boundary=$boundary"
+
+    // This must remain in sync with `contentLength`.
+    override fun writeTo(outputStream: OutputStream) {
+        parts.forEach { part ->
+            outputStream.write(DASHDASH)
+            outputStream.write(boundaryBytes)
+            outputStream.write(CRLF)
+
+            outputStream.write(CONTENT_DISPOSITION)
+            outputStream.write(part.contentDisposition.toByteArray())
+            outputStream.write(CRLF)
+
+            outputStream.write(CONTENT_TYPE)
+            outputStream.write(part.contentType.toByteArray())
+            outputStream.write(CRLF)
+
+            outputStream.write(CRLF)
+            part.body.writeTo(outputStream)
+            outputStream.write(CRLF)
+        }
+
+        outputStream.write(DASHDASH)
+        outputStream.write(boundaryBytes)
+        outputStream.write(DASHDASH)
+        outputStream.write(CRLF)
+    }
+
+    override fun contentType(): String = contentType
+
+    // This must remain in sync with `writeTo`.
+    override fun contentLength(): Long {
+        var byteCount = 0L
+
+        parts.forEach { part ->
+            val contentLength = part.body.contentLength()
+            if (contentLength == -1L) {
+                return -1L
             }
 
-        private fun String.inputStream(): InputStream = toByteArray().inputStream()
+            byteCount +=
+                DASHDASH.size +
+                    boundaryBytes.size +
+                    CRLF.size +
+                    CONTENT_DISPOSITION.size +
+                    part.contentDisposition.toByteArray().size +
+                    CRLF.size +
+                    CONTENT_TYPE.size +
+                    part.contentType.toByteArray().size +
+                    CRLF.size +
+                    CRLF.size +
+                    contentLength +
+                    CRLF.size
+        }
 
-        override fun writeTo(outputStream: OutputStream) = entity.writeTo(outputStream)
+        byteCount += DASHDASH.size + boundaryBytes.size + DASHDASH.size + CRLF.size
+        return byteCount
+    }
 
-        override fun contentType(): String = entity.contentType
+    override fun repeatable(): Boolean = parts.all { it.body.repeatable() }
 
-        override fun contentLength(): Long = entity.contentLength
+    override fun close() {
+        parts.forEach { it.body.close() }
+    }
 
-        override fun repeatable(): Boolean = entity.isRepeatable
+    class Builder {
+        private val boundary = UUID.randomUUID().toString()
+        private val parts: MutableList<Part> = mutableListOf()
 
-        override fun close() = entity.close()
+        fun addPart(part: Part) = apply { parts.add(part) }
+
+        fun build() = MultipartBody(boundary, parts.toImmutable())
+    }
+
+    class Part
+    private constructor(
+        val contentDisposition: String,
+        val contentType: String,
+        val body: HttpRequestBody,
+    ) {
+        companion object {
+            fun create(
+                name: String,
+                filename: String?,
+                contentType: String,
+                body: HttpRequestBody,
+            ): Part {
+                val disposition = buildString {
+                    append("form-data; name=")
+                    appendQuotedString(name)
+                    if (filename != null) {
+                        append("; filename=")
+                        appendQuotedString(filename)
+                    }
+                }
+                return Part(disposition, contentType, body)
+            }
+        }
+    }
+
+    companion object {
+        private val CRLF = byteArrayOf('\r'.code.toByte(), '\n'.code.toByte())
+        private val DASHDASH = byteArrayOf('-'.code.toByte(), '-'.code.toByte())
+        private val CONTENT_DISPOSITION = "Content-Disposition: ".toByteArray()
+        private val CONTENT_TYPE = "Content-Type: ".toByteArray()
+
+        private fun StringBuilder.appendQuotedString(key: String) {
+            append('"')
+            for (ch in key) {
+                when (ch) {
+                    '\n' -> append("%0A")
+                    '\r' -> append("%0D")
+                    '"' -> append("%22")
+                    else -> append(ch)
+                }
+            }
+            append('"')
+        }
     }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestBodiesTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestBodiesTest.kt
new file mode 100644
index 0000000..ac774a0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/HttpRequestBodiesTest.kt
@@ -0,0 +1,729 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.core.http
+
+import com.blooio.api.core.MultipartField
+import com.blooio.api.core.jsonMapper
+import java.io.ByteArrayOutputStream
+import java.io.InputStream
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class HttpRequestBodiesTest {
+
+    @Test
+    fun multipartFormData_serializesFieldWithFilename() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "file" to
+                        MultipartField.builder<String>()
+                            .value("hello")
+                            .filename("hello.txt")
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(output.size().toLong()).isEqualTo(body.contentLength())
+        val boundary = body.contentType()!!.substringAfter("multipart/form-data; boundary=")
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="file"; filename="hello.txt"
+                |Content-Type: text/plain
+                |
+                |hello
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesFieldWithoutFilename() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "field" to
+                        MultipartField.builder<String>()
+                            .value("value")
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(output.size().toLong()).isEqualTo(body.contentLength())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="field"
+                |Content-Type: text/plain
+                |
+                |value
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesInputStream() {
+        // Use `.buffered()` to get a non-ByteArrayInputStream, which hits the non-repeatable code
+        // path.
+        val inputStream = "stream content".byteInputStream().buffered()
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "data" to
+                        MultipartField.builder<InputStream>()
+                            .value(inputStream)
+                            .contentType("application/octet-stream")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isFalse()
+        assertThat(body.contentLength()).isEqualTo(-1L)
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="data"
+                |Content-Type: application/octet-stream
+                |
+                |stream content
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesByteArray() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "binary" to
+                        MultipartField.builder<ByteArray>()
+                            .value("abc".toByteArray())
+                            .contentType("application/octet-stream")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="binary"
+                |Content-Type: application/octet-stream
+                |
+                |abc
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesBooleanValue() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "flag" to
+                        MultipartField.builder<Boolean>()
+                            .value(true)
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="flag"
+                |Content-Type: text/plain
+                |
+                |true
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesNumberValue() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "count" to
+                        MultipartField.builder<Int>().value(42).contentType("text/plain").build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="count"
+                |Content-Type: text/plain
+                |
+                |42
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesNullValueAsNoParts() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "present" to
+                        MultipartField.builder<String>()
+                            .value("yes")
+                            .contentType("text/plain")
+                            .build(),
+                    "absent" to
+                        MultipartField.builder<String>()
+                            .value(null as String?)
+                            .contentType("text/plain")
+                            .build(),
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="present"
+                |Content-Type: text/plain
+                |
+                |yes
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesArray() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "items" to
+                        MultipartField.builder<List<String>>()
+                            .value(listOf("alpha", "beta", "gamma"))
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="items"
+                |Content-Type: text/plain
+                |
+                |alpha,beta,gamma
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesObjectAsNestedParts() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "meta" to
+                        MultipartField.builder<Map<String, String>>()
+                            .value(mapOf("key1" to "val1", "key2" to "val2"))
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="meta[key1]"
+                |Content-Type: text/plain
+                |
+                |val1
+                |--$boundary
+                |Content-Disposition: form-data; name="meta[key2]"
+                |Content-Type: text/plain
+                |
+                |val2
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesMultipleFields() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "name" to
+                        MultipartField.builder<String>()
+                            .value("Alice")
+                            .contentType("text/plain")
+                            .build(),
+                    "age" to
+                        MultipartField.builder<Int>().value(30).contentType("text/plain").build(),
+                    "file" to
+                        MultipartField.builder<String>()
+                            .value("file contents")
+                            .filename("doc.txt")
+                            .contentType("text/plain")
+                            .build(),
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="name"
+                |Content-Type: text/plain
+                |
+                |Alice
+                |--$boundary
+                |Content-Disposition: form-data; name="age"
+                |Content-Type: text/plain
+                |
+                |30
+                |--$boundary
+                |Content-Disposition: form-data; name="file"; filename="doc.txt"
+                |Content-Type: text/plain
+                |
+                |file contents
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_quotesSpecialCharactersInNameAndFilename() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "field\nname" to
+                        MultipartField.builder<String>()
+                            .value("value")
+                            .filename("file\r\"name.txt")
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="field%0Aname"; filename="file%0D%22name.txt"
+                |Content-Type: text/plain
+                |
+                |value
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_writeIsRepeatable() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "field" to
+                        MultipartField.builder<String>()
+                            .value("repeatable")
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output1 = ByteArrayOutputStream()
+        body.writeTo(output1)
+        val output2 = ByteArrayOutputStream()
+        body.writeTo(output2)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output1.size().toLong())
+        val boundary = boundary(body)
+        val expected =
+            """
+            |--$boundary
+            |Content-Disposition: form-data; name="field"
+            |Content-Type: text/plain
+            |
+            |repeatable
+            |--$boundary--
+            |
+            """
+                .trimMargin()
+                .replace("\n", "\r\n")
+        assertThat(output1.toString("UTF-8")).isEqualTo(expected)
+        assertThat(output2.toString("UTF-8")).isEqualTo(expected)
+    }
+
+    @Test
+    fun multipartFormData_serializesByteArrayInputStream() {
+        // ByteArrayInputStream is specifically handled as repeatable with known content length.
+        val inputStream = "byte array stream".byteInputStream()
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "data" to
+                        MultipartField.builder<InputStream>()
+                            .value(inputStream)
+                            .contentType("application/octet-stream")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="data"
+                |Content-Type: application/octet-stream
+                |
+                |byte array stream
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesInputStreamWithFilename() {
+        // Use `.buffered()` to get a non-ByteArrayInputStream, which hits the non-repeatable code
+        // path.
+        val inputStream = "file data".byteInputStream().buffered()
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "upload" to
+                        MultipartField.builder<InputStream>()
+                            .value(inputStream)
+                            .filename("upload.bin")
+                            .contentType("application/octet-stream")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isFalse()
+        assertThat(body.contentLength()).isEqualTo(-1L)
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="upload"; filename="upload.bin"
+                |Content-Type: application/octet-stream
+                |
+                |file data
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesNestedArrayInObject() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "data" to
+                        MultipartField.builder<Map<String, List<String>>>()
+                            .value(mapOf("tags" to listOf("a", "b")))
+                            .contentType("text/plain")
+                            .build()
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="data[tags]"
+                |Content-Type: text/plain
+                |
+                |a,b
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_contentLengthIsUnknownWhenInputStreamPresent() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "text" to
+                        MultipartField.builder<String>()
+                            .value("hello")
+                            .contentType("text/plain")
+                            .build(),
+                    "stream" to
+                        MultipartField.builder<InputStream>()
+                            // Use `.buffered()` to get a non-ByteArrayInputStream, which hits the
+                            // non-repeatable code path.
+                            .value("data".byteInputStream().buffered())
+                            .contentType("application/octet-stream")
+                            .build(),
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isFalse()
+        assertThat(body.contentLength()).isEqualTo(-1L)
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="text"
+                |Content-Type: text/plain
+                |
+                |hello
+                |--$boundary
+                |Content-Disposition: form-data; name="stream"
+                |Content-Type: application/octet-stream
+                |
+                |data
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesEmptyArray() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "required" to
+                        MultipartField.builder<String>()
+                            .value("present")
+                            .contentType("text/plain")
+                            .build(),
+                    "items" to
+                        MultipartField.builder<List<String>>()
+                            .value(emptyList())
+                            .contentType("text/plain")
+                            .build(),
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="required"
+                |Content-Type: text/plain
+                |
+                |present
+                |--$boundary
+                |Content-Disposition: form-data; name="items"
+                |Content-Type: text/plain
+                |
+                |
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    @Test
+    fun multipartFormData_serializesEmptyObject() {
+        val body =
+            multipartFormData(
+                jsonMapper(),
+                mapOf(
+                    "required" to
+                        MultipartField.builder<String>()
+                            .value("present")
+                            .contentType("text/plain")
+                            .build(),
+                    "meta" to
+                        MultipartField.builder<Map<String, String>>()
+                            .value(emptyMap())
+                            .contentType("text/plain")
+                            .build(),
+                ),
+            )
+
+        val output = ByteArrayOutputStream()
+        body.writeTo(output)
+
+        assertThat(body.repeatable()).isTrue()
+        assertThat(body.contentLength()).isEqualTo(output.size().toLong())
+        val boundary = boundary(body)
+        assertThat(output.toString("UTF-8"))
+            .isEqualTo(
+                """
+                |--$boundary
+                |Content-Disposition: form-data; name="required"
+                |Content-Type: text/plain
+                |
+                |present
+                |--$boundary--
+                |
+                """
+                    .trimMargin()
+                    .replace("\n", "\r\n")
+            )
+    }
+
+    private fun boundary(body: HttpRequestBody): String =
+        body.contentType()!!.substringAfter("multipart/form-data; boundary=")
+}

From 58fcb730f98e0c1c1d8006b0aeb96f0aeb678a8b Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 25 Feb 2026 06:50:35 +0000
Subject: [PATCH 24/63] chore(internal): codegen related update

---
 .../com/blooio/api/core/http/RetryingHttpClient.kt  |  2 ++
 .../blooio/api/core/http/RetryingHttpClientTest.kt  | 13 ++++++++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
index f261e5f..ed77d2a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
@@ -1,3 +1,5 @@
+// File generated from our OpenAPI spec by Stainless.
+
 package com.blooio.api.core.http
 
 import com.blooio.api.core.DefaultSleeper
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
index d31b725..4b595df 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
@@ -1,10 +1,21 @@
+// File generated from our OpenAPI spec by Stainless.
+
 package com.blooio.api.core.http
 
 import com.blooio.api.client.okhttp.OkHttpClient
 import com.blooio.api.core.RequestOptions
 import com.blooio.api.core.Sleeper
 import com.blooio.api.errors.BlooioRetryableException
-import com.github.tomakehurst.wiremock.client.WireMock.*
+import com.github.tomakehurst.wiremock.client.WireMock.equalTo
+import com.github.tomakehurst.wiremock.client.WireMock.matching
+import com.github.tomakehurst.wiremock.client.WireMock.ok
+import com.github.tomakehurst.wiremock.client.WireMock.post
+import com.github.tomakehurst.wiremock.client.WireMock.postRequestedFor
+import com.github.tomakehurst.wiremock.client.WireMock.resetAllScenarios
+import com.github.tomakehurst.wiremock.client.WireMock.serviceUnavailable
+import com.github.tomakehurst.wiremock.client.WireMock.stubFor
+import com.github.tomakehurst.wiremock.client.WireMock.urlPathEqualTo
+import com.github.tomakehurst.wiremock.client.WireMock.verify
 import com.github.tomakehurst.wiremock.junit5.WireMockRuntimeInfo
 import com.github.tomakehurst.wiremock.junit5.WireMockTest
 import com.github.tomakehurst.wiremock.stubbing.Scenario

From ccf03561744755a1bd800449143bc61b847b17ab Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 3 Mar 2026 12:30:45 +0000
Subject: [PATCH 25/63] chore(internal): codegen related update

---
 .../src/main/kotlin/com/blooio/api/client/BlooioClient.kt | 8 ++++++++
 .../kotlin/com/blooio/api/client/BlooioClientAsync.kt     | 8 ++++++++
 .../kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt | 8 ++++++++
 .../main/kotlin/com/blooio/api/client/BlooioClientImpl.kt | 8 ++++++++
 .../com/blooio/api/services/async/BatchServiceAsync.kt    | 1 +
 .../blooio/api/services/async/BatchServiceAsyncImpl.kt    | 1 +
 .../com/blooio/api/services/async/ConfigServiceAsync.kt   | 2 ++
 .../blooio/api/services/async/ConfigServiceAsyncImpl.kt   | 2 ++
 .../com/blooio/api/services/async/ContactServiceAsync.kt  | 1 +
 .../blooio/api/services/async/ContactServiceAsyncImpl.kt  | 1 +
 .../com/blooio/api/services/async/MeServiceAsync.kt       | 1 +
 .../com/blooio/api/services/async/MeServiceAsyncImpl.kt   | 1 +
 .../com/blooio/api/services/async/MessageServiceAsync.kt  | 1 +
 .../blooio/api/services/async/MessageServiceAsyncImpl.kt  | 1 +
 .../api/services/async/config/WebhookServiceAsync.kt      | 1 +
 .../api/services/async/config/WebhookServiceAsyncImpl.kt  | 1 +
 .../com/blooio/api/services/blocking/BatchService.kt      | 1 +
 .../com/blooio/api/services/blocking/BatchServiceImpl.kt  | 1 +
 .../com/blooio/api/services/blocking/ConfigService.kt     | 2 ++
 .../com/blooio/api/services/blocking/ConfigServiceImpl.kt | 2 ++
 .../com/blooio/api/services/blocking/ContactService.kt    | 1 +
 .../blooio/api/services/blocking/ContactServiceImpl.kt    | 1 +
 .../kotlin/com/blooio/api/services/blocking/MeService.kt  | 1 +
 .../com/blooio/api/services/blocking/MeServiceImpl.kt     | 1 +
 .../com/blooio/api/services/blocking/MessageService.kt    | 1 +
 .../blooio/api/services/blocking/MessageServiceImpl.kt    | 1 +
 .../blooio/api/services/blocking/config/WebhookService.kt | 1 +
 .../api/services/blocking/config/WebhookServiceImpl.kt    | 1 +
 28 files changed, 60 insertions(+)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
index 77dd88d..934a821 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
@@ -46,14 +46,18 @@ interface BlooioClient {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient
 
+    /** Account and API key information */
     fun me(): MeService
 
+    /** Contact-related operations */
     fun contacts(): ContactService
 
+    /** Send and manage individual messages */
     fun messages(): MessageService
 
     fun config(): ConfigService
 
+    /** Bulk/batch operations (stubbed) */
     fun batches(): BatchService
 
     /**
@@ -79,14 +83,18 @@ interface BlooioClient {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient.WithRawResponse
 
+        /** Account and API key information */
         fun me(): MeService.WithRawResponse
 
+        /** Contact-related operations */
         fun contacts(): ContactService.WithRawResponse
 
+        /** Send and manage individual messages */
         fun messages(): MessageService.WithRawResponse
 
         fun config(): ConfigService.WithRawResponse
 
+        /** Bulk/batch operations (stubbed) */
         fun batches(): BatchService.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
index 83256cc..c205669 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
@@ -46,14 +46,18 @@ interface BlooioClientAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClientAsync
 
+    /** Account and API key information */
     fun me(): MeServiceAsync
 
+    /** Contact-related operations */
     fun contacts(): ContactServiceAsync
 
+    /** Send and manage individual messages */
     fun messages(): MessageServiceAsync
 
     fun config(): ConfigServiceAsync
 
+    /** Bulk/batch operations (stubbed) */
     fun batches(): BatchServiceAsync
 
     /**
@@ -81,14 +85,18 @@ interface BlooioClientAsync {
             modifier: Consumer<ClientOptions.Builder>
         ): BlooioClientAsync.WithRawResponse
 
+        /** Account and API key information */
         fun me(): MeServiceAsync.WithRawResponse
 
+        /** Contact-related operations */
         fun contacts(): ContactServiceAsync.WithRawResponse
 
+        /** Send and manage individual messages */
         fun messages(): MessageServiceAsync.WithRawResponse
 
         fun config(): ConfigServiceAsync.WithRawResponse
 
+        /** Bulk/batch operations (stubbed) */
         fun batches(): BatchServiceAsync.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
index 764d2b2..fc2615a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
@@ -58,14 +58,18 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClientAsync =
         BlooioClientAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Account and API key information */
     override fun me(): MeServiceAsync = me
 
+    /** Contact-related operations */
     override fun contacts(): ContactServiceAsync = contacts
 
+    /** Send and manage individual messages */
     override fun messages(): MessageServiceAsync = messages
 
     override fun config(): ConfigServiceAsync = config
 
+    /** Bulk/batch operations (stubbed) */
     override fun batches(): BatchServiceAsync = batches
 
     override fun close() = clientOptions.close()
@@ -100,14 +104,18 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Account and API key information */
         override fun me(): MeServiceAsync.WithRawResponse = me
 
+        /** Contact-related operations */
         override fun contacts(): ContactServiceAsync.WithRawResponse = contacts
 
+        /** Send and manage individual messages */
         override fun messages(): MessageServiceAsync.WithRawResponse = messages
 
         override fun config(): ConfigServiceAsync.WithRawResponse = config
 
+        /** Bulk/batch operations (stubbed) */
         override fun batches(): BatchServiceAsync.WithRawResponse = batches
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
index 50431c9..ff6d1b3 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
@@ -50,14 +50,18 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient =
         BlooioClientImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Account and API key information */
     override fun me(): MeService = me
 
+    /** Contact-related operations */
     override fun contacts(): ContactService = contacts
 
+    /** Send and manage individual messages */
     override fun messages(): MessageService = messages
 
     override fun config(): ConfigService = config
 
+    /** Bulk/batch operations (stubbed) */
     override fun batches(): BatchService = batches
 
     override fun close() = clientOptions.close()
@@ -92,14 +96,18 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Account and API key information */
         override fun me(): MeService.WithRawResponse = me
 
+        /** Contact-related operations */
         override fun contacts(): ContactService.WithRawResponse = contacts
 
+        /** Send and manage individual messages */
         override fun messages(): MessageService.WithRawResponse = messages
 
         override fun config(): ConfigService.WithRawResponse = config
 
+        /** Bulk/batch operations (stubbed) */
         override fun batches(): BatchService.WithRawResponse = batches
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
index d070d07..992a0ae 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
@@ -12,6 +12,7 @@ import com.blooio.api.models.batches.BatchRetrieveStatusParams
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Bulk/batch operations (stubbed) */
 interface BatchServiceAsync {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
index 6e65f91..18c975a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
@@ -23,6 +23,7 @@ import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Bulk/batch operations (stubbed) */
 class BatchServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     BatchServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt
index 2265be1..ded859c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt
@@ -20,6 +20,7 @@ interface ConfigServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigServiceAsync
 
+    /** Account-level configuration */
     fun webhook(): WebhookServiceAsync
 
     /**
@@ -36,6 +37,7 @@ interface ConfigServiceAsync {
             modifier: Consumer<ClientOptions.Builder>
         ): ConfigServiceAsync.WithRawResponse
 
+        /** Account-level configuration */
         fun webhook(): WebhookServiceAsync.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
index 3bf4b56..aecaf95 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
@@ -21,6 +21,7 @@ class ConfigServiceAsyncImpl internal constructor(private val clientOptions: Cli
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigServiceAsync =
         ConfigServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Account-level configuration */
     override fun webhook(): WebhookServiceAsync = webhook
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -37,6 +38,7 @@ class ConfigServiceAsyncImpl internal constructor(private val clientOptions: Cli
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Account-level configuration */
         override fun webhook(): WebhookServiceAsync.WithRawResponse = webhook
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
index 2b8defc..1588d35 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
@@ -10,6 +10,7 @@ import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Contact-related operations */
 interface ContactServiceAsync {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
index e00400c..b7fd70b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
@@ -21,6 +21,7 @@ import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Contact-related operations */
 class ContactServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     ContactServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
index 41e1b52..ec55599 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
@@ -10,6 +10,7 @@ import com.blooio.api.models.me.MeRetrieveResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Account and API key information */
 interface MeServiceAsync {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
index 1e01eb7..2e07d54 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
@@ -19,6 +19,7 @@ import com.blooio.api.models.me.MeRetrieveResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Account and API key information */
 class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     MeServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
index 114e4e4..dbbe25c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
@@ -16,6 +16,7 @@ import com.blooio.api.models.messages.MessageSendResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Send and manage individual messages */
 interface MessageServiceAsync {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt
index 1d3ac4f..d225a4c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt
@@ -28,6 +28,7 @@ import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Send and manage individual messages */
 class MessageServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     MessageServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
index 5836648..f5e0597 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
@@ -12,6 +12,7 @@ import com.blooio.api.models.config.webhook.WebhookUpdateResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Account-level configuration */
 interface WebhookServiceAsync {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt
index 13cf8c9..73a4fa5 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt
@@ -22,6 +22,7 @@ import com.blooio.api.models.config.webhook.WebhookUpdateResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
+/** Account-level configuration */
 class WebhookServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     WebhookServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
index 4b78e4c..778416c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
@@ -12,6 +12,7 @@ import com.blooio.api.models.batches.BatchRetrieveStatusParams
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
+/** Bulk/batch operations (stubbed) */
 interface BatchService {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
index 94adc8a..45b8d5e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
@@ -22,6 +22,7 @@ import com.blooio.api.models.batches.BatchRetrieveStatusParams
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Bulk/batch operations (stubbed) */
 class BatchServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     BatchService {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt
index c8c480c..e0a612c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt
@@ -20,6 +20,7 @@ interface ConfigService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService
 
+    /** Account-level configuration */
     fun webhook(): WebhookService
 
     /** A view of [ConfigService] that provides access to raw HTTP responses for each method. */
@@ -32,6 +33,7 @@ interface ConfigService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService.WithRawResponse
 
+        /** Account-level configuration */
         fun webhook(): WebhookService.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
index eb323dd..23e0c52 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
@@ -21,6 +21,7 @@ class ConfigServiceImpl internal constructor(private val clientOptions: ClientOp
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService =
         ConfigServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Account-level configuration */
     override fun webhook(): WebhookService = webhook
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -37,6 +38,7 @@ class ConfigServiceImpl internal constructor(private val clientOptions: ClientOp
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Account-level configuration */
         override fun webhook(): WebhookService.WithRawResponse = webhook
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
index 4476b6b..5ccedcb 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
@@ -10,6 +10,7 @@ import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
+/** Contact-related operations */
 interface ContactService {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
index 5d8a83d..8ddffc6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
@@ -20,6 +20,7 @@ import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Contact-related operations */
 class ContactServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     ContactService {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
index 4271ae5..a1b2172 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
@@ -10,6 +10,7 @@ import com.blooio.api.models.me.MeRetrieveResponse
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
+/** Account and API key information */
 interface MeService {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
index caf23d7..5776732 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
@@ -18,6 +18,7 @@ import com.blooio.api.models.me.MeRetrieveParams
 import com.blooio.api.models.me.MeRetrieveResponse
 import java.util.function.Consumer
 
+/** Account and API key information */
 class MeServiceImpl internal constructor(private val clientOptions: ClientOptions) : MeService {
 
     private val withRawResponse: MeService.WithRawResponse by lazy {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
index cb8919f..17012f1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
@@ -16,6 +16,7 @@ import com.blooio.api.models.messages.MessageSendResponse
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
+/** Send and manage individual messages */
 interface MessageService {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt
index b3bda00..a2056a6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt
@@ -27,6 +27,7 @@ import com.blooio.api.models.messages.MessageSendResponse
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
+/** Send and manage individual messages */
 class MessageServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     MessageService {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
index 101cf53..f5eb09d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
@@ -12,6 +12,7 @@ import com.blooio.api.models.config.webhook.WebhookUpdateResponse
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
+/** Account-level configuration */
 interface WebhookService {
 
     /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt
index 557dea2..28c3071 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt
@@ -21,6 +21,7 @@ import com.blooio.api.models.config.webhook.WebhookUpdateParams
 import com.blooio.api.models.config.webhook.WebhookUpdateResponse
 import java.util.function.Consumer
 
+/** Account-level configuration */
 class WebhookServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     WebhookService {
 

From e112bbf06bcdf1bb105d9bf924a29f652ac28eb4 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:04:50 +0000
Subject: [PATCH 26/63] feat(api): manual updates

---
 .github/workflows/ci.yml                      |   26 +-
 .github/workflows/publish-sonatype.yml        |   41 -
 .github/workflows/release-doctor.yml          |   24 -
 .gitignore                                    |    1 +
 .release-please-manifest.json                 |    3 -
 .stats.yml                                    |    8 +-
 README.md                                     |  111 +-
 SECURITY.md                                   |    4 +
 bin/check-release-environment                 |   33 -
 .../api/client/okhttp/BlooioOkHttpClient.kt   |    4 +-
 .../client/okhttp/BlooioOkHttpClientAsync.kt  |    4 +-
 .../com/blooio/api/client/BlooioClient.kt     |   59 +-
 .../blooio/api/client/BlooioClientAsync.kt    |   59 +-
 .../api/client/BlooioClientAsyncImpl.kt       |  114 +-
 .../com/blooio/api/client/BlooioClientImpl.kt |  110 +-
 .../main/kotlin/com/blooio/api/core/Check.kt  |    2 +-
 .../com/blooio/api/core/ClientOptions.kt      |   33 +-
 .../blooio/api/core/handlers/EmptyHandler.kt  |   12 -
 .../api/core/http/RetryingHttpClient.kt       |   11 +-
 .../blooio/api/models/chats/ChatListParams.kt |  385 ++
 .../api/models/chats/ChatListResponse.kt      | 1274 +++++++
 .../api/models/chats/ChatMarkAsReadParams.kt  |  229 ++
 .../ChatMarkAsReadResponse.kt}                |  151 +-
 .../api/models/chats/ChatRetrieveParams.kt    |  189 +
 .../api/models/chats/ChatRetrieveResponse.kt  | 1086 ++++++
 .../chats/ChatShareContactCardParams.kt       |  236 ++
 .../chats/ChatShareContactCardResponse.kt     |  227 ++
 .../blooio/api/models/chats/LastMessage.kt    |  383 ++
 .../background/BackgroundRemoveParams.kt      |  230 ++
 .../background/BackgroundRetrieveParams.kt}   |   53 +-
 .../chats/background/BackgroundSetParams.kt   |  460 +++
 .../background/ChatBackgroundResponse.kt      |  346 ++
 .../api/models/chats/messages/LinkPreview.kt  |  206 ++
 .../messages/MessageGetStatusParams.kt        |   40 +-
 .../messages/MessageGetStatusResponse.kt}     |  435 ++-
 .../chats/messages/MessageListParams.kt       |  585 +++
 .../chats/messages/MessageListResponse.kt     | 1346 +++++++
 .../chats/messages/MessageReactParams.kt      |  695 ++++
 .../chats/messages/MessageReactResponse.kt    |  398 ++
 .../messages/MessageRetrieveParams.kt         |   43 +-
 .../chats/messages/MessageRetrieveResponse.kt | 1332 +++++++
 .../chats/messages/MessageSendParams.kt       | 1895 ++++++++++
 .../chats/messages/MessageSendResponse.kt     |  566 +++
 .../api/models/chats/messages/Reaction.kt     |  271 ++
 .../chats/polls/PollGetResultsParams.kt       |  220 ++
 .../chats/polls/PollGetResultsResponse.kt     |  474 +++
 .../api/models/chats/polls/PollSendParams.kt  |  531 +++
 .../models/chats/polls/PollSendResponse.kt    |  444 +++
 .../api/models/chats/typing/TypingResponse.kt |  265 ++
 .../models/chats/typing/TypingStartParams.kt  |  229 ++
 .../models/chats/typing/TypingStopParams.kt   |  229 ++
 .../com/blooio/api/models/contacts/Contact.kt |  573 +++
 .../ContactCheckCapabilitiesParams.kt         |   29 +-
 .../ContactCheckCapabilitiesResponse.kt       |  102 +-
 .../models/contacts/ContactCreateParams.kt    |  488 +++
 .../ContactDeleteParams.kt}                   |   56 +-
 .../api/models/contacts/ContactListParams.kt  |  397 ++
 .../models/contacts/ContactListResponse.kt    |  214 ++
 .../ContactRetrieveParams.kt}                 |   52 +-
 .../models/contacts/ContactUpdateParams.kt    |  413 +++
 .../DeleteResponse.kt}                        |  102 +-
 .../blooio/api/models/contacts/Pagination.kt  |  215 ++
 .../api/models/contacts/tags/TagAddParams.kt  |  463 +++
 .../models/contacts/tags/TagAddResponse.kt    |  213 ++
 .../api/models/contacts/tags/TagListParams.kt |  189 +
 .../models/contacts/tags/TagListResponse.kt   |  348 ++
 .../models/contacts/tags/TagRemoveParams.kt   |  258 ++
 .../FacetimeInitiateCallParams.kt}            |  120 +-
 .../facetime/FacetimeInitiateCallResponse.kt  |  223 ++
 .../com/blooio/api/models/groups/Group.kt     |  683 ++++
 .../GroupCreateParams.kt}                     |  351 +-
 .../api/models/groups/GroupCreateResponse.kt  |  678 ++++
 .../api/models/groups/GroupDeleteParams.kt    |  232 ++
 .../api/models/groups/GroupDeleteResponse.kt  |  184 +
 .../api/models/groups/GroupListParams.kt      |  397 ++
 .../api/models/groups/GroupListResponse.kt    |  213 ++
 .../GroupRetrieveParams.kt}                   |   48 +-
 .../api/models/groups/GroupUpdateParams.kt    |  411 +++
 .../api/models/groups/GroupUpdateResponse.kt  |  997 ++++++
 .../api/models/groups/icon/GroupIcon.kt       |  549 +++
 .../models/groups/icon/IconRemoveParams.kt    |  234 ++
 .../api/models/groups/icon/IconSetParams.kt   |  452 +++
 .../api/models/groups/members/GroupMember.kt  |  295 ++
 .../models/groups/members/MemberAddParams.kt  |  444 +++
 .../members/MemberAddResponse.kt}             |   88 +-
 .../models/groups/members/MemberListParams.kt |  243 ++
 .../groups/members/MemberListResponse.kt      |  326 ++
 .../groups/members/MemberRemoveParams.kt      |  264 ++
 .../groups/members/MemberRemoveResponse.kt    |  184 +
 .../location/contacts/ContactListParams.kt    |  173 +
 .../location/contacts/ContactListResponse.kt  |  180 +
 .../location/contacts/ContactLocation.kt      |  290 ++
 .../contacts/ContactRefreshParams.kt}         |   33 +-
 .../contacts/ContactRefreshResponse.kt        |  211 ++
 .../contacts/ContactRetrieveParams.kt         |  189 +
 .../blooio/api/models/me/MeRetrieveParams.kt  |    4 +-
 .../api/models/me/MeRetrieveResponse.kt       |  631 +++-
 .../api/models/me/numbers/NumberListParams.kt |  173 +
 .../models/me/numbers/NumberListResponse.kt   |  401 +++
 .../contactcard/ContactCardRetrieveParams.kt  |  200 ++
 .../ContactCardRetrieveResponse.kt            |  605 ++++
 .../contactcard/ContactCardUpdateParams.kt    |  814 +++++
 .../contactcard/ContactCardUpdateResponse.kt  |  268 ++
 .../models/messages/MessageCancelResponse.kt  |  311 --
 .../PhoneNumberBatchCreateParams.kt           |  450 +++
 .../PhoneNumberBatchCreateResponse.kt         |  185 +
 .../phonenumbers/lookup/LookupCreateParams.kt |  419 +++
 .../lookup/LookupRetrieveParams.kt            |  217 ++
 .../lookup/PhoneNumberLookupResult.kt         | 1089 ++++++
 .../com/blooio/api/models/webhooks/Webhook.kt |  875 +++++
 .../models/webhooks/WebhookCreateParams.kt    |  700 ++++
 .../models/webhooks/WebhookCreateResponse.kt  |  384 ++
 .../models/webhooks/WebhookDeleteParams.kt    |  229 ++
 .../WebhookDeleteResponse.kt}                 |   60 +-
 .../api/models/webhooks/WebhookListParams.kt  |  170 +
 .../models/webhooks/WebhookListResponse.kt    |  178 +
 .../WebhookRetrieveParams.kt                  |   33 +-
 .../models/webhooks/WebhookUpdateParams.kt    |  685 ++++
 .../api/models/webhooks/logs/LogListParams.kt |  464 +++
 .../models/webhooks/logs/LogListResponse.kt   | 3190 +++++++++++++++++
 .../models/webhooks/logs/LogReplayParams.kt   |  258 ++
 .../models/webhooks/logs/LogReplayResponse.kt |  782 ++++
 .../webhooks/secret/SecretRotateParams.kt     |  232 ++
 .../webhooks/secret/SecretRotateResponse.kt   |  319 ++
 .../api/services/async/BatchServiceAsync.kt   |  290 --
 .../services/async/BatchServiceAsyncImpl.kt   |  182 -
 .../api/services/async/ChatServiceAsync.kt    |  356 ++
 .../services/async/ChatServiceAsyncImpl.kt    |  279 ++
 .../services/async/ConfigServiceAsyncImpl.kt  |   44 -
 .../api/services/async/ContactServiceAsync.kt |  340 +-
 .../services/async/ContactServiceAsyncImpl.kt |  226 +-
 .../services/async/FacetimeServiceAsync.kt    |   75 +
 .../async/FacetimeServiceAsyncImpl.kt         |   87 +
 .../api/services/async/GroupServiceAsync.kt   |  371 ++
 .../services/async/GroupServiceAsyncImpl.kt   |  283 ++
 ...erviceAsync.kt => LocationServiceAsync.kt} |   18 +-
 .../async/LocationServiceAsyncImpl.kt         |   44 +
 .../api/services/async/MeServiceAsync.kt      |   15 +-
 .../api/services/async/MeServiceAsyncImpl.kt  |   20 +-
 .../api/services/async/MessageServiceAsync.kt |  321 --
 .../services/async/PhoneNumberServiceAsync.kt |   91 +
 .../async/PhoneNumberServiceAsyncImpl.kt      |  110 +
 .../api/services/async/WebhookServiceAsync.kt |  349 ++
 .../services/async/WebhookServiceAsyncImpl.kt |  282 ++
 .../async/chats/BackgroundServiceAsync.kt     |  260 ++
 .../async/chats/BackgroundServiceAsyncImpl.kt |  176 +
 .../async/chats/MessageServiceAsync.kt        |  380 ++
 .../{ => chats}/MessageServiceAsyncImpl.kt    |  123 +-
 .../services/async/chats/PollServiceAsync.kt  |  154 +
 .../async/chats/PollServiceAsyncImpl.kt       |  138 +
 .../async/chats/TypingServiceAsync.kt         |  187 +
 .../async/chats/TypingServiceAsyncImpl.kt     |  134 +
 .../async/config/WebhookServiceAsync.kt       |  124 -
 .../async/contacts/TagServiceAsync.kt         |  218 ++
 .../async/contacts/TagServiceAsyncImpl.kt     |  177 +
 .../services/async/groups/IconServiceAsync.kt |  171 +
 .../async/groups/IconServiceAsyncImpl.kt      |  135 +
 .../async/groups/MemberServiceAsync.kt        |  235 ++
 .../async/groups/MemberServiceAsyncImpl.kt    |  182 +
 .../async/location/ContactServiceAsync.kt     |  214 ++
 .../async/location/ContactServiceAsyncImpl.kt |  170 +
 .../services/async/me/NumberServiceAsync.kt   |   95 +
 .../async/me/NumberServiceAsyncImpl.kt        |  101 +
 .../me/numbers/ContactCardServiceAsync.kt     |  209 ++
 .../me/numbers/ContactCardServiceAsyncImpl.kt |  134 +
 .../async/phonenumbers/LookupServiceAsync.kt  |  109 +
 .../LookupServiceAsyncImpl.kt}                |   86 +-
 .../async/webhooks/LogServiceAsync.kt         |  163 +
 .../async/webhooks/LogServiceAsyncImpl.kt     |  140 +
 .../async/webhooks/SecretServiceAsync.kt      |  121 +
 .../async/webhooks/SecretServiceAsyncImpl.kt  |   92 +
 .../api/services/blocking/BatchService.kt     |  285 --
 .../api/services/blocking/BatchServiceImpl.kt |  161 -
 .../api/services/blocking/ChatService.kt      |  355 ++
 .../api/services/blocking/ChatServiceImpl.kt  |  260 ++
 .../services/blocking/ConfigServiceImpl.kt    |   44 -
 .../api/services/blocking/ContactService.kt   |  338 +-
 .../services/blocking/ContactServiceImpl.kt   |  202 +-
 .../api/services/blocking/FacetimeService.kt  |   72 +
 .../services/blocking/FacetimeServiceImpl.kt  |   83 +
 .../api/services/blocking/GroupService.kt     |  360 ++
 .../api/services/blocking/GroupServiceImpl.kt |  261 ++
 .../{ConfigService.kt => LocationService.kt}  |   18 +-
 .../services/blocking/LocationServiceImpl.kt  |   44 +
 .../blooio/api/services/blocking/MeService.kt |   15 +-
 .../api/services/blocking/MeServiceImpl.kt    |   20 +-
 .../api/services/blocking/MessageService.kt   |  312 --
 .../services/blocking/PhoneNumberService.kt   |   90 +
 .../blocking/PhoneNumberServiceImpl.kt        |  106 +
 .../api/services/blocking/WebhookService.kt   |  342 ++
 .../services/blocking/WebhookServiceImpl.kt   |  260 ++
 .../blocking/chats/BackgroundService.kt       |  253 ++
 .../blocking/chats/BackgroundServiceImpl.kt   |  166 +
 .../services/blocking/chats/MessageService.kt |  366 ++
 .../{ => chats}/MessageServiceImpl.kt         |  120 +-
 .../services/blocking/chats/PollService.kt    |  153 +
 .../blocking/chats/PollServiceImpl.kt         |  127 +
 .../services/blocking/chats/TypingService.kt  |  179 +
 .../blocking/chats/TypingServiceImpl.kt       |  121 +
 .../blocking/config/WebhookService.kt         |  120 -
 .../services/blocking/contacts/TagService.kt  |  213 ++
 .../blocking/contacts/TagServiceImpl.kt       |  157 +
 .../services/blocking/groups/IconService.kt   |  167 +
 .../blocking/groups/IconServiceImpl.kt        |  121 +
 .../services/blocking/groups/MemberService.kt |  228 ++
 .../blocking/groups/MemberServiceImpl.kt      |  169 +
 .../blocking/location/ContactService.kt       |  208 ++
 .../blocking/location/ContactServiceImpl.kt   |  160 +
 .../api/services/blocking/me/NumberService.kt |   90 +
 .../services/blocking/me/NumberServiceImpl.kt |   95 +
 .../blocking/me/numbers/ContactCardService.kt |  206 ++
 .../me/numbers/ContactCardServiceImpl.kt      |  127 +
 .../blocking/phonenumbers/LookupService.kt    |  105 +
 .../LookupServiceImpl.kt}                     |   86 +-
 .../services/blocking/webhooks/LogService.kt  |  159 +
 .../blocking/webhooks/LogServiceImpl.kt       |  129 +
 .../blocking/webhooks/SecretService.kt        |  117 +
 .../blocking/webhooks/SecretServiceImpl.kt    |   88 +
 .../com/blooio/api/core/ClientOptionsTest.kt  |   23 +
 .../api/core/http/RetryingHttpClientTest.kt   |  224 +-
 .../api/models/chats/ChatListParamsTest.kt    |   52 +
 .../api/models/chats/ChatListResponseTest.kt  |  135 +
 .../ChatMarkAsReadParamsTest.kt}              |   10 +-
 .../chats/ChatMarkAsReadResponseTest.kt       |   44 +
 .../ChatRetrieveParamsTest.kt}                |   10 +-
 .../models/chats/ChatRetrieveResponseTest.kt  |  121 +
 .../ChatShareContactCardParamsTest.kt}        |   10 +-
 .../chats/ChatShareContactCardResponseTest.kt |   51 +
 .../api/models/chats/LastMessageTest.kt       |   47 +
 .../background/BackgroundRemoveParamsTest.kt  |   23 +
 .../BackgroundRetrieveParamsTest.kt           |   23 +
 .../background/BackgroundSetParamsTest.kt     |   58 +
 .../background/ChatBackgroundResponseTest.kt  |   50 +
 .../models/chats/messages/LinkPreviewTest.kt  |   35 +
 .../messages/MessageGetStatusParamsTest.kt    |   25 +
 .../messages/MessageGetStatusResponseTest.kt  |   22 +-
 .../chats/messages/MessageListParamsTest.kt   |   69 +
 .../chats/messages/MessageListResponseTest.kt |  118 +
 .../chats/messages/MessageReactParamsTest.kt  |   64 +
 .../messages/MessageReactResponseTest.kt      |   47 +
 .../messages/MessageRetrieveParamsTest.kt     |   25 +
 .../messages/MessageRetrieveResponseTest.kt   |  124 +
 .../chats/messages/MessageSendParamsTest.kt   |  153 +
 .../chats/messages/MessageSendResponseTest.kt |   57 +
 .../api/models/chats/messages/ReactionTest.kt |   47 +
 .../chats/polls/PollGetResultsParamsTest.kt   |   24 +
 .../chats/polls/PollGetResultsResponseTest.kt |   52 +
 .../models/chats/polls/PollSendParamsTest.kt  |   63 +
 .../chats/polls/PollSendResponseTest.kt       |   48 +
 .../models/chats/typing/TypingResponseTest.kt |   47 +
 .../typing/TypingStartParamsTest.kt}          |   10 +-
 .../chats/typing/TypingStopParamsTest.kt      |   23 +
 .../webhook/WebhookRetrieveParamsTest.kt      |   13 -
 .../webhook/WebhookRetrieveResponseTest.kt    |   41 -
 .../config/webhook/WebhookUpdateParamsTest.kt |   24 -
 .../webhook/WebhookUpdateResponseTest.kt      |   41 -
 .../ContactCheckCapabilitiesParamsTest.kt     |    6 +-
 .../ContactCheckCapabilitiesResponseTest.kt   |   17 +-
 .../contacts/ContactCreateParamsTest.kt       |   34 +
 .../contacts/ContactDeleteParamsTest.kt       |   23 +
 .../models/contacts/ContactListParamsTest.kt  |   52 +
 .../contacts/ContactListResponseTest.kt       |   77 +
 .../contacts/ContactRetrieveParamsTest.kt     |   23 +
 .../blooio/api/models/contacts/ContactTest.kt |   57 +
 .../contacts/ContactUpdateParamsTest.kt       |   40 +
 .../api/models/contacts/DeleteResponseTest.kt |   33 +
 .../api/models/contacts/PaginationTest.kt     |   34 +
 .../models/contacts/tags/TagAddParamsTest.kt  |   42 +
 .../contacts/tags/TagAddResponseTest.kt       |   44 +
 .../models/contacts/tags/TagListParamsTest.kt |   23 +
 .../contacts/tags/TagListResponseTest.kt      |   40 +
 .../contacts/tags/TagRemoveParamsTest.kt      |   24 +
 .../FacetimeInitiateCallParamsTest.kt         |   23 +
 .../FacetimeInitiateCallResponseTest.kt       |   45 +
 .../models/groups/GroupCreateParamsTest.kt    |   46 +
 .../models/groups/GroupCreateResponseTest.kt  |   73 +
 .../GroupDeleteParamsTest.kt}                 |   10 +-
 .../models/groups/GroupDeleteResponseTest.kt  |   33 +
 .../api/models/groups/GroupListParamsTest.kt  |   52 +
 .../models/groups/GroupListResponseTest.kt    |   84 +
 .../models/groups/GroupRetrieveParamsTest.kt  |   23 +
 .../com/blooio/api/models/groups/GroupTest.kt |   62 +
 .../models/groups/GroupUpdateParamsTest.kt    |   40 +
 .../models/groups/GroupUpdateResponseTest.kt  |   91 +
 .../api/models/groups/icon/GroupIconTest.kt   |   72 +
 .../icon/IconRemoveParamsTest.kt}             |   10 +-
 .../models/groups/icon/IconSetParamsTest.kt   |   58 +
 .../models/groups/members/GroupMemberTest.kt  |   50 +
 .../groups/members/MemberAddParamsTest.kt     |   34 +
 .../groups/members/MemberAddResponseTest.kt   |   66 +
 .../groups/members/MemberListParamsTest.kt    |   44 +
 .../groups/members/MemberListResponseTest.kt  |   78 +
 .../groups/members/MemberRemoveParamsTest.kt  |   28 +
 .../members/MemberRemoveResponseTest.kt       |   35 +
 .../contacts/ContactListParamsTest.kt         |   13 +
 .../contacts/ContactListResponseTest.kt       |   61 +
 .../location/contacts/ContactLocationTest.kt  |   48 +
 .../contacts/ContactRefreshParamsTest.kt      |   13 +
 .../contacts/ContactRefreshResponseTest.kt    |   64 +
 .../contacts/ContactRetrieveParamsTest.kt     |   23 +
 .../api/models/me/MeRetrieveResponseTest.kt   |   73 +-
 .../numbers/NumberListParamsTest.kt}          |    6 +-
 .../me/numbers/NumberListResponseTest.kt      |   59 +
 .../ContactCardRetrieveParamsTest.kt          |   23 +
 .../ContactCardRetrieveResponseTest.kt        |   75 +
 .../ContactCardUpdateParamsTest.kt            |   74 +
 .../ContactCardUpdateResponseTest.kt          |   47 +
 .../messages/MessageCancelResponseTest.kt     |   50 -
 .../messages/MessageRetrieveResponseTest.kt   |   69 -
 .../models/messages/MessageSendParamsTest.kt  |   77 -
 .../messages/MessageSendResponseTest.kt       |   35 -
 .../PhoneNumberBatchCreateParamsTest.kt       |   28 +
 .../PhoneNumberBatchCreateResponseTest.kt     |  111 +
 .../lookup/LookupCreateParamsTest.kt          |   23 +
 .../lookup/LookupRetrieveParamsTest.kt        |   25 +
 .../lookup/PhoneNumberLookupResultTest.kt     |   97 +
 .../webhooks/WebhookCreateParamsTest.kt       |   43 +
 .../webhooks/WebhookCreateResponseTest.kt     |   47 +
 .../webhooks/WebhookDeleteParamsTest.kt       |   23 +
 .../webhooks/WebhookDeleteResponseTest.kt     |   35 +
 .../models/webhooks/WebhookListParamsTest.kt  |   13 +
 .../webhooks/WebhookListResponseTest.kt       |   85 +
 .../webhooks/WebhookRetrieveParamsTest.kt     |   23 +
 .../blooio/api/models/webhooks/WebhookTest.kt |   68 +
 .../webhooks/WebhookUpdateParamsTest.kt       |   52 +
 .../models/webhooks/logs/LogListParamsTest.kt |   69 +
 .../webhooks/logs/LogListResponseTest.kt      |  231 ++
 .../webhooks/logs/LogReplayParamsTest.kt      |   25 +
 .../webhooks/logs/LogReplayResponseTest.kt    |   91 +
 .../webhooks/secret/SecretRotateParamsTest.kt |   23 +
 .../secret/SecretRotateResponseTest.kt        |   50 +
 .../services/async/BatchServiceAsyncTest.kt   |   54 -
 .../services/async/ChatServiceAsyncTest.kt    |   67 +
 .../services/async/ContactServiceAsyncTest.kt |   79 +-
 .../async/FacetimeServiceAsyncTest.kt         |   26 +
 .../services/async/GroupServiceAsyncTest.kt   |   95 +
 .../services/async/MessageServiceAsyncTest.kt |   69 -
 .../async/PhoneNumberServiceAsyncTest.kt      |   28 +
 .../services/async/WebhookServiceAsyncTest.kt |   87 +
 .../async/chats/BackgroundServiceAsyncTest.kt |   53 +
 .../async/chats/MessageServiceAsyncTest.kt    |  135 +
 .../async/chats/PollServiceAsyncTest.kt       |   47 +
 .../async/chats/TypingServiceAsyncTest.kt     |   34 +
 .../async/config/WebhookServiceAsyncTest.kt   |   38 -
 .../async/contacts/TagServiceAsyncTest.kt     |   58 +
 .../async/groups/IconServiceAsyncTest.kt      |   41 +
 .../async/groups/MemberServiceAsyncTest.kt    |   64 +
 .../async/location/ContactServiceAsyncTest.kt |   46 +
 .../async/me/NumberServiceAsyncTest.kt        |   22 +
 .../me/numbers/ContactCardServiceAsyncTest.kt |   50 +
 .../phonenumbers/LookupServiceAsyncTest.kt    |   40 +
 .../async/webhooks/LogServiceAsyncTest.kt     |   50 +
 .../async/webhooks/SecretServiceAsyncTest.kt  |   22 +
 .../api/services/blocking/ChatServiceTest.kt  |   63 +
 .../services/blocking/ContactServiceTest.kt   |   74 +-
 .../services/blocking/FacetimeServiceTest.kt  |   25 +
 .../api/services/blocking/GroupServiceTest.kt |   90 +
 .../services/blocking/MessageServiceTest.kt   |   65 -
 .../blocking/PhoneNumberServiceTest.kt        |   27 +
 .../services/blocking/WebhookServiceTest.kt   |   82 +
 .../blocking/chats/BackgroundServiceTest.kt   |   50 +
 .../blocking/chats/MessageServiceTest.kt      |  130 +
 .../blocking/chats/PollServiceTest.kt         |   45 +
 .../blocking/chats/TypingServiceTest.kt       |   32 +
 .../blocking/config/WebhookServiceTest.kt     |   36 -
 .../blocking/contacts/TagServiceTest.kt       |   55 +
 .../blocking/groups/IconServiceTest.kt        |   39 +
 .../blocking/groups/MemberServiceTest.kt      |   61 +
 .../ContactServiceTest.kt}                    |   35 +-
 .../services/blocking/me/NumberServiceTest.kt |   21 +
 .../me/numbers/ContactCardServiceTest.kt      |   48 +
 .../phonenumbers/LookupServiceTest.kt         |   36 +
 .../blocking/webhooks/LogServiceTest.kt       |   48 +
 .../blocking/webhooks/SecretServiceTest.kt    |   21 +
 blooio-java-example/build.gradle.kts          |    3 +-
 .../api/proguard/ProGuardCompatibilityTest.kt |   33 +-
 build.gradle.kts                              |    2 +-
 .../src/main/kotlin/blooio.java.gradle.kts    |    2 +-
 .../src/main/kotlin/blooio.kotlin.gradle.kts  |    2 +-
 .../src/main/kotlin/blooio.publish.gradle.kts |   13 +-
 release-please-config.json                    |   67 -
 scripts/fast-format                           |    6 +-
 382 files changed, 62841 insertions(+), 4537 deletions(-)
 delete mode 100644 .github/workflows/publish-sonatype.yml
 delete mode 100644 .github/workflows/release-doctor.yml
 delete mode 100644 .release-please-manifest.json
 delete mode 100644 bin/check-release-environment
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/core/handlers/EmptyHandler.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{messages/MessageGetStatusResponse.kt => chats/ChatMarkAsReadResponse.kt} (69%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{batches/BatchListMessagesParams.kt => chats/background/BackgroundRetrieveParams.kt} (77%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{ => chats}/messages/MessageGetStatusParams.kt (84%)
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{messages/MessageRetrieveResponse.kt => chats/messages/MessageGetStatusResponse.kt} (65%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{ => chats}/messages/MessageRetrieveParams.kt (84%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{messages/MessageCancelParams.kt => contacts/ContactDeleteParams.kt} (82%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{batches/BatchRetrieveStatusParams.kt => contacts/ContactRetrieveParams.kt} (78%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{config/webhook/WebhookRetrieveResponse.kt => contacts/DeleteResponse.kt} (51%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{config/webhook/WebhookUpdateParams.kt => facetime/FacetimeInitiateCallParams.kt} (75%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{messages/MessageSendParams.kt => groups/GroupCreateParams.kt} (58%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{batches/BatchRetrieveParams.kt => groups/GroupRetrieveParams.kt} (82%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconRemoveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{messages/MessageSendResponse.kt => groups/members/MemberAddResponse.kt} (56%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{batches/BatchCreateParams.kt => location/contacts/ContactRefreshParams.kt} (86%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParams.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{config/webhook/WebhookUpdateResponse.kt => webhooks/WebhookDeleteResponse.kt} (70%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/models/{config/webhook => webhooks}/WebhookRetrieveParams.kt (83%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParams.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsyncImpl.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/async/{ConfigServiceAsync.kt => LocationServiceAsync.kt} (65%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsyncImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/async/{ => chats}/MessageServiceAsyncImpl.kt (64%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsync.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/async/{config/WebhookServiceAsyncImpl.kt => phonenumbers/LookupServiceAsyncImpl.kt} (62%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsync.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupServiceImpl.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/{ConfigService.kt => LocationService.kt} (66%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationServiceImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/{ => chats}/MessageServiceImpl.kt (63%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingServiceImpl.kt
 delete mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupService.kt
 rename blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/{config/WebhookServiceImpl.kt => phonenumbers/LookupServiceImpl.kt} (61%)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceImpl.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretService.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceImpl.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{batches/BatchRetrieveParamsTest.kt => chats/ChatMarkAsReadParamsTest.kt} (52%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponseTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{messages/MessageCancelParamsTest.kt => chats/ChatRetrieveParamsTest.kt} (51%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{messages/MessageRetrieveParamsTest.kt => chats/ChatShareContactCardParamsTest.kt} (50%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/LastMessageTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundSetParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/LinkPreviewTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParamsTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{ => chats}/messages/MessageGetStatusResponseTest.kt (54%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/ReactionTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{batches/BatchListMessagesParamsTest.kt => chats/typing/TypingStartParamsTest.kt} (51%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStopParamsTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParamsTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponseTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParamsTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCreateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactDeleteParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactUpdateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/DeleteResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/PaginationTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateResponseTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{messages/MessageGetStatusParamsTest.kt => groups/GroupDeleteParamsTest.kt} (51%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/GroupIconTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{batches/BatchRetrieveStatusParamsTest.kt => groups/icon/IconRemoveParamsTest.kt} (51%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconSetParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/GroupMemberTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactLocationTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParamsTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/models/{batches/BatchCreateParamsTest.kt => me/numbers/NumberListParamsTest.kt} (51%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponseTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelResponseTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveResponseTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendParamsTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResultTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponseTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParamsTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponseTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ChatServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/GroupServiceAsyncTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/WebhookServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ChatServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/FacetimeServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/GroupServiceTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/WebhookServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/PollServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/TypingServiceTest.kt
 delete mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/contacts/TagServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/IconServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/MemberServiceTest.kt
 rename blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/{BatchServiceTest.kt => location/ContactServiceTest.kt} (50%)
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/NumberServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceTest.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceTest.kt
 delete mode 100644 release-please-config.json

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2915cd2..3081312 100644
--- a/.github/workflows/ci.yml
+++ b/.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/blooio-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/blooio-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
@@ -65,14 +67,18 @@ jobs:
         run: ./scripts/build
 
       - name: Get GitHub OIDC Token
-        if: github.repository == 'stainless-sdks/blooio-java'
+        if: |-
+          github.repository == 'stainless-sdks/blooio-java' &&
+          !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 Maven artifacts
-        if: github.repository == 'stainless-sdks/blooio-java'
+        if: |-
+          github.repository == 'stainless-sdks/blooio-java' &&
+          !startsWith(github.ref, 'refs/heads/stl/')
         env:
           URL: https://pkg.stainless.com/s
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
deleted file mode 100644
index 2d81e3a..0000000
--- a/.github/workflows/publish-sonatype.yml
+++ /dev/null
@@ -1,41 +0,0 @@
-# This workflow is triggered when a GitHub release is created.
-# It can also be run manually to re-publish to Sonatype in case it failed for some reason.
-# You can run this workflow by navigating to https://www.github.com/Blooio/blooio-java-sdk/actions/workflows/publish-sonatype.yml
-name: Publish Sonatype
-on:
-  workflow_dispatch:
-
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    name: publish
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Set up Java
-        uses: actions/setup-java@v5
-        with:
-          distribution: temurin
-          java-version: |
-            8
-            21
-          cache: gradle
-
-      - name: Set up Gradle
-        uses: gradle/gradle-build-action@v2
-
-      - name: Publish to Sonatype
-        run: |-
-          export -- GPG_SIGNING_KEY_ID
-          printenv -- GPG_SIGNING_KEY | gpg --batch --passphrase-fd 3 --import 3<<< "$GPG_SIGNING_PASSWORD"
-          GPG_SIGNING_KEY_ID="$(gpg --with-colons --list-keys | awk -F : -- '/^pub:/ { getline; print "0x" substr($10, length($10) - 7) }')"
-          ./gradlew publish --no-configuration-cache
-        env:
-          SONATYPE_USERNAME: ${{ secrets.BLOOIO_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
-          SONATYPE_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
-          GPG_SIGNING_KEY: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_KEY || secrets.GPG_SIGNING_KEY }}
-          GPG_SIGNING_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_PASSWORD || secrets.GPG_SIGNING_PASSWORD }}
\ No newline at end of file
diff --git a/.github/workflows/release-doctor.yml b/.github/workflows/release-doctor.yml
deleted file mode 100644
index 2d36b26..0000000
--- a/.github/workflows/release-doctor.yml
+++ /dev/null
@@ -1,24 +0,0 @@
-name: Release Doctor
-on:
-  pull_request:
-    branches:
-      - main
-  workflow_dispatch:
-
-jobs:
-  release_doctor:
-    name: release doctor
-    runs-on: ubuntu-latest
-    if: github.repository == 'Blooio/blooio-java-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
-
-    steps:
-      - uses: actions/checkout@v6
-
-      - name: Check release environment
-        run: |
-          bash ./bin/check-release-environment
-        env:
-          SONATYPE_USERNAME: ${{ secrets.BLOOIO_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
-          SONATYPE_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
-          GPG_SIGNING_KEY: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_KEY || secrets.GPG_SIGNING_KEY }}
-          GPG_SIGNING_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_PASSWORD || secrets.GPG_SIGNING_PASSWORD }}
diff --git a/.gitignore b/.gitignore
index b1346e6..90b85e9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,5 @@
 .prism.log
+.stdy.log
 .gradle
 .idea
 .kotlin
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
deleted file mode 100644
index 2ed3b71..0000000
--- a/.release-please-manifest.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-  ".": "0.0.4"
-}
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index 5906eac..85efcf0 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio%2Fblooio-2d1e4d94ef5b48617299b653eb3509f32fe4e9d6315ee9f3bac50b83635d736b.yml
-openapi_spec_hash: 27229154f39588fcc348a91e6b293664
-config_hash: 8cae0b4155e1a7413f8d8693d7253e37
+configured_endpoints: 54
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
+openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
+config_hash: 6b6c2172dff7ef13c233830fab6efadb
diff --git a/README.md b/README.md
index 1215874..0c60ca5 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,16 @@
 # Blooio Java API Library
 
-<!-- x-release-please-start-version -->
-
 [![Maven Central](https://img.shields.io/maven-central/v/com.blooio.api/blooio-java)](https://central.sonatype.com/artifact/com.blooio.api/blooio-java/0.0.4)
 [![javadoc](https://javadoc.io/badge2/com.blooio.api/blooio-java/0.0.4/javadoc.svg)](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4)
 
-<!-- x-release-please-end -->
-
-The Blooio Java SDK provides convenient access to the Blooio REST API from applications written in Java.
+The Blooio Java SDK provides convenient access to the [Blooio REST API](https://blooio.com) from applications written in Java.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
-<!-- x-release-please-start-version -->
-
-Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4).
-
-<!-- x-release-please-end -->
+The REST API documentation can be found on [blooio.com](https://blooio.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4).
 
 ## Installation
 
-<!-- x-release-please-start-version -->
-
 ### Gradle
 
 ```kotlin
@@ -37,8 +27,6 @@ implementation("com.blooio.api:blooio-java:0.0.4")
 </dependency>
 ```
 
-<!-- x-release-please-end -->
-
 ## Requirements
 
 This library requires Java 8 or later.
@@ -98,10 +86,10 @@ BlooioClient client = BlooioOkHttpClient.builder()
 
 See this table for the available options:
 
-| Setter    | System property  | Environment variable | Required | Default value                  |
-| --------- | ---------------- | -------------------- | -------- | ------------------------------ |
-| `apiKey`  | `blooio.apiKey`  | `BLOOIO_API_KEY`     | true     | -                              |
-| `baseUrl` | `blooio.baseUrl` | `BLOOIO_BASE_URL`    | true     | `"https://backend.blooio.com"` |
+| Setter    | System property  | Environment variable | Required | Default value                         |
+| --------- | ---------------- | -------------------- | -------- | ------------------------------------- |
+| `apiKey`  | `blooio.apiKey`  | `BLOOIO_API_KEY`     | true     | -                                     |
+| `baseUrl` | `blooio.baseUrl` | `BLOOIO_BASE_URL`    | true     | `"https://backend.blooio.com/v2/api"` |
 
 System properties take precedence over environment variables.
 
@@ -174,6 +162,70 @@ CompletableFuture<MeRetrieveResponse> me = client.me().retrieve();
 
 The asynchronous client supports the same options as the synchronous one, except most methods return `CompletableFuture`s.
 
+## File uploads
+
+The SDK defines methods that accept files.
+
+To upload a file, pass a [`Path`](https://docs.oracle.com/javase/8/docs/api/java/nio/file/Path.html):
+
+```java
+import com.blooio.api.models.groups.icon.GroupIcon;
+import com.blooio.api.models.groups.icon.IconSetParams;
+import java.nio.file.Paths;
+
+IconSetParams params = IconSetParams.builder()
+    .groupId("grp_abc123def456")
+    .icon(Paths.get("/path/to/file"))
+    .build();
+GroupIcon groupIcon = client.groups().icon().set(params);
+```
+
+Or an arbitrary [`InputStream`](https://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html):
+
+```java
+import com.blooio.api.models.groups.icon.GroupIcon;
+import com.blooio.api.models.groups.icon.IconSetParams;
+import java.net.URL;
+
+IconSetParams params = IconSetParams.builder()
+    .groupId("grp_abc123def456")
+    .icon(new URL("https://example.com//path/to/file").openStream())
+    .build();
+GroupIcon groupIcon = client.groups().icon().set(params);
+```
+
+Or a `byte[]` array:
+
+```java
+import com.blooio.api.models.groups.icon.GroupIcon;
+import com.blooio.api.models.groups.icon.IconSetParams;
+
+IconSetParams params = IconSetParams.builder()
+    .groupId("grp_abc123def456")
+    .icon("content".getBytes())
+    .build();
+GroupIcon groupIcon = client.groups().icon().set(params);
+```
+
+Note that when passing a non-`Path` its filename is unknown so it will not be included in the request. To manually set a filename, pass a [`MultipartField`](blooio-java-core/src/main/kotlin/com/blooio/api/core/Values.kt):
+
+```java
+import com.blooio.api.core.MultipartField;
+import com.blooio.api.models.groups.icon.GroupIcon;
+import com.blooio.api.models.groups.icon.IconSetParams;
+import java.io.InputStream;
+import java.net.URL;
+
+IconSetParams params = IconSetParams.builder()
+    .groupId("grp_abc123def456")
+    .icon(MultipartField.<InputStream>builder()
+        .value(new URL("https://example.com//path/to/file").openStream())
+        .filename("/path/to/file")
+        .build())
+    .build();
+GroupIcon groupIcon = client.groups().icon().set(params);
+```
+
 ## Raw responses
 
 The SDK defines methods that deserialize responses into instances of Java classes. However, these methods don't provide access to the response headers, status code, or the raw response body.
@@ -430,6 +482,21 @@ MeRetrieveParams params = MeRetrieveParams.builder()
 
 These can be accessed on the built object later using the `_additionalHeaders()`, `_additionalQueryParams()`, and `_additionalBodyProperties()` methods.
 
+To set undocumented parameters on _nested_ headers, query params, or body classes, call the `putAdditionalProperty` method on the nested class:
+
+```java
+import com.blooio.api.core.JsonValue;
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams;
+
+ContactCardUpdateParams params = ContactCardUpdateParams.builder()
+    .sharing(ContactCardUpdateParams.Sharing.builder()
+        .putAdditionalProperty("secretProperty", JsonValue.from("42"))
+        .build())
+    .build();
+```
+
+These properties can be accessed on the nested built object later using the `_additionalProperties()` method.
+
 To set a documented parameter or property to an undocumented or not yet supported _value_, pass a [`JsonValue`](blooio-java-core/src/main/kotlin/com/blooio/api/core/Values.kt) object to its setter:
 
 ```java
@@ -483,11 +550,11 @@ To forcibly omit a required parameter or property, pass [`JsonMissing`](blooio-j
 
 ```java
 import com.blooio.api.core.JsonMissing;
-import com.blooio.api.models.contacts.ContactCheckCapabilitiesParams;
 import com.blooio.api.models.me.MeRetrieveParams;
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveParams;
 
-MeRetrieveParams params = ContactCheckCapabilitiesParams.builder()
-    .contact(JsonMissing.of())
+MeRetrieveParams params = ContactCardRetrieveParams.builder()
+    .number(JsonMissing.of())
     .build();
 ```
 
@@ -617,4 +684,4 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/Blooio/blooio-java-sdk/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/stainless-sdks/blooio-java/issues) with questions, bugs, or suggestions.
diff --git a/SECURITY.md b/SECURITY.md
index ea78ff0..4262c82 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -18,6 +18,10 @@ before making any information public.
 If you encounter security issues that are not directly related to SDKs but pertain to the services
 or products provided by Blooio, please follow the respective company's security reporting guidelines.
 
+### Blooio Terms and Policies
+
+Please contact support@blooio.com for any questions or concerns regarding the security of our services.
+
 ---
 
 Thank you for helping us keep the SDKs and systems they interact with secure.
diff --git a/bin/check-release-environment b/bin/check-release-environment
deleted file mode 100644
index 3a6a7b4..0000000
--- a/bin/check-release-environment
+++ /dev/null
@@ -1,33 +0,0 @@
-#!/usr/bin/env bash
-
-errors=()
-
-if [ -z "${SONATYPE_USERNAME}" ]; then
-  errors+=("The SONATYPE_USERNAME secret has not been set. Please set it in either this repository's secrets or your organization secrets")
-fi
-
-if [ -z "${SONATYPE_PASSWORD}" ]; then
-  errors+=("The SONATYPE_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
-fi
-
-if [ -z "${GPG_SIGNING_KEY}" ]; then
-  errors+=("The GPG_SIGNING_KEY secret has not been set. Please set it in either this repository's secrets or your organization secrets")
-fi
-
-if [ -z "${GPG_SIGNING_PASSWORD}" ]; then
-  errors+=("The GPG_SIGNING_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
-fi
-
-lenErrors=${#errors[@]}
-
-if [[ lenErrors -gt 0 ]]; then
-  echo -e "Found the following errors in the release environment:\n"
-
-  for error in "${errors[@]}"; do
-    echo -e "- $error\n"
-  done
-
-  exit 1
-fi
-
-echo "The environment is ready to push releases!"
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index c409e2c..12f120f 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -207,7 +207,7 @@ class BlooioOkHttpClient private constructor() {
         /**
          * The base URL to use for every request.
          *
-         * Defaults to the production environment: `https://backend.blooio.com`.
+         * Defaults to the production environment: `https://backend.blooio.com/v2/api`.
          */
         fun baseUrl(baseUrl: String?) = apply { clientOptions.baseUrl(baseUrl) }
 
@@ -258,7 +258,7 @@ class BlooioOkHttpClient private constructor() {
          */
         fun maxRetries(maxRetries: Int) = apply { clientOptions.maxRetries(maxRetries) }
 
-        /** API key must be provided in the Authorization header as `Bearer YOUR_API_KEY`. */
+        /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { clientOptions.apiKey(apiKey) }
 
         fun headers(headers: Headers) = apply { clientOptions.headers(headers) }
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index ccc14ff..2cd6ba7 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -207,7 +207,7 @@ class BlooioOkHttpClientAsync private constructor() {
         /**
          * The base URL to use for every request.
          *
-         * Defaults to the production environment: `https://backend.blooio.com`.
+         * Defaults to the production environment: `https://backend.blooio.com/v2/api`.
          */
         fun baseUrl(baseUrl: String?) = apply { clientOptions.baseUrl(baseUrl) }
 
@@ -258,7 +258,7 @@ class BlooioOkHttpClientAsync private constructor() {
          */
         fun maxRetries(maxRetries: Int) = apply { clientOptions.maxRetries(maxRetries) }
 
-        /** API key must be provided in the Authorization header as `Bearer YOUR_API_KEY`. */
+        /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { clientOptions.apiKey(apiKey) }
 
         fun headers(headers: Headers) = apply { clientOptions.headers(headers) }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
index 934a821..97d034c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClient.kt
@@ -3,11 +3,14 @@
 package com.blooio.api.client
 
 import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.blocking.BatchService
-import com.blooio.api.services.blocking.ConfigService
+import com.blooio.api.services.blocking.ChatService
 import com.blooio.api.services.blocking.ContactService
+import com.blooio.api.services.blocking.FacetimeService
+import com.blooio.api.services.blocking.GroupService
+import com.blooio.api.services.blocking.LocationService
 import com.blooio.api.services.blocking.MeService
-import com.blooio.api.services.blocking.MessageService
+import com.blooio.api.services.blocking.PhoneNumberService
+import com.blooio.api.services.blocking.WebhookService
 import java.util.function.Consumer
 
 /**
@@ -46,19 +49,30 @@ interface BlooioClient {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient
 
-    /** Account and API key information */
+    /** Authentication and account information */
     fun me(): MeService
 
-    /** Contact-related operations */
+    /** Manage contacts (phone numbers and emails) */
     fun contacts(): ContactService
 
-    /** Send and manage individual messages */
-    fun messages(): MessageService
+    fun location(): LocationService
 
-    fun config(): ConfigService
+    /** Initiate FaceTime calls */
+    fun facetime(): FacetimeService
 
-    /** Bulk/batch operations (stubbed) */
-    fun batches(): BatchService
+    /** Manage contact groups */
+    fun groups(): GroupService
+
+    /** Manage webhook subscriptions */
+    fun webhooks(): WebhookService
+
+    fun chats(): ChatService
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    fun phoneNumbers(): PhoneNumberService
 
     /**
      * Closes this client, relinquishing any underlying resources.
@@ -83,18 +97,29 @@ interface BlooioClient {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient.WithRawResponse
 
-        /** Account and API key information */
+        /** Authentication and account information */
         fun me(): MeService.WithRawResponse
 
-        /** Contact-related operations */
+        /** Manage contacts (phone numbers and emails) */
         fun contacts(): ContactService.WithRawResponse
 
-        /** Send and manage individual messages */
-        fun messages(): MessageService.WithRawResponse
+        fun location(): LocationService.WithRawResponse
 
-        fun config(): ConfigService.WithRawResponse
+        /** Initiate FaceTime calls */
+        fun facetime(): FacetimeService.WithRawResponse
 
-        /** Bulk/batch operations (stubbed) */
-        fun batches(): BatchService.WithRawResponse
+        /** Manage contact groups */
+        fun groups(): GroupService.WithRawResponse
+
+        /** Manage webhook subscriptions */
+        fun webhooks(): WebhookService.WithRawResponse
+
+        fun chats(): ChatService.WithRawResponse
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        fun phoneNumbers(): PhoneNumberService.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
index c205669..0a3eafc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsync.kt
@@ -3,11 +3,14 @@
 package com.blooio.api.client
 
 import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.async.BatchServiceAsync
-import com.blooio.api.services.async.ConfigServiceAsync
+import com.blooio.api.services.async.ChatServiceAsync
 import com.blooio.api.services.async.ContactServiceAsync
+import com.blooio.api.services.async.FacetimeServiceAsync
+import com.blooio.api.services.async.GroupServiceAsync
+import com.blooio.api.services.async.LocationServiceAsync
 import com.blooio.api.services.async.MeServiceAsync
-import com.blooio.api.services.async.MessageServiceAsync
+import com.blooio.api.services.async.PhoneNumberServiceAsync
+import com.blooio.api.services.async.WebhookServiceAsync
 import java.util.function.Consumer
 
 /**
@@ -46,19 +49,30 @@ interface BlooioClientAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClientAsync
 
-    /** Account and API key information */
+    /** Authentication and account information */
     fun me(): MeServiceAsync
 
-    /** Contact-related operations */
+    /** Manage contacts (phone numbers and emails) */
     fun contacts(): ContactServiceAsync
 
-    /** Send and manage individual messages */
-    fun messages(): MessageServiceAsync
+    fun location(): LocationServiceAsync
 
-    fun config(): ConfigServiceAsync
+    /** Initiate FaceTime calls */
+    fun facetime(): FacetimeServiceAsync
 
-    /** Bulk/batch operations (stubbed) */
-    fun batches(): BatchServiceAsync
+    /** Manage contact groups */
+    fun groups(): GroupServiceAsync
+
+    /** Manage webhook subscriptions */
+    fun webhooks(): WebhookServiceAsync
+
+    fun chats(): ChatServiceAsync
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    fun phoneNumbers(): PhoneNumberServiceAsync
 
     /**
      * Closes this client, relinquishing any underlying resources.
@@ -85,18 +99,29 @@ interface BlooioClientAsync {
             modifier: Consumer<ClientOptions.Builder>
         ): BlooioClientAsync.WithRawResponse
 
-        /** Account and API key information */
+        /** Authentication and account information */
         fun me(): MeServiceAsync.WithRawResponse
 
-        /** Contact-related operations */
+        /** Manage contacts (phone numbers and emails) */
         fun contacts(): ContactServiceAsync.WithRawResponse
 
-        /** Send and manage individual messages */
-        fun messages(): MessageServiceAsync.WithRawResponse
+        fun location(): LocationServiceAsync.WithRawResponse
 
-        fun config(): ConfigServiceAsync.WithRawResponse
+        /** Initiate FaceTime calls */
+        fun facetime(): FacetimeServiceAsync.WithRawResponse
 
-        /** Bulk/batch operations (stubbed) */
-        fun batches(): BatchServiceAsync.WithRawResponse
+        /** Manage contact groups */
+        fun groups(): GroupServiceAsync.WithRawResponse
+
+        /** Manage webhook subscriptions */
+        fun webhooks(): WebhookServiceAsync.WithRawResponse
+
+        fun chats(): ChatServiceAsync.WithRawResponse
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        fun phoneNumbers(): PhoneNumberServiceAsync.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
index fc2615a..fae4817 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientAsyncImpl.kt
@@ -4,16 +4,22 @@ package com.blooio.api.client
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.getPackageVersion
-import com.blooio.api.services.async.BatchServiceAsync
-import com.blooio.api.services.async.BatchServiceAsyncImpl
-import com.blooio.api.services.async.ConfigServiceAsync
-import com.blooio.api.services.async.ConfigServiceAsyncImpl
+import com.blooio.api.services.async.ChatServiceAsync
+import com.blooio.api.services.async.ChatServiceAsyncImpl
 import com.blooio.api.services.async.ContactServiceAsync
 import com.blooio.api.services.async.ContactServiceAsyncImpl
+import com.blooio.api.services.async.FacetimeServiceAsync
+import com.blooio.api.services.async.FacetimeServiceAsyncImpl
+import com.blooio.api.services.async.GroupServiceAsync
+import com.blooio.api.services.async.GroupServiceAsyncImpl
+import com.blooio.api.services.async.LocationServiceAsync
+import com.blooio.api.services.async.LocationServiceAsyncImpl
 import com.blooio.api.services.async.MeServiceAsync
 import com.blooio.api.services.async.MeServiceAsyncImpl
-import com.blooio.api.services.async.MessageServiceAsync
-import com.blooio.api.services.async.MessageServiceAsyncImpl
+import com.blooio.api.services.async.PhoneNumberServiceAsync
+import com.blooio.api.services.async.PhoneNumberServiceAsyncImpl
+import com.blooio.api.services.async.WebhookServiceAsync
+import com.blooio.api.services.async.WebhookServiceAsyncImpl
 import java.util.function.Consumer
 
 class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioClientAsync {
@@ -39,16 +45,26 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
         ContactServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
-    private val messages: MessageServiceAsync by lazy {
-        MessageServiceAsyncImpl(clientOptionsWithUserAgent)
+    private val location: LocationServiceAsync by lazy {
+        LocationServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
-    private val config: ConfigServiceAsync by lazy {
-        ConfigServiceAsyncImpl(clientOptionsWithUserAgent)
+    private val facetime: FacetimeServiceAsync by lazy {
+        FacetimeServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
-    private val batches: BatchServiceAsync by lazy {
-        BatchServiceAsyncImpl(clientOptionsWithUserAgent)
+    private val groups: GroupServiceAsync by lazy {
+        GroupServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
+    private val webhooks: WebhookServiceAsync by lazy {
+        WebhookServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
+    private val chats: ChatServiceAsync by lazy { ChatServiceAsyncImpl(clientOptionsWithUserAgent) }
+
+    private val phoneNumbers: PhoneNumberServiceAsync by lazy {
+        PhoneNumberServiceAsyncImpl(clientOptionsWithUserAgent)
     }
 
     override fun sync(): BlooioClient = sync
@@ -58,19 +74,30 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClientAsync =
         BlooioClientAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    /** Account and API key information */
+    /** Authentication and account information */
     override fun me(): MeServiceAsync = me
 
-    /** Contact-related operations */
+    /** Manage contacts (phone numbers and emails) */
     override fun contacts(): ContactServiceAsync = contacts
 
-    /** Send and manage individual messages */
-    override fun messages(): MessageServiceAsync = messages
+    override fun location(): LocationServiceAsync = location
 
-    override fun config(): ConfigServiceAsync = config
+    /** Initiate FaceTime calls */
+    override fun facetime(): FacetimeServiceAsync = facetime
 
-    /** Bulk/batch operations (stubbed) */
-    override fun batches(): BatchServiceAsync = batches
+    /** Manage contact groups */
+    override fun groups(): GroupServiceAsync = groups
+
+    /** Manage webhook subscriptions */
+    override fun webhooks(): WebhookServiceAsync = webhooks
+
+    override fun chats(): ChatServiceAsync = chats
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    override fun phoneNumbers(): PhoneNumberServiceAsync = phoneNumbers
 
     override fun close() = clientOptions.close()
 
@@ -85,16 +112,28 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
             ContactServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val messages: MessageServiceAsync.WithRawResponse by lazy {
-            MessageServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        private val location: LocationServiceAsync.WithRawResponse by lazy {
+            LocationServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val config: ConfigServiceAsync.WithRawResponse by lazy {
-            ConfigServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        private val facetime: FacetimeServiceAsync.WithRawResponse by lazy {
+            FacetimeServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val batches: BatchServiceAsync.WithRawResponse by lazy {
-            BatchServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        private val groups: GroupServiceAsync.WithRawResponse by lazy {
+            GroupServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val webhooks: WebhookServiceAsync.WithRawResponse by lazy {
+            WebhookServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val chats: ChatServiceAsync.WithRawResponse by lazy {
+            ChatServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val phoneNumbers: PhoneNumberServiceAsync.WithRawResponse by lazy {
+            PhoneNumberServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
         override fun withOptions(
@@ -104,18 +143,29 @@ class BlooioClientAsyncImpl(private val clientOptions: ClientOptions) : BlooioCl
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        /** Account and API key information */
+        /** Authentication and account information */
         override fun me(): MeServiceAsync.WithRawResponse = me
 
-        /** Contact-related operations */
+        /** Manage contacts (phone numbers and emails) */
         override fun contacts(): ContactServiceAsync.WithRawResponse = contacts
 
-        /** Send and manage individual messages */
-        override fun messages(): MessageServiceAsync.WithRawResponse = messages
+        override fun location(): LocationServiceAsync.WithRawResponse = location
+
+        /** Initiate FaceTime calls */
+        override fun facetime(): FacetimeServiceAsync.WithRawResponse = facetime
+
+        /** Manage contact groups */
+        override fun groups(): GroupServiceAsync.WithRawResponse = groups
+
+        /** Manage webhook subscriptions */
+        override fun webhooks(): WebhookServiceAsync.WithRawResponse = webhooks
 
-        override fun config(): ConfigServiceAsync.WithRawResponse = config
+        override fun chats(): ChatServiceAsync.WithRawResponse = chats
 
-        /** Bulk/batch operations (stubbed) */
-        override fun batches(): BatchServiceAsync.WithRawResponse = batches
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        override fun phoneNumbers(): PhoneNumberServiceAsync.WithRawResponse = phoneNumbers
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
index ff6d1b3..f8e0b0a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/client/BlooioClientImpl.kt
@@ -4,16 +4,22 @@ package com.blooio.api.client
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.getPackageVersion
-import com.blooio.api.services.blocking.BatchService
-import com.blooio.api.services.blocking.BatchServiceImpl
-import com.blooio.api.services.blocking.ConfigService
-import com.blooio.api.services.blocking.ConfigServiceImpl
+import com.blooio.api.services.blocking.ChatService
+import com.blooio.api.services.blocking.ChatServiceImpl
 import com.blooio.api.services.blocking.ContactService
 import com.blooio.api.services.blocking.ContactServiceImpl
+import com.blooio.api.services.blocking.FacetimeService
+import com.blooio.api.services.blocking.FacetimeServiceImpl
+import com.blooio.api.services.blocking.GroupService
+import com.blooio.api.services.blocking.GroupServiceImpl
+import com.blooio.api.services.blocking.LocationService
+import com.blooio.api.services.blocking.LocationServiceImpl
 import com.blooio.api.services.blocking.MeService
 import com.blooio.api.services.blocking.MeServiceImpl
-import com.blooio.api.services.blocking.MessageService
-import com.blooio.api.services.blocking.MessageServiceImpl
+import com.blooio.api.services.blocking.PhoneNumberService
+import com.blooio.api.services.blocking.PhoneNumberServiceImpl
+import com.blooio.api.services.blocking.WebhookService
+import com.blooio.api.services.blocking.WebhookServiceImpl
 import java.util.function.Consumer
 
 class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient {
@@ -37,11 +43,23 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
 
     private val contacts: ContactService by lazy { ContactServiceImpl(clientOptionsWithUserAgent) }
 
-    private val messages: MessageService by lazy { MessageServiceImpl(clientOptionsWithUserAgent) }
+    private val location: LocationService by lazy {
+        LocationServiceImpl(clientOptionsWithUserAgent)
+    }
+
+    private val facetime: FacetimeService by lazy {
+        FacetimeServiceImpl(clientOptionsWithUserAgent)
+    }
 
-    private val config: ConfigService by lazy { ConfigServiceImpl(clientOptionsWithUserAgent) }
+    private val groups: GroupService by lazy { GroupServiceImpl(clientOptionsWithUserAgent) }
 
-    private val batches: BatchService by lazy { BatchServiceImpl(clientOptionsWithUserAgent) }
+    private val webhooks: WebhookService by lazy { WebhookServiceImpl(clientOptionsWithUserAgent) }
+
+    private val chats: ChatService by lazy { ChatServiceImpl(clientOptionsWithUserAgent) }
+
+    private val phoneNumbers: PhoneNumberService by lazy {
+        PhoneNumberServiceImpl(clientOptionsWithUserAgent)
+    }
 
     override fun async(): BlooioClientAsync = async
 
@@ -50,19 +68,30 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BlooioClient =
         BlooioClientImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    /** Account and API key information */
+    /** Authentication and account information */
     override fun me(): MeService = me
 
-    /** Contact-related operations */
+    /** Manage contacts (phone numbers and emails) */
     override fun contacts(): ContactService = contacts
 
-    /** Send and manage individual messages */
-    override fun messages(): MessageService = messages
+    override fun location(): LocationService = location
+
+    /** Initiate FaceTime calls */
+    override fun facetime(): FacetimeService = facetime
+
+    /** Manage contact groups */
+    override fun groups(): GroupService = groups
+
+    /** Manage webhook subscriptions */
+    override fun webhooks(): WebhookService = webhooks
 
-    override fun config(): ConfigService = config
+    override fun chats(): ChatService = chats
 
-    /** Bulk/batch operations (stubbed) */
-    override fun batches(): BatchService = batches
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    override fun phoneNumbers(): PhoneNumberService = phoneNumbers
 
     override fun close() = clientOptions.close()
 
@@ -77,16 +106,28 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
             ContactServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val messages: MessageService.WithRawResponse by lazy {
-            MessageServiceImpl.WithRawResponseImpl(clientOptions)
+        private val location: LocationService.WithRawResponse by lazy {
+            LocationServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val config: ConfigService.WithRawResponse by lazy {
-            ConfigServiceImpl.WithRawResponseImpl(clientOptions)
+        private val facetime: FacetimeService.WithRawResponse by lazy {
+            FacetimeServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
-        private val batches: BatchService.WithRawResponse by lazy {
-            BatchServiceImpl.WithRawResponseImpl(clientOptions)
+        private val groups: GroupService.WithRawResponse by lazy {
+            GroupServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val webhooks: WebhookService.WithRawResponse by lazy {
+            WebhookServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val chats: ChatService.WithRawResponse by lazy {
+            ChatServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val phoneNumbers: PhoneNumberService.WithRawResponse by lazy {
+            PhoneNumberServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
         override fun withOptions(
@@ -96,18 +137,29 @@ class BlooioClientImpl(private val clientOptions: ClientOptions) : BlooioClient
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        /** Account and API key information */
+        /** Authentication and account information */
         override fun me(): MeService.WithRawResponse = me
 
-        /** Contact-related operations */
+        /** Manage contacts (phone numbers and emails) */
         override fun contacts(): ContactService.WithRawResponse = contacts
 
-        /** Send and manage individual messages */
-        override fun messages(): MessageService.WithRawResponse = messages
+        override fun location(): LocationService.WithRawResponse = location
+
+        /** Initiate FaceTime calls */
+        override fun facetime(): FacetimeService.WithRawResponse = facetime
+
+        /** Manage contact groups */
+        override fun groups(): GroupService.WithRawResponse = groups
+
+        /** Manage webhook subscriptions */
+        override fun webhooks(): WebhookService.WithRawResponse = webhooks
 
-        override fun config(): ConfigService.WithRawResponse = config
+        override fun chats(): ChatService.WithRawResponse = chats
 
-        /** Bulk/batch operations (stubbed) */
-        override fun batches(): BatchService.WithRawResponse = batches
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        override fun phoneNumbers(): PhoneNumberService.WithRawResponse = phoneNumbers
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
index 83da259..77df705 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
@@ -77,7 +77,7 @@ This can happen if you are either:
 
 Double-check that you are depending on compatible Jackson versions.
 
-See https://www.github.com/Blooio/blooio-java-sdk#jackson for more information.
+See https://www.github.com/stainless-sdks/blooio-java#jackson for more information.
         """
             .trimIndent()
     }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
index 5d2f3a9..a256292 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
@@ -93,7 +93,7 @@ private constructor(
      * Defaults to 2.
      */
     @get:JvmName("maxRetries") val maxRetries: Int,
-    /** API key must be provided in the Authorization header as `Bearer YOUR_API_KEY`. */
+    /** API key authentication. Use your API key as the bearer token. */
     @get:JvmName("apiKey") val apiKey: String,
 ) {
 
@@ -106,7 +106,7 @@ private constructor(
     /**
      * The base URL to use for every request.
      *
-     * Defaults to the production environment: `https://backend.blooio.com`.
+     * Defaults to the production environment: `https://backend.blooio.com/v2/api`.
      */
     fun baseUrl(): String = baseUrl ?: PRODUCTION_URL
 
@@ -114,7 +114,7 @@ private constructor(
 
     companion object {
 
-        const val PRODUCTION_URL = "https://backend.blooio.com"
+        const val PRODUCTION_URL = "https://backend.blooio.com/v2/api"
 
         /**
          * Returns a mutable builder for constructing an instance of [ClientOptions].
@@ -220,7 +220,7 @@ private constructor(
         /**
          * The base URL to use for every request.
          *
-         * Defaults to the production environment: `https://backend.blooio.com`.
+         * Defaults to the production environment: `https://backend.blooio.com/v2/api`.
          */
         fun baseUrl(baseUrl: String?) = apply { this.baseUrl = baseUrl }
 
@@ -271,7 +271,7 @@ private constructor(
          */
         fun maxRetries(maxRetries: Int) = apply { this.maxRetries = maxRetries }
 
-        /** API key must be provided in the Authorization header as `Bearer YOUR_API_KEY`. */
+        /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { this.apiKey = apiKey }
 
         fun headers(headers: Headers) = apply {
@@ -361,10 +361,10 @@ private constructor(
          *
          * See this table for the available options:
          *
-         * |Setter   |System property |Environment variable|Required|Default value                 |
-         * |---------|----------------|--------------------|--------|------------------------------|
-         * |`apiKey` |`blooio.apiKey` |`BLOOIO_API_KEY`    |true    |-                             |
-         * |`baseUrl`|`blooio.baseUrl`|`BLOOIO_BASE_URL`   |true    |`"https://backend.blooio.com"`|
+         * |Setter   |System property |Environment variable|Required|Default value                        |
+         * |---------|----------------|--------------------|--------|-------------------------------------|
+         * |`apiKey` |`blooio.apiKey` |`BLOOIO_API_KEY`    |true    |-                                    |
+         * |`baseUrl`|`blooio.baseUrl`|`BLOOIO_BASE_URL`   |true    |`"https://backend.blooio.com/v2/api"`|
          *
          * System properties take precedence over environment variables.
          */
@@ -375,6 +375,14 @@ private constructor(
             (System.getProperty("blooio.apiKey") ?: System.getenv("BLOOIO_API_KEY"))?.let {
                 apiKey(it)
             }
+            System.getenv("BLOOIO_CUSTOM_HEADERS")?.let { customHeadersEnv ->
+                for (line in customHeadersEnv.split("\n")) {
+                    val colon = line.indexOf(':')
+                    if (colon >= 0) {
+                        putHeader(line.substring(0, colon).trim(), line.substring(colon + 1).trim())
+                    }
+                }
+            }
         }
 
         /**
@@ -405,13 +413,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,
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/handlers/EmptyHandler.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/handlers/EmptyHandler.kt
deleted file mode 100644
index 1b2fcda..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/handlers/EmptyHandler.kt
+++ /dev/null
@@ -1,12 +0,0 @@
-@file:JvmName("EmptyHandler")
-
-package com.blooio.api.core.handlers
-
-import com.blooio.api.core.http.HttpResponse
-import com.blooio.api.core.http.HttpResponse.Handler
-
-@JvmSynthetic internal fun emptyHandler(): Handler<Void?> = EmptyHandlerInternal
-
-private object EmptyHandlerInternal : Handler<Void?> {
-    override fun handle(response: HttpResponse): Void? = null
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
index ed77d2a..97644f6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/RetryingHttpClient.kt
@@ -201,7 +201,7 @@ private constructor(
                     ?: headers.values("Retry-After").getOrNull(0)?.let { retryAfter ->
                         retryAfter.toFloatOrNull()?.times(TimeUnit.SECONDS.toNanos(1))
                             ?: try {
-                                ChronoUnit.MILLIS.between(
+                                ChronoUnit.NANOS.between(
                                     OffsetDateTime.now(clock),
                                     OffsetDateTime.parse(
                                         retryAfter,
@@ -214,13 +214,8 @@ private constructor(
                     }
             }
             ?.let { retryAfterNanos ->
-                // If the API asks us to wait a certain amount of time (and it's a reasonable
-                // amount), just
-                // do what it says.
-                val retryAfter = Duration.ofNanos(retryAfterNanos.toLong())
-                if (retryAfter in Duration.ofNanos(0)..Duration.ofMinutes(1)) {
-                    return retryAfter
-                }
+                // If the API asks us to wait a certain amount of time, do what it says.
+                return Duration.ofNanos(retryAfterNanos.toLong())
             }
 
         // Apply exponential backoff, but not more than the max.
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
new file mode 100644
index 0000000..0c2c079
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
@@ -0,0 +1,385 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonCreator
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all unique conversations for the organization, sorted by most recent message. */
+class ChatListParams
+private constructor(
+    private val limit: Long?,
+    private val offset: Long?,
+    private val q: String?,
+    private val sort: Sort?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Search query (matches phone/email or contact name) */
+    fun q(): Optional<String> = Optional.ofNullable(q)
+
+    /** Sort order */
+    fun sort(): Optional<Sort> = Optional.ofNullable(sort)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ChatListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ChatListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatListParams]. */
+    class Builder internal constructor() {
+
+        private var limit: Long? = null
+        private var offset: Long? = null
+        private var q: String? = null
+        private var sort: Sort? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(chatListParams: ChatListParams) = apply {
+            limit = chatListParams.limit
+            offset = chatListParams.offset
+            q = chatListParams.q
+            sort = chatListParams.sort
+            additionalHeaders = chatListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = chatListParams.additionalQueryParams.toBuilder()
+        }
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        /** Search query (matches phone/email or contact name) */
+        fun q(q: String?) = apply { this.q = q }
+
+        /** Alias for calling [Builder.q] with `q.orElse(null)`. */
+        fun q(q: Optional<String>) = q(q.getOrNull())
+
+        /** Sort order */
+        fun sort(sort: Sort?) = apply { this.sort = sort }
+
+        /** Alias for calling [Builder.sort] with `sort.orElse(null)`. */
+        fun sort(sort: Optional<Sort>) = sort(sort.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatListParams =
+            ChatListParams(
+                limit,
+                offset,
+                q,
+                sort,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                limit?.let { put("limit", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                q?.let { put("q", it) }
+                sort?.let { put("sort", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    /** Sort order */
+    class Sort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RECENT = of("recent")
+
+            @JvmField val OLDEST = of("oldest")
+
+            @JvmStatic fun of(value: String) = Sort(JsonField.of(value))
+        }
+
+        /** An enum containing [Sort]'s known values. */
+        enum class Known {
+            RECENT,
+            OLDEST,
+        }
+
+        /**
+         * An enum containing [Sort]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Sort] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RECENT,
+            OLDEST,
+            /** An enum member indicating that [Sort] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RECENT -> Value.RECENT
+                OLDEST -> Value.OLDEST
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RECENT -> Known.RECENT
+                OLDEST -> Known.OLDEST
+                else -> throw BlooioInvalidDataException("Unknown Sort: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sort = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sort && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatListParams &&
+            limit == other.limit &&
+            offset == other.offset &&
+            q == other.q &&
+            sort == other.sort &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(limit, offset, q, sort, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ChatListParams{limit=$limit, offset=$offset, q=$q, sort=$sort, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
new file mode 100644
index 0000000..ab5e950
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
@@ -0,0 +1,1274 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ChatListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chats: JsonField<List<Chat>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chats") @ExcludeMissing chats: JsonField<List<Chat>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(chats, pagination, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chats(): Optional<List<Chat>> = chats.getOptional("chats")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [chats].
+     *
+     * Unlike [chats], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chats") @ExcludeMissing fun _chats(): JsonField<List<Chat>> = chats
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ChatListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatListResponse]. */
+    class Builder internal constructor() {
+
+        private var chats: JsonField<MutableList<Chat>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatListResponse: ChatListResponse) = apply {
+            chats = chatListResponse.chats.map { it.toMutableList() }
+            pagination = chatListResponse.pagination
+            additionalProperties = chatListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun chats(chats: List<Chat>) = chats(JsonField.of(chats))
+
+        /**
+         * Sets [Builder.chats] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chats] with a well-typed `List<Chat>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun chats(chats: JsonField<List<Chat>>) = apply {
+            this.chats = chats.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Chat] to [chats].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addChat(chat: Chat) = apply {
+            chats =
+                (chats ?: JsonField.of(mutableListOf())).also { checkKnown("chats", it).add(chat) }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatListResponse =
+            ChatListResponse(
+                (chats ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ChatListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chats().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (chats.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    class Chat
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val contact: JsonField<Contact>,
+        private val groupId: JsonField<String>,
+        private val groupName: JsonField<String>,
+        private val inboundCount: JsonField<Long>,
+        private val isGroup: JsonField<Boolean>,
+        private val lastInboundTime: JsonField<Long>,
+        private val lastMessage: JsonField<LastMessage>,
+        private val lastMessageTime: JsonField<Long>,
+        private val lastOutboundTime: JsonField<Long>,
+        private val memberCount: JsonField<Long>,
+        private val messageCount: JsonField<Long>,
+        private val outboundCount: JsonField<Long>,
+        private val type: JsonField<Type>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
+            @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("group_name")
+            @ExcludeMissing
+            groupName: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("inbound_count")
+            @ExcludeMissing
+            inboundCount: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("is_group")
+            @ExcludeMissing
+            isGroup: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("last_inbound_time")
+            @ExcludeMissing
+            lastInboundTime: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("last_message")
+            @ExcludeMissing
+            lastMessage: JsonField<LastMessage> = JsonMissing.of(),
+            @JsonProperty("last_message_time")
+            @ExcludeMissing
+            lastMessageTime: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("last_outbound_time")
+            @ExcludeMissing
+            lastOutboundTime: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("member_count")
+            @ExcludeMissing
+            memberCount: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("message_count")
+            @ExcludeMissing
+            messageCount: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("outbound_count")
+            @ExcludeMissing
+            outboundCount: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        ) : this(
+            id,
+            contact,
+            groupId,
+            groupName,
+            inboundCount,
+            isGroup,
+            lastInboundTime,
+            lastMessage,
+            lastMessageTime,
+            lastOutboundTime,
+            memberCount,
+            messageCount,
+            outboundCount,
+            type,
+            mutableMapOf(),
+        )
+
+        /**
+         * Chat identifier (phone number, email, or group ID)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * Contact info (only for non-group chats)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contact(): Optional<Contact> = contact.getOptional("contact")
+
+        /**
+         * Group ID (only for group chats)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+        /**
+         * Group name (only for group chats)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun groupName(): Optional<String> = groupName.getOptional("group_name")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun inboundCount(): Optional<Long> = inboundCount.getOptional("inbound_count")
+
+        /**
+         * Whether this is a group chat
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun isGroup(): Optional<Boolean> = isGroup.getOptional("is_group")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastInboundTime(): Optional<Long> = lastInboundTime.getOptional("last_inbound_time")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastMessage(): Optional<LastMessage> = lastMessage.getOptional("last_message")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastOutboundTime(): Optional<Long> = lastOutboundTime.getOptional("last_outbound_time")
+
+        /**
+         * Number of members (only for group chats)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun memberCount(): Optional<Long> = memberCount.getOptional("member_count")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageCount(): Optional<Long> = messageCount.getOptional("message_count")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun outboundCount(): Optional<Long> = outboundCount.getOptional("outbound_count")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun type(): Optional<Type> = type.getOptional("type")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [contact].
+         *
+         * Unlike [contact], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("contact") @ExcludeMissing fun _contact(): JsonField<Contact> = contact
+
+        /**
+         * Returns the raw JSON value of [groupId].
+         *
+         * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+        /**
+         * Returns the raw JSON value of [groupName].
+         *
+         * Unlike [groupName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("group_name") @ExcludeMissing fun _groupName(): JsonField<String> = groupName
+
+        /**
+         * Returns the raw JSON value of [inboundCount].
+         *
+         * Unlike [inboundCount], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("inbound_count")
+        @ExcludeMissing
+        fun _inboundCount(): JsonField<Long> = inboundCount
+
+        /**
+         * Returns the raw JSON value of [isGroup].
+         *
+         * Unlike [isGroup], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("is_group") @ExcludeMissing fun _isGroup(): JsonField<Boolean> = isGroup
+
+        /**
+         * Returns the raw JSON value of [lastInboundTime].
+         *
+         * Unlike [lastInboundTime], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("last_inbound_time")
+        @ExcludeMissing
+        fun _lastInboundTime(): JsonField<Long> = lastInboundTime
+
+        /**
+         * Returns the raw JSON value of [lastMessage].
+         *
+         * Unlike [lastMessage], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("last_message")
+        @ExcludeMissing
+        fun _lastMessage(): JsonField<LastMessage> = lastMessage
+
+        /**
+         * Returns the raw JSON value of [lastMessageTime].
+         *
+         * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+        /**
+         * Returns the raw JSON value of [lastOutboundTime].
+         *
+         * Unlike [lastOutboundTime], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("last_outbound_time")
+        @ExcludeMissing
+        fun _lastOutboundTime(): JsonField<Long> = lastOutboundTime
+
+        /**
+         * Returns the raw JSON value of [memberCount].
+         *
+         * Unlike [memberCount], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("member_count")
+        @ExcludeMissing
+        fun _memberCount(): JsonField<Long> = memberCount
+
+        /**
+         * Returns the raw JSON value of [messageCount].
+         *
+         * Unlike [messageCount], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("message_count")
+        @ExcludeMissing
+        fun _messageCount(): JsonField<Long> = messageCount
+
+        /**
+         * Returns the raw JSON value of [outboundCount].
+         *
+         * Unlike [outboundCount], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("outbound_count")
+        @ExcludeMissing
+        fun _outboundCount(): JsonField<Long> = outboundCount
+
+        /**
+         * Returns the raw JSON value of [type].
+         *
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Chat]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Chat]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String> = JsonMissing.of()
+            private var contact: JsonField<Contact> = JsonMissing.of()
+            private var groupId: JsonField<String> = JsonMissing.of()
+            private var groupName: JsonField<String> = JsonMissing.of()
+            private var inboundCount: JsonField<Long> = JsonMissing.of()
+            private var isGroup: JsonField<Boolean> = JsonMissing.of()
+            private var lastInboundTime: JsonField<Long> = JsonMissing.of()
+            private var lastMessage: JsonField<LastMessage> = JsonMissing.of()
+            private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+            private var lastOutboundTime: JsonField<Long> = JsonMissing.of()
+            private var memberCount: JsonField<Long> = JsonMissing.of()
+            private var messageCount: JsonField<Long> = JsonMissing.of()
+            private var outboundCount: JsonField<Long> = JsonMissing.of()
+            private var type: JsonField<Type> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(chat: Chat) = apply {
+                id = chat.id
+                contact = chat.contact
+                groupId = chat.groupId
+                groupName = chat.groupName
+                inboundCount = chat.inboundCount
+                isGroup = chat.isGroup
+                lastInboundTime = chat.lastInboundTime
+                lastMessage = chat.lastMessage
+                lastMessageTime = chat.lastMessageTime
+                lastOutboundTime = chat.lastOutboundTime
+                memberCount = chat.memberCount
+                messageCount = chat.messageCount
+                outboundCount = chat.outboundCount
+                type = chat.type
+                additionalProperties = chat.additionalProperties.toMutableMap()
+            }
+
+            /** Chat identifier (phone number, email, or group ID) */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** Contact info (only for non-group chats) */
+            fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
+
+            /** Alias for calling [Builder.contact] with `contact.orElse(null)`. */
+            fun contact(contact: Optional<Contact>) = contact(contact.getOrNull())
+
+            /**
+             * Sets [Builder.contact] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contact] with a well-typed [Contact] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun contact(contact: JsonField<Contact>) = apply { this.contact = contact }
+
+            /** Group ID (only for group chats) */
+            fun groupId(groupId: String?) = groupId(JsonField.ofNullable(groupId))
+
+            /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+            fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+            /**
+             * Sets [Builder.groupId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.groupId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+            /** Group name (only for group chats) */
+            fun groupName(groupName: String?) = groupName(JsonField.ofNullable(groupName))
+
+            /** Alias for calling [Builder.groupName] with `groupName.orElse(null)`. */
+            fun groupName(groupName: Optional<String>) = groupName(groupName.getOrNull())
+
+            /**
+             * Sets [Builder.groupName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.groupName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun groupName(groupName: JsonField<String>) = apply { this.groupName = groupName }
+
+            fun inboundCount(inboundCount: Long) = inboundCount(JsonField.of(inboundCount))
+
+            /**
+             * Sets [Builder.inboundCount] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.inboundCount] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun inboundCount(inboundCount: JsonField<Long>) = apply {
+                this.inboundCount = inboundCount
+            }
+
+            /** Whether this is a group chat */
+            fun isGroup(isGroup: Boolean) = isGroup(JsonField.of(isGroup))
+
+            /**
+             * Sets [Builder.isGroup] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.isGroup] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun isGroup(isGroup: JsonField<Boolean>) = apply { this.isGroup = isGroup }
+
+            fun lastInboundTime(lastInboundTime: Long?) =
+                lastInboundTime(JsonField.ofNullable(lastInboundTime))
+
+            /**
+             * Alias for [Builder.lastInboundTime].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun lastInboundTime(lastInboundTime: Long) = lastInboundTime(lastInboundTime as Long?)
+
+            /** Alias for calling [Builder.lastInboundTime] with `lastInboundTime.orElse(null)`. */
+            fun lastInboundTime(lastInboundTime: Optional<Long>) =
+                lastInboundTime(lastInboundTime.getOrNull())
+
+            /**
+             * Sets [Builder.lastInboundTime] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastInboundTime] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastInboundTime(lastInboundTime: JsonField<Long>) = apply {
+                this.lastInboundTime = lastInboundTime
+            }
+
+            fun lastMessage(lastMessage: LastMessage) = lastMessage(JsonField.of(lastMessage))
+
+            /**
+             * Sets [Builder.lastMessage] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastMessage] with a well-typed [LastMessage] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastMessage(lastMessage: JsonField<LastMessage>) = apply {
+                this.lastMessage = lastMessage
+            }
+
+            fun lastMessageTime(lastMessageTime: Long) =
+                lastMessageTime(JsonField.of(lastMessageTime))
+
+            /**
+             * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+                this.lastMessageTime = lastMessageTime
+            }
+
+            fun lastOutboundTime(lastOutboundTime: Long?) =
+                lastOutboundTime(JsonField.ofNullable(lastOutboundTime))
+
+            /**
+             * Alias for [Builder.lastOutboundTime].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun lastOutboundTime(lastOutboundTime: Long) =
+                lastOutboundTime(lastOutboundTime as Long?)
+
+            /**
+             * Alias for calling [Builder.lastOutboundTime] with `lastOutboundTime.orElse(null)`.
+             */
+            fun lastOutboundTime(lastOutboundTime: Optional<Long>) =
+                lastOutboundTime(lastOutboundTime.getOrNull())
+
+            /**
+             * Sets [Builder.lastOutboundTime] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastOutboundTime] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastOutboundTime(lastOutboundTime: JsonField<Long>) = apply {
+                this.lastOutboundTime = lastOutboundTime
+            }
+
+            /** Number of members (only for group chats) */
+            fun memberCount(memberCount: Long) = memberCount(JsonField.of(memberCount))
+
+            /**
+             * Sets [Builder.memberCount] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.memberCount] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun memberCount(memberCount: JsonField<Long>) = apply { this.memberCount = memberCount }
+
+            fun messageCount(messageCount: Long) = messageCount(JsonField.of(messageCount))
+
+            /**
+             * Sets [Builder.messageCount] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageCount] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageCount(messageCount: JsonField<Long>) = apply {
+                this.messageCount = messageCount
+            }
+
+            fun outboundCount(outboundCount: Long) = outboundCount(JsonField.of(outboundCount))
+
+            /**
+             * Sets [Builder.outboundCount] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.outboundCount] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun outboundCount(outboundCount: JsonField<Long>) = apply {
+                this.outboundCount = outboundCount
+            }
+
+            fun type(type: Type) = type(JsonField.of(type))
+
+            /**
+             * Sets [Builder.type] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun type(type: JsonField<Type>) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Chat].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Chat =
+                Chat(
+                    id,
+                    contact,
+                    groupId,
+                    groupName,
+                    inboundCount,
+                    isGroup,
+                    lastInboundTime,
+                    lastMessage,
+                    lastMessageTime,
+                    lastOutboundTime,
+                    memberCount,
+                    messageCount,
+                    outboundCount,
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Chat = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            contact().ifPresent { it.validate() }
+            groupId()
+            groupName()
+            inboundCount()
+            isGroup()
+            lastInboundTime()
+            lastMessage().ifPresent { it.validate() }
+            lastMessageTime()
+            lastOutboundTime()
+            memberCount()
+            messageCount()
+            outboundCount()
+            type().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (contact.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (groupId.asKnown().isPresent) 1 else 0) +
+                (if (groupName.asKnown().isPresent) 1 else 0) +
+                (if (inboundCount.asKnown().isPresent) 1 else 0) +
+                (if (isGroup.asKnown().isPresent) 1 else 0) +
+                (if (lastInboundTime.asKnown().isPresent) 1 else 0) +
+                (lastMessage.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+                (if (lastOutboundTime.asKnown().isPresent) 1 else 0) +
+                (if (memberCount.asKnown().isPresent) 1 else 0) +
+                (if (messageCount.asKnown().isPresent) 1 else 0) +
+                (if (outboundCount.asKnown().isPresent) 1 else 0) +
+                (type.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Contact info (only for non-group chats) */
+        class Contact
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val contactId: JsonField<String>,
+            private val identifier: JsonField<String>,
+            private val name: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("contact_id")
+                @ExcludeMissing
+                contactId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("identifier")
+                @ExcludeMissing
+                identifier: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            ) : this(contactId, identifier, name, mutableMapOf())
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun name(): Optional<String> = name.getOptional("name")
+
+            /**
+             * Returns the raw JSON value of [contactId].
+             *
+             * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("contact_id")
+            @ExcludeMissing
+            fun _contactId(): JsonField<String> = contactId
+
+            /**
+             * Returns the raw JSON value of [identifier].
+             *
+             * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("identifier")
+            @ExcludeMissing
+            fun _identifier(): JsonField<String> = identifier
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Contact]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Contact]. */
+            class Builder internal constructor() {
+
+                private var contactId: JsonField<String> = JsonMissing.of()
+                private var identifier: JsonField<String> = JsonMissing.of()
+                private var name: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(contact: Contact) = apply {
+                    contactId = contact.contactId
+                    identifier = contact.identifier
+                    name = contact.name
+                    additionalProperties = contact.additionalProperties.toMutableMap()
+                }
+
+                fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+                /**
+                 * Sets [Builder.contactId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.contactId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+                fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+                /**
+                 * Sets [Builder.identifier] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.identifier] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun identifier(identifier: JsonField<String>) = apply {
+                    this.identifier = identifier
+                }
+
+                fun name(name: String?) = name(JsonField.ofNullable(name))
+
+                /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+                fun name(name: Optional<String>) = name(name.getOrNull())
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Contact].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Contact =
+                    Contact(contactId, identifier, name, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            fun validate(): Contact = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                contactId()
+                identifier()
+                name()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (contactId.asKnown().isPresent) 1 else 0) +
+                    (if (identifier.asKnown().isPresent) 1 else 0) +
+                    (if (name.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Contact &&
+                    contactId == other.contactId &&
+                    identifier == other.identifier &&
+                    name == other.name &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(contactId, identifier, name, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Contact{contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+        }
+
+        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val PHONE = of("phone")
+
+                @JvmField val EMAIL = of("email")
+
+                @JvmField val GROUP = of("group")
+
+                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+            }
+
+            /** An enum containing [Type]'s known values. */
+            enum class Known {
+                PHONE,
+                EMAIL,
+                GROUP,
+            }
+
+            /**
+             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Type] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                PHONE,
+                EMAIL,
+                GROUP,
+                /** An enum member indicating that [Type] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    PHONE -> Value.PHONE
+                    EMAIL -> Value.EMAIL
+                    GROUP -> Value.GROUP
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    PHONE -> Known.PHONE
+                    EMAIL -> Known.EMAIL
+                    GROUP -> Known.GROUP
+                    else -> throw BlooioInvalidDataException("Unknown Type: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Type = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Type && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Chat &&
+                id == other.id &&
+                contact == other.contact &&
+                groupId == other.groupId &&
+                groupName == other.groupName &&
+                inboundCount == other.inboundCount &&
+                isGroup == other.isGroup &&
+                lastInboundTime == other.lastInboundTime &&
+                lastMessage == other.lastMessage &&
+                lastMessageTime == other.lastMessageTime &&
+                lastOutboundTime == other.lastOutboundTime &&
+                memberCount == other.memberCount &&
+                messageCount == other.messageCount &&
+                outboundCount == other.outboundCount &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                id,
+                contact,
+                groupId,
+                groupName,
+                inboundCount,
+                isGroup,
+                lastInboundTime,
+                lastMessage,
+                lastMessageTime,
+                lastOutboundTime,
+                memberCount,
+                messageCount,
+                outboundCount,
+                type,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Chat{id=$id, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatListResponse &&
+            chats == other.chats &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(chats, pagination, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ChatListResponse{chats=$chats, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParams.kt
new file mode 100644
index 0000000..67be4e1
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParams.kt
@@ -0,0 +1,229 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Mark all messages in a chat as read. This sends a read receipt to the sender. */
+class ChatMarkAsReadParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ChatMarkAsReadParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ChatMarkAsReadParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatMarkAsReadParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatMarkAsReadParams: ChatMarkAsReadParams) = apply {
+            chatId = chatMarkAsReadParams.chatId
+            additionalHeaders = chatMarkAsReadParams.additionalHeaders.toBuilder()
+            additionalQueryParams = chatMarkAsReadParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = chatMarkAsReadParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatMarkAsReadParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatMarkAsReadParams =
+            ChatMarkAsReadParams(
+                chatId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatMarkAsReadParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "ChatMarkAsReadParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
similarity index 69%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusResponse.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
index 4a7029d..b8539e0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats
 
 import com.blooio.api.core.Enum
 import com.blooio.api.core.ExcludeMissing
@@ -17,38 +17,59 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-class MessageGetStatusResponse
+class ChatMarkAsReadResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
-    private val messageId: JsonField<String>,
+    private val chatId: JsonField<String>,
+    private val markedAt: JsonField<Long>,
     private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("marked_at") @ExcludeMissing markedAt: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-    ) : this(messageId, status, mutableMapOf())
+    ) : this(chatId, markedAt, status, mutableMapOf())
 
     /**
+     * Chat identifier
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
 
     /**
+     * Timestamp when marked as read
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun markedAt(): Optional<Long> = markedAt.getOptional("marked_at")
+
+    /**
+     * Read status
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun status(): Optional<Status> = status.getOptional("status")
 
     /**
-     * Returns the raw JSON value of [messageId].
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [markedAt].
      *
-     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [markedAt], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+    @JsonProperty("marked_at") @ExcludeMissing fun _markedAt(): JsonField<Long> = markedAt
 
     /**
      * Returns the raw JSON value of [status].
@@ -71,35 +92,49 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [MessageGetStatusResponse]. */
+        /** Returns a mutable builder for constructing an instance of [ChatMarkAsReadResponse]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [MessageGetStatusResponse]. */
+    /** A builder for [ChatMarkAsReadResponse]. */
     class Builder internal constructor() {
 
-        private var messageId: JsonField<String> = JsonMissing.of()
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var markedAt: JsonField<Long> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(messageGetStatusResponse: MessageGetStatusResponse) = apply {
-            messageId = messageGetStatusResponse.messageId
-            status = messageGetStatusResponse.status
-            additionalProperties = messageGetStatusResponse.additionalProperties.toMutableMap()
+        internal fun from(chatMarkAsReadResponse: ChatMarkAsReadResponse) = apply {
+            chatId = chatMarkAsReadResponse.chatId
+            markedAt = chatMarkAsReadResponse.markedAt
+            status = chatMarkAsReadResponse.status
+            additionalProperties = chatMarkAsReadResponse.additionalProperties.toMutableMap()
         }
 
-        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+        /** Chat identifier */
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        /** Timestamp when marked as read */
+        fun markedAt(markedAt: Long) = markedAt(JsonField.of(markedAt))
 
         /**
-         * Sets [Builder.messageId] to an arbitrary JSON value.
+         * Sets [Builder.markedAt] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
+         * You should usually call [Builder.markedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+        fun markedAt(markedAt: JsonField<Long>) = apply { this.markedAt = markedAt }
 
+        /** Read status */
         fun status(status: Status) = status(JsonField.of(status))
 
         /**
@@ -130,22 +165,23 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [MessageGetStatusResponse].
+         * Returns an immutable instance of [ChatMarkAsReadResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): MessageGetStatusResponse =
-            MessageGetStatusResponse(messageId, status, additionalProperties.toMutableMap())
+        fun build(): ChatMarkAsReadResponse =
+            ChatMarkAsReadResponse(chatId, markedAt, status, additionalProperties.toMutableMap())
     }
 
     private var validated: Boolean = false
 
-    fun validate(): MessageGetStatusResponse = apply {
+    fun validate(): ChatMarkAsReadResponse = apply {
         if (validated) {
             return@apply
         }
 
-        messageId()
+        chatId()
+        markedAt()
         status().ifPresent { it.validate() }
         validated = true
     }
@@ -165,9 +201,11 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (if (messageId.asKnown().isPresent) 1 else 0) +
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (if (markedAt.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
+    /** Read status */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -182,32 +220,14 @@ private constructor(
 
         companion object {
 
-            @JvmField val PENDING = of("pending")
-
-            @JvmField val QUEUED = of("queued")
-
-            @JvmField val SENT = of("sent")
-
-            @JvmField val DELIVERED = of("delivered")
-
-            @JvmField val FAILED = of("failed")
-
-            @JvmField val CANCELLED = of("cancelled")
-
-            @JvmField val CANCELLATION_REQUESTED = of("cancellation_requested")
+            @JvmField val READ = of("read")
 
             @JvmStatic fun of(value: String) = Status(JsonField.of(value))
         }
 
         /** An enum containing [Status]'s known values. */
         enum class Known {
-            PENDING,
-            QUEUED,
-            SENT,
-            DELIVERED,
-            FAILED,
-            CANCELLED,
-            CANCELLATION_REQUESTED,
+            READ
         }
 
         /**
@@ -220,13 +240,7 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
-            PENDING,
-            QUEUED,
-            SENT,
-            DELIVERED,
-            FAILED,
-            CANCELLED,
-            CANCELLATION_REQUESTED,
+            READ,
             /** An enum member indicating that [Status] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -240,13 +254,7 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
-                PENDING -> Value.PENDING
-                QUEUED -> Value.QUEUED
-                SENT -> Value.SENT
-                DELIVERED -> Value.DELIVERED
-                FAILED -> Value.FAILED
-                CANCELLED -> Value.CANCELLED
-                CANCELLATION_REQUESTED -> Value.CANCELLATION_REQUESTED
+                READ -> Value.READ
                 else -> Value._UNKNOWN
             }
 
@@ -261,13 +269,7 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
-                PENDING -> Known.PENDING
-                QUEUED -> Known.QUEUED
-                SENT -> Known.SENT
-                DELIVERED -> Known.DELIVERED
-                FAILED -> Known.FAILED
-                CANCELLED -> Known.CANCELLED
-                CANCELLATION_REQUESTED -> Known.CANCELLATION_REQUESTED
+                READ -> Known.READ
                 else -> throw BlooioInvalidDataException("Unknown Status: $value")
             }
 
@@ -328,16 +330,19 @@ private constructor(
             return true
         }
 
-        return other is MessageGetStatusResponse &&
-            messageId == other.messageId &&
+        return other is ChatMarkAsReadResponse &&
+            chatId == other.chatId &&
+            markedAt == other.markedAt &&
             status == other.status &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(messageId, status, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, markedAt, status, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageGetStatusResponse{messageId=$messageId, status=$status, additionalProperties=$additionalProperties}"
+        "ChatMarkAsReadResponse{chatId=$chatId, markedAt=$markedAt, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveParams.kt
new file mode 100644
index 0000000..6a1740a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveParams.kt
@@ -0,0 +1,189 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Get details for a specific conversation. */
+class ChatRetrieveParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ChatRetrieveParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ChatRetrieveParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatRetrieveParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(chatRetrieveParams: ChatRetrieveParams) = apply {
+            chatId = chatRetrieveParams.chatId
+            additionalHeaders = chatRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = chatRetrieveParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatRetrieveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatRetrieveParams =
+            ChatRetrieveParams(chatId, additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatRetrieveParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(chatId, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ChatRetrieveParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
new file mode 100644
index 0000000..2dc1e56
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
@@ -0,0 +1,1086 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ChatRetrieveResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val contact: JsonField<Contact>,
+    private val firstMessageTime: JsonField<Long>,
+    private val groupId: JsonField<String>,
+    private val groupName: JsonField<String>,
+    private val inboundCount: JsonField<Long>,
+    private val isGroup: JsonField<Boolean>,
+    private val lastInboundTime: JsonField<Long>,
+    private val lastMessage: JsonField<LastMessage>,
+    private val lastMessageTime: JsonField<Long>,
+    private val lastOutboundTime: JsonField<Long>,
+    private val memberCount: JsonField<Long>,
+    private val messageCount: JsonField<Long>,
+    private val outboundCount: JsonField<Long>,
+    private val type: JsonField<Type>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
+        @JsonProperty("first_message_time")
+        @ExcludeMissing
+        firstMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("group_name") @ExcludeMissing groupName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("inbound_count")
+        @ExcludeMissing
+        inboundCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("is_group") @ExcludeMissing isGroup: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("last_inbound_time")
+        @ExcludeMissing
+        lastInboundTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("last_message")
+        @ExcludeMissing
+        lastMessage: JsonField<LastMessage> = JsonMissing.of(),
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        lastMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("last_outbound_time")
+        @ExcludeMissing
+        lastOutboundTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("member_count")
+        @ExcludeMissing
+        memberCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("message_count")
+        @ExcludeMissing
+        messageCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("outbound_count")
+        @ExcludeMissing
+        outboundCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+    ) : this(
+        id,
+        contact,
+        firstMessageTime,
+        groupId,
+        groupName,
+        inboundCount,
+        isGroup,
+        lastInboundTime,
+        lastMessage,
+        lastMessageTime,
+        lastOutboundTime,
+        memberCount,
+        messageCount,
+        outboundCount,
+        type,
+        mutableMapOf(),
+    )
+
+    /**
+     * Chat identifier (phone number, email, or group ID)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * Contact info (only for non-group chats)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contact(): Optional<Contact> = contact.getOptional("contact")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun firstMessageTime(): Optional<Long> = firstMessageTime.getOptional("first_message_time")
+
+    /**
+     * Group ID (only for group chats)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * Group name (only for group chats)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupName(): Optional<String> = groupName.getOptional("group_name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun inboundCount(): Optional<Long> = inboundCount.getOptional("inbound_count")
+
+    /**
+     * Whether this is a group chat
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun isGroup(): Optional<Boolean> = isGroup.getOptional("is_group")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastInboundTime(): Optional<Long> = lastInboundTime.getOptional("last_inbound_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessage(): Optional<LastMessage> = lastMessage.getOptional("last_message")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastOutboundTime(): Optional<Long> = lastOutboundTime.getOptional("last_outbound_time")
+
+    /**
+     * Number of members (only for group chats)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun memberCount(): Optional<Long> = memberCount.getOptional("member_count")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageCount(): Optional<Long> = messageCount.getOptional("message_count")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun outboundCount(): Optional<Long> = outboundCount.getOptional("outbound_count")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun type(): Optional<Type> = type.getOptional("type")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [contact].
+     *
+     * Unlike [contact], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("contact") @ExcludeMissing fun _contact(): JsonField<Contact> = contact
+
+    /**
+     * Returns the raw JSON value of [firstMessageTime].
+     *
+     * Unlike [firstMessageTime], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("first_message_time")
+    @ExcludeMissing
+    fun _firstMessageTime(): JsonField<Long> = firstMessageTime
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [groupName].
+     *
+     * Unlike [groupName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_name") @ExcludeMissing fun _groupName(): JsonField<String> = groupName
+
+    /**
+     * Returns the raw JSON value of [inboundCount].
+     *
+     * Unlike [inboundCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("inbound_count")
+    @ExcludeMissing
+    fun _inboundCount(): JsonField<Long> = inboundCount
+
+    /**
+     * Returns the raw JSON value of [isGroup].
+     *
+     * Unlike [isGroup], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("is_group") @ExcludeMissing fun _isGroup(): JsonField<Boolean> = isGroup
+
+    /**
+     * Returns the raw JSON value of [lastInboundTime].
+     *
+     * Unlike [lastInboundTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_inbound_time")
+    @ExcludeMissing
+    fun _lastInboundTime(): JsonField<Long> = lastInboundTime
+
+    /**
+     * Returns the raw JSON value of [lastMessage].
+     *
+     * Unlike [lastMessage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message")
+    @ExcludeMissing
+    fun _lastMessage(): JsonField<LastMessage> = lastMessage
+
+    /**
+     * Returns the raw JSON value of [lastMessageTime].
+     *
+     * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_time")
+    @ExcludeMissing
+    fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+    /**
+     * Returns the raw JSON value of [lastOutboundTime].
+     *
+     * Unlike [lastOutboundTime], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("last_outbound_time")
+    @ExcludeMissing
+    fun _lastOutboundTime(): JsonField<Long> = lastOutboundTime
+
+    /**
+     * Returns the raw JSON value of [memberCount].
+     *
+     * Unlike [memberCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("member_count") @ExcludeMissing fun _memberCount(): JsonField<Long> = memberCount
+
+    /**
+     * Returns the raw JSON value of [messageCount].
+     *
+     * Unlike [messageCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_count")
+    @ExcludeMissing
+    fun _messageCount(): JsonField<Long> = messageCount
+
+    /**
+     * Returns the raw JSON value of [outboundCount].
+     *
+     * Unlike [outboundCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("outbound_count")
+    @ExcludeMissing
+    fun _outboundCount(): JsonField<Long> = outboundCount
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ChatRetrieveResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatRetrieveResponse]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String> = JsonMissing.of()
+        private var contact: JsonField<Contact> = JsonMissing.of()
+        private var firstMessageTime: JsonField<Long> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var groupName: JsonField<String> = JsonMissing.of()
+        private var inboundCount: JsonField<Long> = JsonMissing.of()
+        private var isGroup: JsonField<Boolean> = JsonMissing.of()
+        private var lastInboundTime: JsonField<Long> = JsonMissing.of()
+        private var lastMessage: JsonField<LastMessage> = JsonMissing.of()
+        private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+        private var lastOutboundTime: JsonField<Long> = JsonMissing.of()
+        private var memberCount: JsonField<Long> = JsonMissing.of()
+        private var messageCount: JsonField<Long> = JsonMissing.of()
+        private var outboundCount: JsonField<Long> = JsonMissing.of()
+        private var type: JsonField<Type> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatRetrieveResponse: ChatRetrieveResponse) = apply {
+            id = chatRetrieveResponse.id
+            contact = chatRetrieveResponse.contact
+            firstMessageTime = chatRetrieveResponse.firstMessageTime
+            groupId = chatRetrieveResponse.groupId
+            groupName = chatRetrieveResponse.groupName
+            inboundCount = chatRetrieveResponse.inboundCount
+            isGroup = chatRetrieveResponse.isGroup
+            lastInboundTime = chatRetrieveResponse.lastInboundTime
+            lastMessage = chatRetrieveResponse.lastMessage
+            lastMessageTime = chatRetrieveResponse.lastMessageTime
+            lastOutboundTime = chatRetrieveResponse.lastOutboundTime
+            memberCount = chatRetrieveResponse.memberCount
+            messageCount = chatRetrieveResponse.messageCount
+            outboundCount = chatRetrieveResponse.outboundCount
+            type = chatRetrieveResponse.type
+            additionalProperties = chatRetrieveResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Chat identifier (phone number, email, or group ID) */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Contact info (only for non-group chats) */
+        fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
+
+        /** Alias for calling [Builder.contact] with `contact.orElse(null)`. */
+        fun contact(contact: Optional<Contact>) = contact(contact.getOrNull())
+
+        /**
+         * Sets [Builder.contact] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contact] with a well-typed [Contact] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun contact(contact: JsonField<Contact>) = apply { this.contact = contact }
+
+        fun firstMessageTime(firstMessageTime: Long) =
+            firstMessageTime(JsonField.of(firstMessageTime))
+
+        /**
+         * Sets [Builder.firstMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.firstMessageTime] with a well-typed [Long] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun firstMessageTime(firstMessageTime: JsonField<Long>) = apply {
+            this.firstMessageTime = firstMessageTime
+        }
+
+        /** Group ID (only for group chats) */
+        fun groupId(groupId: String?) = groupId(JsonField.ofNullable(groupId))
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** Group name (only for group chats) */
+        fun groupName(groupName: String?) = groupName(JsonField.ofNullable(groupName))
+
+        /** Alias for calling [Builder.groupName] with `groupName.orElse(null)`. */
+        fun groupName(groupName: Optional<String>) = groupName(groupName.getOrNull())
+
+        /**
+         * Sets [Builder.groupName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun groupName(groupName: JsonField<String>) = apply { this.groupName = groupName }
+
+        fun inboundCount(inboundCount: Long) = inboundCount(JsonField.of(inboundCount))
+
+        /**
+         * Sets [Builder.inboundCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.inboundCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun inboundCount(inboundCount: JsonField<Long>) = apply { this.inboundCount = inboundCount }
+
+        /** Whether this is a group chat */
+        fun isGroup(isGroup: Boolean) = isGroup(JsonField.of(isGroup))
+
+        /**
+         * Sets [Builder.isGroup] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.isGroup] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun isGroup(isGroup: JsonField<Boolean>) = apply { this.isGroup = isGroup }
+
+        fun lastInboundTime(lastInboundTime: Long?) =
+            lastInboundTime(JsonField.ofNullable(lastInboundTime))
+
+        /**
+         * Alias for [Builder.lastInboundTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastInboundTime(lastInboundTime: Long) = lastInboundTime(lastInboundTime as Long?)
+
+        /** Alias for calling [Builder.lastInboundTime] with `lastInboundTime.orElse(null)`. */
+        fun lastInboundTime(lastInboundTime: Optional<Long>) =
+            lastInboundTime(lastInboundTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastInboundTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastInboundTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastInboundTime(lastInboundTime: JsonField<Long>) = apply {
+            this.lastInboundTime = lastInboundTime
+        }
+
+        fun lastMessage(lastMessage: LastMessage) = lastMessage(JsonField.of(lastMessage))
+
+        /**
+         * Sets [Builder.lastMessage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessage] with a well-typed [LastMessage] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun lastMessage(lastMessage: JsonField<LastMessage>) = apply {
+            this.lastMessage = lastMessage
+        }
+
+        fun lastMessageTime(lastMessageTime: Long) = lastMessageTime(JsonField.of(lastMessageTime))
+
+        /**
+         * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+            this.lastMessageTime = lastMessageTime
+        }
+
+        fun lastOutboundTime(lastOutboundTime: Long?) =
+            lastOutboundTime(JsonField.ofNullable(lastOutboundTime))
+
+        /**
+         * Alias for [Builder.lastOutboundTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastOutboundTime(lastOutboundTime: Long) = lastOutboundTime(lastOutboundTime as Long?)
+
+        /** Alias for calling [Builder.lastOutboundTime] with `lastOutboundTime.orElse(null)`. */
+        fun lastOutboundTime(lastOutboundTime: Optional<Long>) =
+            lastOutboundTime(lastOutboundTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastOutboundTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastOutboundTime] with a well-typed [Long] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun lastOutboundTime(lastOutboundTime: JsonField<Long>) = apply {
+            this.lastOutboundTime = lastOutboundTime
+        }
+
+        /** Number of members (only for group chats) */
+        fun memberCount(memberCount: Long) = memberCount(JsonField.of(memberCount))
+
+        /**
+         * Sets [Builder.memberCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.memberCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun memberCount(memberCount: JsonField<Long>) = apply { this.memberCount = memberCount }
+
+        fun messageCount(messageCount: Long) = messageCount(JsonField.of(messageCount))
+
+        /**
+         * Sets [Builder.messageCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageCount(messageCount: JsonField<Long>) = apply { this.messageCount = messageCount }
+
+        fun outboundCount(outboundCount: Long) = outboundCount(JsonField.of(outboundCount))
+
+        /**
+         * Sets [Builder.outboundCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outboundCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outboundCount(outboundCount: JsonField<Long>) = apply {
+            this.outboundCount = outboundCount
+        }
+
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatRetrieveResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatRetrieveResponse =
+            ChatRetrieveResponse(
+                id,
+                contact,
+                firstMessageTime,
+                groupId,
+                groupName,
+                inboundCount,
+                isGroup,
+                lastInboundTime,
+                lastMessage,
+                lastMessageTime,
+                lastOutboundTime,
+                memberCount,
+                messageCount,
+                outboundCount,
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ChatRetrieveResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        contact().ifPresent { it.validate() }
+        firstMessageTime()
+        groupId()
+        groupName()
+        inboundCount()
+        isGroup()
+        lastInboundTime()
+        lastMessage().ifPresent { it.validate() }
+        lastMessageTime()
+        lastOutboundTime()
+        memberCount()
+        messageCount()
+        outboundCount()
+        type().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (contact.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (firstMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (groupName.asKnown().isPresent) 1 else 0) +
+            (if (inboundCount.asKnown().isPresent) 1 else 0) +
+            (if (isGroup.asKnown().isPresent) 1 else 0) +
+            (if (lastInboundTime.asKnown().isPresent) 1 else 0) +
+            (lastMessage.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (lastOutboundTime.asKnown().isPresent) 1 else 0) +
+            (if (memberCount.asKnown().isPresent) 1 else 0) +
+            (if (messageCount.asKnown().isPresent) 1 else 0) +
+            (if (outboundCount.asKnown().isPresent) 1 else 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Contact info (only for non-group chats) */
+    class Contact
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val contactId: JsonField<String>,
+        private val identifier: JsonField<String>,
+        private val name: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("contact_id")
+            @ExcludeMissing
+            contactId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("identifier")
+            @ExcludeMissing
+            identifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        ) : this(contactId, identifier, name, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Returns the raw JSON value of [contactId].
+         *
+         * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("contact_id") @ExcludeMissing fun _contactId(): JsonField<String> = contactId
+
+        /**
+         * Returns the raw JSON value of [identifier].
+         *
+         * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("identifier")
+        @ExcludeMissing
+        fun _identifier(): JsonField<String> = identifier
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Contact]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Contact]. */
+        class Builder internal constructor() {
+
+            private var contactId: JsonField<String> = JsonMissing.of()
+            private var identifier: JsonField<String> = JsonMissing.of()
+            private var name: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(contact: Contact) = apply {
+                contactId = contact.contactId
+                identifier = contact.identifier
+                name = contact.name
+                additionalProperties = contact.additionalProperties.toMutableMap()
+            }
+
+            fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+            /**
+             * Sets [Builder.contactId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+            fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+            /**
+             * Sets [Builder.identifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.identifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun identifier(identifier: JsonField<String>) = apply { this.identifier = identifier }
+
+            fun name(name: String?) = name(JsonField.ofNullable(name))
+
+            /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+            fun name(name: Optional<String>) = name(name.getOrNull())
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Contact].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Contact =
+                Contact(contactId, identifier, name, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Contact = apply {
+            if (validated) {
+                return@apply
+            }
+
+            contactId()
+            identifier()
+            name()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (contactId.asKnown().isPresent) 1 else 0) +
+                (if (identifier.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Contact &&
+                contactId == other.contactId &&
+                identifier == other.identifier &&
+                name == other.name &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(contactId, identifier, name, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Contact{contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+    }
+
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val PHONE = of("phone")
+
+            @JvmField val EMAIL = of("email")
+
+            @JvmField val GROUP = of("group")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            PHONE,
+            EMAIL,
+            GROUP,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            PHONE,
+            EMAIL,
+            GROUP,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                PHONE -> Value.PHONE
+                EMAIL -> Value.EMAIL
+                GROUP -> Value.GROUP
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                PHONE -> Known.PHONE
+                EMAIL -> Known.EMAIL
+                GROUP -> Known.GROUP
+                else -> throw BlooioInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatRetrieveResponse &&
+            id == other.id &&
+            contact == other.contact &&
+            firstMessageTime == other.firstMessageTime &&
+            groupId == other.groupId &&
+            groupName == other.groupName &&
+            inboundCount == other.inboundCount &&
+            isGroup == other.isGroup &&
+            lastInboundTime == other.lastInboundTime &&
+            lastMessage == other.lastMessage &&
+            lastMessageTime == other.lastMessageTime &&
+            lastOutboundTime == other.lastOutboundTime &&
+            memberCount == other.memberCount &&
+            messageCount == other.messageCount &&
+            outboundCount == other.outboundCount &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            contact,
+            firstMessageTime,
+            groupId,
+            groupName,
+            inboundCount,
+            isGroup,
+            lastInboundTime,
+            lastMessage,
+            lastMessageTime,
+            lastOutboundTime,
+            memberCount,
+            messageCount,
+            outboundCount,
+            type,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ChatRetrieveResponse{id=$id, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
new file mode 100644
index 0000000..1c9208e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
@@ -0,0 +1,236 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be piggybacked
+ * onto the next outgoing message (text or attachment) sent to this chat. This is idempotent —
+ * calling it multiple times is harmless.
+ */
+class ChatShareContactCardParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ChatShareContactCardParams = builder().build()
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ChatShareContactCardParams].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatShareContactCardParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatShareContactCardParams: ChatShareContactCardParams) = apply {
+            chatId = chatShareContactCardParams.chatId
+            additionalHeaders = chatShareContactCardParams.additionalHeaders.toBuilder()
+            additionalQueryParams = chatShareContactCardParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties =
+                chatShareContactCardParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatShareContactCardParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatShareContactCardParams =
+            ChatShareContactCardParams(
+                chatId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatShareContactCardParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "ChatShareContactCardParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
new file mode 100644
index 0000000..10e4993
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
@@ -0,0 +1,227 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class ChatShareContactCardResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatId: JsonField<String>,
+    private val message: JsonField<String>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(chatId, message, success, mutableMapOf())
+
+    /**
+     * Normalized chat identifier
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun message(): Optional<String> = message.getOptional("message")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [message].
+     *
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ChatShareContactCardResponse].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatShareContactCardResponse]. */
+    class Builder internal constructor() {
+
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var message: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatShareContactCardResponse: ChatShareContactCardResponse) = apply {
+            chatId = chatShareContactCardResponse.chatId
+            message = chatShareContactCardResponse.message
+            success = chatShareContactCardResponse.success
+            additionalProperties = chatShareContactCardResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Normalized chat identifier */
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        fun message(message: String) = message(JsonField.of(message))
+
+        /**
+         * Sets [Builder.message] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun message(message: JsonField<String>) = apply { this.message = message }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatShareContactCardResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatShareContactCardResponse =
+            ChatShareContactCardResponse(
+                chatId,
+                message,
+                success,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ChatShareContactCardResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatId()
+        message()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (if (message.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatShareContactCardResponse &&
+            chatId == other.chatId &&
+            message == other.message &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, message, success, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ChatShareContactCardResponse{chatId=$chatId, message=$message, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
new file mode 100644
index 0000000..e062062
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
@@ -0,0 +1,383 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class LastMessage
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val direction: JsonField<Direction>,
+    private val messageId: JsonField<String>,
+    private val text: JsonField<String>,
+    private val timeSent: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("direction")
+        @ExcludeMissing
+        direction: JsonField<Direction> = JsonMissing.of(),
+        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("time_sent") @ExcludeMissing timeSent: JsonField<Long> = JsonMissing.of(),
+    ) : this(direction, messageId, text, timeSent, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun direction(): Optional<Direction> = direction.getOptional("direction")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<String> = text.getOptional("text")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun timeSent(): Optional<Long> = timeSent.getOptional("time_sent")
+
+    /**
+     * Returns the raw JSON value of [direction].
+     *
+     * Unlike [direction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("direction") @ExcludeMissing fun _direction(): JsonField<Direction> = direction
+
+    /**
+     * Returns the raw JSON value of [messageId].
+     *
+     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [timeSent].
+     *
+     * Unlike [timeSent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("time_sent") @ExcludeMissing fun _timeSent(): JsonField<Long> = timeSent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [LastMessage]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LastMessage]. */
+    class Builder internal constructor() {
+
+        private var direction: JsonField<Direction> = JsonMissing.of()
+        private var messageId: JsonField<String> = JsonMissing.of()
+        private var text: JsonField<String> = JsonMissing.of()
+        private var timeSent: JsonField<Long> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(lastMessage: LastMessage) = apply {
+            direction = lastMessage.direction
+            messageId = lastMessage.messageId
+            text = lastMessage.text
+            timeSent = lastMessage.timeSent
+            additionalProperties = lastMessage.additionalProperties.toMutableMap()
+        }
+
+        fun direction(direction: Direction) = direction(JsonField.of(direction))
+
+        /**
+         * Sets [Builder.direction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.direction] with a well-typed [Direction] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun direction(direction: JsonField<Direction>) = apply { this.direction = direction }
+
+        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+        /**
+         * Sets [Builder.messageId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+        fun text(text: String?) = text(JsonField.ofNullable(text))
+
+        /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+        fun text(text: Optional<String>) = text(text.getOrNull())
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        fun timeSent(timeSent: Long) = timeSent(JsonField.of(timeSent))
+
+        /**
+         * Sets [Builder.timeSent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.timeSent] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun timeSent(timeSent: JsonField<Long>) = apply { this.timeSent = timeSent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [LastMessage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): LastMessage =
+            LastMessage(direction, messageId, text, timeSent, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): LastMessage = apply {
+        if (validated) {
+            return@apply
+        }
+
+        direction().ifPresent { it.validate() }
+        messageId()
+        text()
+        timeSent()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (direction.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (messageId.asKnown().isPresent) 1 else 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            (if (timeSent.asKnown().isPresent) 1 else 0)
+
+    class Direction @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INBOUND = of("inbound")
+
+            @JvmField val OUTBOUND = of("outbound")
+
+            @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
+        }
+
+        /** An enum containing [Direction]'s known values. */
+        enum class Known {
+            INBOUND,
+            OUTBOUND,
+        }
+
+        /**
+         * An enum containing [Direction]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Direction] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INBOUND,
+            OUTBOUND,
+            /**
+             * An enum member indicating that [Direction] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
+                else -> throw BlooioInvalidDataException("Unknown Direction: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Direction = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Direction && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LastMessage &&
+            direction == other.direction &&
+            messageId == other.messageId &&
+            text == other.text &&
+            timeSent == other.timeSent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(direction, messageId, text, timeSent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "LastMessage{direction=$direction, messageId=$messageId, text=$text, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParams.kt
new file mode 100644
index 0000000..eceee5b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParams.kt
@@ -0,0 +1,230 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Remove the background image from a conversation, reverting to the default appearance. */
+class BackgroundRemoveParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): BackgroundRemoveParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [BackgroundRemoveParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BackgroundRemoveParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(backgroundRemoveParams: BackgroundRemoveParams) = apply {
+            chatId = backgroundRemoveParams.chatId
+            additionalHeaders = backgroundRemoveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = backgroundRemoveParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties =
+                backgroundRemoveParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BackgroundRemoveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BackgroundRemoveParams =
+            BackgroundRemoveParams(
+                chatId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BackgroundRemoveParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "BackgroundRemoveParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchListMessagesParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParams.kt
similarity index 77%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchListMessagesParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParams.kt
index 2ff3330..6604efb 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchListMessagesParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.chats.background
 
 import com.blooio.api.core.Params
 import com.blooio.api.core.http.Headers
@@ -9,15 +9,18 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** List messages in a batch (stub) */
-class BatchListMessagesParams
+/**
+ * Get the current background image metadata for a conversation. Works for both 1-on-1 and group
+ * chats.
+ */
+class BackgroundRetrieveParams
 private constructor(
-    private val batchId: String?,
+    private val chatId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    fun batchId(): Optional<String> = Optional.ofNullable(batchId)
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
 
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
@@ -29,30 +32,30 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): BatchListMessagesParams = builder().build()
+        @JvmStatic fun none(): BackgroundRetrieveParams = builder().build()
 
-        /** Returns a mutable builder for constructing an instance of [BatchListMessagesParams]. */
+        /** Returns a mutable builder for constructing an instance of [BackgroundRetrieveParams]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [BatchListMessagesParams]. */
+    /** A builder for [BackgroundRetrieveParams]. */
     class Builder internal constructor() {
 
-        private var batchId: String? = null
+        private var chatId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
-        internal fun from(batchListMessagesParams: BatchListMessagesParams) = apply {
-            batchId = batchListMessagesParams.batchId
-            additionalHeaders = batchListMessagesParams.additionalHeaders.toBuilder()
-            additionalQueryParams = batchListMessagesParams.additionalQueryParams.toBuilder()
+        internal fun from(backgroundRetrieveParams: BackgroundRetrieveParams) = apply {
+            chatId = backgroundRetrieveParams.chatId
+            additionalHeaders = backgroundRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = backgroundRetrieveParams.additionalQueryParams.toBuilder()
         }
 
-        fun batchId(batchId: String?) = apply { this.batchId = batchId }
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
 
-        /** Alias for calling [Builder.batchId] with `batchId.orElse(null)`. */
-        fun batchId(batchId: Optional<String>) = batchId(batchId.getOrNull())
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -153,13 +156,13 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [BatchListMessagesParams].
+         * Returns an immutable instance of [BackgroundRetrieveParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): BatchListMessagesParams =
-            BatchListMessagesParams(
-                batchId,
+        fun build(): BackgroundRetrieveParams =
+            BackgroundRetrieveParams(
+                chatId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
             )
@@ -167,7 +170,7 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> batchId ?: ""
+            0 -> chatId ?: ""
             else -> ""
         }
 
@@ -180,14 +183,14 @@ private constructor(
             return true
         }
 
-        return other is BatchListMessagesParams &&
-            batchId == other.batchId &&
+        return other is BackgroundRetrieveParams &&
+            chatId == other.chatId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(batchId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(chatId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "BatchListMessagesParams{batchId=$batchId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "BackgroundRetrieveParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
new file mode 100644
index 0000000..39638a6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
@@ -0,0 +1,460 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.MultipartField
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.io.InputStream
+import java.nio.file.Path
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.io.path.inputStream
+import kotlin.io.path.name
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
+ *
+ * The uploaded image is converted into a PosterKit-compatible archive and applied to the iMessage
+ * conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP, HEIC/HEIF. Maximum
+ * file size: 10 MB.
+ */
+class BackgroundSetParams
+private constructor(
+    private val chatId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /**
+     * The image file to set as the chat background
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun background(): InputStream = body.background()
+
+    /**
+     * Returns the raw multipart value of [background].
+     *
+     * Unlike [background], this method doesn't throw if the multipart field has an unexpected type.
+     */
+    fun _background(): MultipartField<InputStream> = body._background()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BackgroundSetParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .background()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BackgroundSetParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(backgroundSetParams: BackgroundSetParams) = apply {
+            chatId = backgroundSetParams.chatId
+            body = backgroundSetParams.body.toBuilder()
+            additionalHeaders = backgroundSetParams.additionalHeaders.toBuilder()
+            additionalQueryParams = backgroundSetParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [background]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** The image file to set as the chat background */
+        fun background(background: InputStream) = apply { body.background(background) }
+
+        /**
+         * Sets [Builder.background] to an arbitrary multipart value.
+         *
+         * You should usually call [Builder.background] with a well-typed [InputStream] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun background(background: MultipartField<InputStream>) = apply {
+            body.background(background)
+        }
+
+        /** The image file to set as the chat background */
+        fun background(background: ByteArray) = apply { body.background(background) }
+
+        /** The image file to set as the chat background */
+        fun background(path: Path) = apply { body.background(path) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [BackgroundSetParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .background()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BackgroundSetParams =
+            BackgroundSetParams(
+                chatId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Map<String, MultipartField<*>> =
+        (mapOf("background" to _background()) +
+                _additionalBodyProperties().mapValues { (_, value) -> MultipartField.of(value) })
+            .toImmutable()
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    private constructor(
+        private val background: MultipartField<InputStream>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        /**
+         * The image file to set as the chat background
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun background(): InputStream = background.value.getRequired("background")
+
+        /**
+         * Returns the raw multipart value of [background].
+         *
+         * Unlike [background], this method doesn't throw if the multipart field has an unexpected
+         * type.
+         */
+        @JsonProperty("background")
+        @ExcludeMissing
+        fun _background(): MultipartField<InputStream> = background
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .background()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var background: MultipartField<InputStream>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                background = body.background
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** The image file to set as the chat background */
+            fun background(background: InputStream) = background(MultipartField.of(background))
+
+            /**
+             * Sets [Builder.background] to an arbitrary multipart value.
+             *
+             * You should usually call [Builder.background] with a well-typed [InputStream] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun background(background: MultipartField<InputStream>) = apply {
+                this.background = background
+            }
+
+            /** The image file to set as the chat background */
+            fun background(background: ByteArray) = background(background.inputStream())
+
+            /** The image file to set as the chat background */
+            fun background(path: Path) =
+                background(
+                    MultipartField.builder<InputStream>()
+                        .value(path.inputStream())
+                        .filename(path.name)
+                        .build()
+                )
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .background()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(checkRequired("background", background), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            background()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                background == other.background &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(background, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{background=$background, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BackgroundSetParams &&
+            chatId == other.chatId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "BackgroundSetParams{chatId=$chatId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
new file mode 100644
index 0000000..262582e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
@@ -0,0 +1,346 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Response for chat background operations */
+class ChatBackgroundResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val backgroundId: JsonField<String>,
+    private val backgroundVersion: JsonField<Long>,
+    private val changed: JsonField<Boolean>,
+    private val chatId: JsonField<String>,
+    private val hasBackground: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("background_id")
+        @ExcludeMissing
+        backgroundId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_version")
+        @ExcludeMissing
+        backgroundVersion: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("changed") @ExcludeMissing changed: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("has_background")
+        @ExcludeMissing
+        hasBackground: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(backgroundId, backgroundVersion, changed, chatId, hasBackground, mutableMapOf())
+
+    /**
+     * Unique identifier for the current background, or null if none
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
+
+    /**
+     * Version number of the background (for cache invalidation)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundVersion(): Optional<Long> = backgroundVersion.getOptional("background_version")
+
+    /**
+     * Whether the background was changed by this operation (only present on PUT)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun changed(): Optional<Boolean> = changed.getOptional("changed")
+
+    /**
+     * Normalized chat identifier (phone number, email, or group ID)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * Whether the chat currently has a background set
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun hasBackground(): Optional<Boolean> = hasBackground.getOptional("has_background")
+
+    /**
+     * Returns the raw JSON value of [backgroundId].
+     *
+     * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_id")
+    @ExcludeMissing
+    fun _backgroundId(): JsonField<String> = backgroundId
+
+    /**
+     * Returns the raw JSON value of [backgroundVersion].
+     *
+     * Unlike [backgroundVersion], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("background_version")
+    @ExcludeMissing
+    fun _backgroundVersion(): JsonField<Long> = backgroundVersion
+
+    /**
+     * Returns the raw JSON value of [changed].
+     *
+     * Unlike [changed], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("changed") @ExcludeMissing fun _changed(): JsonField<Boolean> = changed
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [hasBackground].
+     *
+     * Unlike [hasBackground], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("has_background")
+    @ExcludeMissing
+    fun _hasBackground(): JsonField<Boolean> = hasBackground
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ChatBackgroundResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ChatBackgroundResponse]. */
+    class Builder internal constructor() {
+
+        private var backgroundId: JsonField<String> = JsonMissing.of()
+        private var backgroundVersion: JsonField<Long> = JsonMissing.of()
+        private var changed: JsonField<Boolean> = JsonMissing.of()
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var hasBackground: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(chatBackgroundResponse: ChatBackgroundResponse) = apply {
+            backgroundId = chatBackgroundResponse.backgroundId
+            backgroundVersion = chatBackgroundResponse.backgroundVersion
+            changed = chatBackgroundResponse.changed
+            chatId = chatBackgroundResponse.chatId
+            hasBackground = chatBackgroundResponse.hasBackground
+            additionalProperties = chatBackgroundResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Unique identifier for the current background, or null if none */
+        fun backgroundId(backgroundId: String?) = backgroundId(JsonField.ofNullable(backgroundId))
+
+        /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
+        fun backgroundId(backgroundId: Optional<String>) = backgroundId(backgroundId.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundId(backgroundId: JsonField<String>) = apply {
+            this.backgroundId = backgroundId
+        }
+
+        /** Version number of the background (for cache invalidation) */
+        fun backgroundVersion(backgroundVersion: Long?) =
+            backgroundVersion(JsonField.ofNullable(backgroundVersion))
+
+        /**
+         * Alias for [Builder.backgroundVersion].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun backgroundVersion(backgroundVersion: Long) =
+            backgroundVersion(backgroundVersion as Long?)
+
+        /** Alias for calling [Builder.backgroundVersion] with `backgroundVersion.orElse(null)`. */
+        fun backgroundVersion(backgroundVersion: Optional<Long>) =
+            backgroundVersion(backgroundVersion.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundVersion] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundVersion] with a well-typed [Long] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun backgroundVersion(backgroundVersion: JsonField<Long>) = apply {
+            this.backgroundVersion = backgroundVersion
+        }
+
+        /** Whether the background was changed by this operation (only present on PUT) */
+        fun changed(changed: Boolean) = changed(JsonField.of(changed))
+
+        /**
+         * Sets [Builder.changed] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.changed] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun changed(changed: JsonField<Boolean>) = apply { this.changed = changed }
+
+        /** Normalized chat identifier (phone number, email, or group ID) */
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        /** Whether the chat currently has a background set */
+        fun hasBackground(hasBackground: Boolean) = hasBackground(JsonField.of(hasBackground))
+
+        /**
+         * Sets [Builder.hasBackground] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.hasBackground] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun hasBackground(hasBackground: JsonField<Boolean>) = apply {
+            this.hasBackground = hasBackground
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ChatBackgroundResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ChatBackgroundResponse =
+            ChatBackgroundResponse(
+                backgroundId,
+                backgroundVersion,
+                changed,
+                chatId,
+                hasBackground,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ChatBackgroundResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        backgroundId()
+        backgroundVersion()
+        changed()
+        chatId()
+        hasBackground()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (backgroundId.asKnown().isPresent) 1 else 0) +
+            (if (backgroundVersion.asKnown().isPresent) 1 else 0) +
+            (if (changed.asKnown().isPresent) 1 else 0) +
+            (if (chatId.asKnown().isPresent) 1 else 0) +
+            (if (hasBackground.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ChatBackgroundResponse &&
+            backgroundId == other.backgroundId &&
+            backgroundVersion == other.backgroundVersion &&
+            changed == other.changed &&
+            chatId == other.chatId &&
+            hasBackground == other.hasBackground &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            backgroundId,
+            backgroundVersion,
+            changed,
+            chatId,
+            hasBackground,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
new file mode 100644
index 0000000..e3d3ebf
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
@@ -0,0 +1,206 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+/**
+ * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are optional.
+ * Only applies when the message text (or the concatenated part text) is exactly a single http(s)
+ * URL. If omitted but the text is a URL, Blooio auto-fetches the page's Open Graph metadata to
+ * generate a preview. If the image download fails, the send still succeeds — Blooio silently falls
+ * back to the auto-generated preview.
+ */
+class LinkPreview
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val imageUrl: JsonField<String>,
+    private val title: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("title") @ExcludeMissing title: JsonField<String> = JsonMissing.of(),
+    ) : this(imageUrl, title, mutableMapOf())
+
+    /**
+     * HTTPS URL to an image (png, jpg, webp, gif). Blooio downloads the image server-side and
+     * attaches it as the rich-link hero. Max 16 MB. If the download fails or returns a non-image
+     * MIME, the send falls back to auto-fetched OG metadata.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+    /**
+     * Bold title line rendered in the iMessage bubble. Overrides the page's `<meta
+     * property="og:title">`.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun title(): Optional<String> = title.getOptional("title")
+
+    /**
+     * Returns the raw JSON value of [imageUrl].
+     *
+     * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
+
+    /**
+     * Returns the raw JSON value of [title].
+     *
+     * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [LinkPreview]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LinkPreview]. */
+    class Builder internal constructor() {
+
+        private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var title: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(linkPreview: LinkPreview) = apply {
+            imageUrl = linkPreview.imageUrl
+            title = linkPreview.title
+            additionalProperties = linkPreview.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * HTTPS URL to an image (png, jpg, webp, gif). Blooio downloads the image server-side and
+         * attaches it as the rich-link hero. Max 16 MB. If the download fails or returns a
+         * non-image MIME, the send falls back to auto-fetched OG metadata.
+         */
+        fun imageUrl(imageUrl: String) = imageUrl(JsonField.of(imageUrl))
+
+        /**
+         * Sets [Builder.imageUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.imageUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+        /**
+         * Bold title line rendered in the iMessage bubble. Overrides the page's `<meta
+         * property="og:title">`.
+         */
+        fun title(title: String) = title(JsonField.of(title))
+
+        /**
+         * Sets [Builder.title] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.title] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun title(title: JsonField<String>) = apply { this.title = title }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [LinkPreview].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): LinkPreview = LinkPreview(imageUrl, title, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): LinkPreview = apply {
+        if (validated) {
+            return@apply
+        }
+
+        imageUrl()
+        title()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (imageUrl.asKnown().isPresent) 1 else 0) + (if (title.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LinkPreview &&
+            imageUrl == other.imageUrl &&
+            title == other.title &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(imageUrl, title, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "LinkPreview{imageUrl=$imageUrl, title=$title, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParams.kt
similarity index 84%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParams.kt
index bf14e64..0e18b4c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageGetStatusParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParams.kt
@@ -1,22 +1,26 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats.messages
 
 import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.QueryParams
 import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Get current delivery status only */
+/** Get delivery status for a specific message. */
 class MessageGetStatusParams
 private constructor(
+    private val chatId: String,
     private val messageId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
+    fun chatId(): String = chatId
+
     fun messageId(): Optional<String> = Optional.ofNullable(messageId)
 
     /** Additional headers to send with the request. */
@@ -29,26 +33,35 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): MessageGetStatusParams = builder().build()
-
-        /** Returns a mutable builder for constructing an instance of [MessageGetStatusParams]. */
+        /**
+         * Returns a mutable builder for constructing an instance of [MessageGetStatusParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         */
         @JvmStatic fun builder() = Builder()
     }
 
     /** A builder for [MessageGetStatusParams]. */
     class Builder internal constructor() {
 
+        private var chatId: String? = null
         private var messageId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
         internal fun from(messageGetStatusParams: MessageGetStatusParams) = apply {
+            chatId = messageGetStatusParams.chatId
             messageId = messageGetStatusParams.messageId
             additionalHeaders = messageGetStatusParams.additionalHeaders.toBuilder()
             additionalQueryParams = messageGetStatusParams.additionalQueryParams.toBuilder()
         }
 
+        fun chatId(chatId: String) = apply { this.chatId = chatId }
+
         fun messageId(messageId: String?) = apply { this.messageId = messageId }
 
         /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
@@ -156,9 +169,17 @@ private constructor(
          * Returns an immutable instance of [MessageGetStatusParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
          */
         fun build(): MessageGetStatusParams =
             MessageGetStatusParams(
+                checkRequired("chatId", chatId),
                 messageId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
@@ -167,7 +188,8 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> messageId ?: ""
+            0 -> chatId
+            1 -> messageId ?: ""
             else -> ""
         }
 
@@ -181,13 +203,15 @@ private constructor(
         }
 
         return other is MessageGetStatusParams &&
+            chatId == other.chatId &&
             messageId == other.messageId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(messageId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int =
+        Objects.hash(chatId, messageId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "MessageGetStatusParams{messageId=$messageId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "MessageGetStatusParams{chatId=$chatId, messageId=$messageId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
similarity index 65%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
index 59a17ee..6aaf8b0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats.messages
 
 import com.blooio.api.core.Enum
 import com.blooio.api.core.ExcludeMissing
@@ -17,50 +17,42 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-class MessageRetrieveResponse
+class MessageGetStatusResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
-    private val apiKey: JsonField<String>,
-    private val attachmentsCount: JsonField<Long>,
+    private val chatId: JsonField<String>,
     private val direction: JsonField<Direction>,
-    private val externalId: JsonField<String>,
+    private val error: JsonField<String>,
     private val messageId: JsonField<String>,
-    private val metadata: JsonValue,
-    private val protocol: JsonField<String>,
+    private val protocol: JsonField<Protocol>,
     private val status: JsonField<Status>,
-    private val textLength: JsonField<Long>,
+    private val timeDelivered: JsonField<Long>,
     private val timeSent: JsonField<Long>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("api_key") @ExcludeMissing apiKey: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("attachments_count")
-        @ExcludeMissing
-        attachmentsCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("direction")
         @ExcludeMissing
         direction: JsonField<Direction> = JsonMissing.of(),
-        @JsonProperty("external_id")
-        @ExcludeMissing
-        externalId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
         @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("metadata") @ExcludeMissing metadata: JsonValue = JsonMissing.of(),
-        @JsonProperty("protocol") @ExcludeMissing protocol: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("protocol") @ExcludeMissing protocol: JsonField<Protocol> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        @JsonProperty("text_length") @ExcludeMissing textLength: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("time_delivered")
+        @ExcludeMissing
+        timeDelivered: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("time_sent") @ExcludeMissing timeSent: JsonField<Long> = JsonMissing.of(),
     ) : this(
-        apiKey,
-        attachmentsCount,
+        chatId,
         direction,
-        externalId,
+        error,
         messageId,
-        metadata,
         protocol,
         status,
-        textLength,
+        timeDelivered,
         timeSent,
         mutableMapOf(),
     )
@@ -69,13 +61,7 @@ private constructor(
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun apiKey(): Optional<String> = apiKey.getOptional("api_key")
-
-    /**
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun attachmentsCount(): Optional<Long> = attachmentsCount.getOptional("attachments_count")
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
 
     /**
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -84,12 +70,10 @@ private constructor(
     fun direction(): Optional<Direction> = direction.getOptional("direction")
 
     /**
-     * Recipient phone number.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun externalId(): Optional<String> = externalId.getOptional("external_id")
+    fun error(): Optional<String> = error.getOptional("error")
 
     /**
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -98,26 +82,12 @@ private constructor(
     fun messageId(): Optional<String> = messageId.getOptional("message_id")
 
     /**
-     * Original metadata provided plus system generated fields.
-     *
-     * This arbitrary value can be deserialized into a custom type using the `convert` method:
-     * ```java
-     * MyClass myObject = messageRetrieveResponse.metadata().convert(MyClass.class);
-     * ```
-     */
-    @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
-
-    /**
-     * The protocol used to send the message (e.g., imessage, rcs, sms).
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun protocol(): Optional<String> = protocol.getOptional("protocol")
+    fun protocol(): Optional<Protocol> = protocol.getOptional("protocol")
 
     /**
-     * Current delivery status.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -127,32 +97,20 @@ private constructor(
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun textLength(): Optional<Long> = textLength.getOptional("text_length")
+    fun timeDelivered(): Optional<Long> = timeDelivered.getOptional("time_delivered")
 
     /**
-     * Unix timestamp (ms) when the message was queued/sent.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun timeSent(): Optional<Long> = timeSent.getOptional("time_sent")
 
     /**
-     * Returns the raw JSON value of [apiKey].
+     * Returns the raw JSON value of [chatId].
      *
-     * Unlike [apiKey], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("api_key") @ExcludeMissing fun _apiKey(): JsonField<String> = apiKey
-
-    /**
-     * Returns the raw JSON value of [attachmentsCount].
-     *
-     * Unlike [attachmentsCount], this method doesn't throw if the JSON field has an unexpected
-     * type.
-     */
-    @JsonProperty("attachments_count")
-    @ExcludeMissing
-    fun _attachmentsCount(): JsonField<Long> = attachmentsCount
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
 
     /**
      * Returns the raw JSON value of [direction].
@@ -162,11 +120,11 @@ private constructor(
     @JsonProperty("direction") @ExcludeMissing fun _direction(): JsonField<Direction> = direction
 
     /**
-     * Returns the raw JSON value of [externalId].
+     * Returns the raw JSON value of [error].
      *
-     * Unlike [externalId], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("external_id") @ExcludeMissing fun _externalId(): JsonField<String> = externalId
+    @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
 
     /**
      * Returns the raw JSON value of [messageId].
@@ -180,7 +138,7 @@ private constructor(
      *
      * Unlike [protocol], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("protocol") @ExcludeMissing fun _protocol(): JsonField<String> = protocol
+    @JsonProperty("protocol") @ExcludeMissing fun _protocol(): JsonField<Protocol> = protocol
 
     /**
      * Returns the raw JSON value of [status].
@@ -190,11 +148,13 @@ private constructor(
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
     /**
-     * Returns the raw JSON value of [textLength].
+     * Returns the raw JSON value of [timeDelivered].
      *
-     * Unlike [textLength], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [timeDelivered], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("text_length") @ExcludeMissing fun _textLength(): JsonField<Long> = textLength
+    @JsonProperty("time_delivered")
+    @ExcludeMissing
+    fun _timeDelivered(): JsonField<Long> = timeDelivered
 
     /**
      * Returns the raw JSON value of [timeSent].
@@ -217,63 +177,45 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [MessageRetrieveResponse]. */
+        /** Returns a mutable builder for constructing an instance of [MessageGetStatusResponse]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [MessageRetrieveResponse]. */
+    /** A builder for [MessageGetStatusResponse]. */
     class Builder internal constructor() {
 
-        private var apiKey: JsonField<String> = JsonMissing.of()
-        private var attachmentsCount: JsonField<Long> = JsonMissing.of()
+        private var chatId: JsonField<String> = JsonMissing.of()
         private var direction: JsonField<Direction> = JsonMissing.of()
-        private var externalId: JsonField<String> = JsonMissing.of()
+        private var error: JsonField<String> = JsonMissing.of()
         private var messageId: JsonField<String> = JsonMissing.of()
-        private var metadata: JsonValue = JsonMissing.of()
-        private var protocol: JsonField<String> = JsonMissing.of()
+        private var protocol: JsonField<Protocol> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
-        private var textLength: JsonField<Long> = JsonMissing.of()
+        private var timeDelivered: JsonField<Long> = JsonMissing.of()
         private var timeSent: JsonField<Long> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(messageRetrieveResponse: MessageRetrieveResponse) = apply {
-            apiKey = messageRetrieveResponse.apiKey
-            attachmentsCount = messageRetrieveResponse.attachmentsCount
-            direction = messageRetrieveResponse.direction
-            externalId = messageRetrieveResponse.externalId
-            messageId = messageRetrieveResponse.messageId
-            metadata = messageRetrieveResponse.metadata
-            protocol = messageRetrieveResponse.protocol
-            status = messageRetrieveResponse.status
-            textLength = messageRetrieveResponse.textLength
-            timeSent = messageRetrieveResponse.timeSent
-            additionalProperties = messageRetrieveResponse.additionalProperties.toMutableMap()
+        internal fun from(messageGetStatusResponse: MessageGetStatusResponse) = apply {
+            chatId = messageGetStatusResponse.chatId
+            direction = messageGetStatusResponse.direction
+            error = messageGetStatusResponse.error
+            messageId = messageGetStatusResponse.messageId
+            protocol = messageGetStatusResponse.protocol
+            status = messageGetStatusResponse.status
+            timeDelivered = messageGetStatusResponse.timeDelivered
+            timeSent = messageGetStatusResponse.timeSent
+            additionalProperties = messageGetStatusResponse.additionalProperties.toMutableMap()
         }
 
-        fun apiKey(apiKey: String) = apiKey(JsonField.of(apiKey))
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
 
         /**
-         * Sets [Builder.apiKey] to an arbitrary JSON value.
+         * Sets [Builder.chatId] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.apiKey] with a well-typed [String] value instead. This
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun apiKey(apiKey: JsonField<String>) = apply { this.apiKey = apiKey }
-
-        fun attachmentsCount(attachmentsCount: Long) =
-            attachmentsCount(JsonField.of(attachmentsCount))
-
-        /**
-         * Sets [Builder.attachmentsCount] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.attachmentsCount] with a well-typed [Long] value
-         * instead. This method is primarily for setting the field to an undocumented or not yet
-         * supported value.
-         */
-        fun attachmentsCount(attachmentsCount: JsonField<Long>) = apply {
-            this.attachmentsCount = attachmentsCount
-        }
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
 
         fun direction(direction: Direction) = direction(JsonField.of(direction))
 
@@ -286,17 +228,18 @@ private constructor(
          */
         fun direction(direction: JsonField<Direction>) = apply { this.direction = direction }
 
-        /** Recipient phone number. */
-        fun externalId(externalId: String) = externalId(JsonField.of(externalId))
+        fun error(error: String?) = error(JsonField.ofNullable(error))
+
+        /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+        fun error(error: Optional<String>) = error(error.getOrNull())
 
         /**
-         * Sets [Builder.externalId] to an arbitrary JSON value.
+         * Sets [Builder.error] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.externalId] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
+         * You should usually call [Builder.error] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun externalId(externalId: JsonField<String>) = apply { this.externalId = externalId }
+        fun error(error: JsonField<String>) = apply { this.error = error }
 
         fun messageId(messageId: String) = messageId(JsonField.of(messageId))
 
@@ -309,22 +252,24 @@ private constructor(
          */
         fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
 
-        /** Original metadata provided plus system generated fields. */
-        fun metadata(metadata: JsonValue) = apply { this.metadata = metadata }
+        fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
 
-        /** The protocol used to send the message (e.g., imessage, rcs, sms). */
-        fun protocol(protocol: String) = protocol(JsonField.of(protocol))
+        /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
+        fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
 
         /**
          * Sets [Builder.protocol] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.protocol] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
+         * You should usually call [Builder.protocol] with a well-typed [Protocol] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
          */
-        fun protocol(protocol: JsonField<String>) = apply { this.protocol = protocol }
+        fun protocol(protocol: JsonField<Protocol>) = apply { this.protocol = protocol }
+
+        fun status(status: Status?) = status(JsonField.ofNullable(status))
 
-        /** Current delivery status. */
-        fun status(status: Status) = status(JsonField.of(status))
+        /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+        fun status(status: Optional<Status>) = status(status.getOrNull())
 
         /**
          * Sets [Builder.status] to an arbitrary JSON value.
@@ -334,17 +279,29 @@ private constructor(
          */
         fun status(status: JsonField<Status>) = apply { this.status = status }
 
-        fun textLength(textLength: Long) = textLength(JsonField.of(textLength))
+        fun timeDelivered(timeDelivered: Long?) = timeDelivered(JsonField.ofNullable(timeDelivered))
 
         /**
-         * Sets [Builder.textLength] to an arbitrary JSON value.
+         * Alias for [Builder.timeDelivered].
          *
-         * You should usually call [Builder.textLength] with a well-typed [Long] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
+         * This unboxed primitive overload exists for backwards compatibility.
          */
-        fun textLength(textLength: JsonField<Long>) = apply { this.textLength = textLength }
+        fun timeDelivered(timeDelivered: Long) = timeDelivered(timeDelivered as Long?)
+
+        /** Alias for calling [Builder.timeDelivered] with `timeDelivered.orElse(null)`. */
+        fun timeDelivered(timeDelivered: Optional<Long>) = timeDelivered(timeDelivered.getOrNull())
+
+        /**
+         * Sets [Builder.timeDelivered] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.timeDelivered] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun timeDelivered(timeDelivered: JsonField<Long>) = apply {
+            this.timeDelivered = timeDelivered
+        }
 
-        /** Unix timestamp (ms) when the message was queued/sent. */
         fun timeSent(timeSent: Long) = timeSent(JsonField.of(timeSent))
 
         /**
@@ -375,21 +332,19 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [MessageRetrieveResponse].
+         * Returns an immutable instance of [MessageGetStatusResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): MessageRetrieveResponse =
-            MessageRetrieveResponse(
-                apiKey,
-                attachmentsCount,
+        fun build(): MessageGetStatusResponse =
+            MessageGetStatusResponse(
+                chatId,
                 direction,
-                externalId,
+                error,
                 messageId,
-                metadata,
                 protocol,
                 status,
-                textLength,
+                timeDelivered,
                 timeSent,
                 additionalProperties.toMutableMap(),
             )
@@ -397,19 +352,18 @@ private constructor(
 
     private var validated: Boolean = false
 
-    fun validate(): MessageRetrieveResponse = apply {
+    fun validate(): MessageGetStatusResponse = apply {
         if (validated) {
             return@apply
         }
 
-        apiKey()
-        attachmentsCount()
+        chatId()
         direction().ifPresent { it.validate() }
-        externalId()
+        error()
         messageId()
-        protocol()
+        protocol().ifPresent { it.validate() }
         status().ifPresent { it.validate() }
-        textLength()
+        timeDelivered()
         timeSent()
         validated = true
     }
@@ -429,14 +383,13 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (if (apiKey.asKnown().isPresent) 1 else 0) +
-            (if (attachmentsCount.asKnown().isPresent) 1 else 0) +
+        (if (chatId.asKnown().isPresent) 1 else 0) +
             (direction.asKnown().getOrNull()?.validity() ?: 0) +
-            (if (externalId.asKnown().isPresent) 1 else 0) +
+            (if (error.asKnown().isPresent) 1 else 0) +
             (if (messageId.asKnown().isPresent) 1 else 0) +
-            (if (protocol.asKnown().isPresent) 1 else 0) +
+            (protocol.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
-            (if (textLength.asKnown().isPresent) 1 else 0) +
+            (if (timeDelivered.asKnown().isPresent) 1 else 0) +
             (if (timeSent.asKnown().isPresent) 1 else 0)
 
     class Direction @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
@@ -453,17 +406,17 @@ private constructor(
 
         companion object {
 
-            @JvmField val OUTBOUND = of("outbound")
-
             @JvmField val INBOUND = of("inbound")
 
+            @JvmField val OUTBOUND = of("outbound")
+
             @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
         }
 
         /** An enum containing [Direction]'s known values. */
         enum class Known {
-            OUTBOUND,
             INBOUND,
+            OUTBOUND,
         }
 
         /**
@@ -476,8 +429,8 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
-            OUTBOUND,
             INBOUND,
+            OUTBOUND,
             /**
              * An enum member indicating that [Direction] was instantiated with an unknown value.
              */
@@ -493,8 +446,8 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
-                OUTBOUND -> Value.OUTBOUND
                 INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
                 else -> Value._UNKNOWN
             }
 
@@ -509,8 +462,8 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
-                OUTBOUND -> Known.OUTBOUND
                 INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
                 else -> throw BlooioInvalidDataException("Unknown Direction: $value")
             }
 
@@ -566,7 +519,143 @@ private constructor(
         override fun toString() = value.toString()
     }
 
-    /** Current delivery status. */
+    class Protocol @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IMESSAGE = of("imessage")
+
+            @JvmField val SMS = of("sms")
+
+            @JvmField val RCS = of("rcs")
+
+            @JvmField val NON_IMESSAGE = of("non-imessage")
+
+            @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
+        }
+
+        /** An enum containing [Protocol]'s known values. */
+        enum class Known {
+            IMESSAGE,
+            SMS,
+            RCS,
+            NON_IMESSAGE,
+        }
+
+        /**
+         * An enum containing [Protocol]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Protocol] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IMESSAGE,
+            SMS,
+            RCS,
+            NON_IMESSAGE,
+            /** An enum member indicating that [Protocol] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IMESSAGE -> Value.IMESSAGE
+                SMS -> Value.SMS
+                RCS -> Value.RCS
+                NON_IMESSAGE -> Value.NON_IMESSAGE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IMESSAGE -> Known.IMESSAGE
+                SMS -> Known.SMS
+                RCS -> Known.RCS
+                NON_IMESSAGE -> Known.NON_IMESSAGE
+                else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Protocol = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Protocol && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -591,10 +680,10 @@ private constructor(
 
             @JvmField val FAILED = of("failed")
 
-            @JvmField val CANCELLED = of("cancelled")
-
             @JvmField val CANCELLATION_REQUESTED = of("cancellation_requested")
 
+            @JvmField val CANCELLED = of("cancelled")
+
             @JvmStatic fun of(value: String) = Status(JsonField.of(value))
         }
 
@@ -605,8 +694,8 @@ private constructor(
             SENT,
             DELIVERED,
             FAILED,
-            CANCELLED,
             CANCELLATION_REQUESTED,
+            CANCELLED,
         }
 
         /**
@@ -624,8 +713,8 @@ private constructor(
             SENT,
             DELIVERED,
             FAILED,
-            CANCELLED,
             CANCELLATION_REQUESTED,
+            CANCELLED,
             /** An enum member indicating that [Status] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -644,8 +733,8 @@ private constructor(
                 SENT -> Value.SENT
                 DELIVERED -> Value.DELIVERED
                 FAILED -> Value.FAILED
-                CANCELLED -> Value.CANCELLED
                 CANCELLATION_REQUESTED -> Value.CANCELLATION_REQUESTED
+                CANCELLED -> Value.CANCELLED
                 else -> Value._UNKNOWN
             }
 
@@ -665,8 +754,8 @@ private constructor(
                 SENT -> Known.SENT
                 DELIVERED -> Known.DELIVERED
                 FAILED -> Known.FAILED
-                CANCELLED -> Known.CANCELLED
                 CANCELLATION_REQUESTED -> Known.CANCELLATION_REQUESTED
+                CANCELLED -> Known.CANCELLED
                 else -> throw BlooioInvalidDataException("Unknown Status: $value")
             }
 
@@ -727,31 +816,27 @@ private constructor(
             return true
         }
 
-        return other is MessageRetrieveResponse &&
-            apiKey == other.apiKey &&
-            attachmentsCount == other.attachmentsCount &&
+        return other is MessageGetStatusResponse &&
+            chatId == other.chatId &&
             direction == other.direction &&
-            externalId == other.externalId &&
+            error == other.error &&
             messageId == other.messageId &&
-            metadata == other.metadata &&
             protocol == other.protocol &&
             status == other.status &&
-            textLength == other.textLength &&
+            timeDelivered == other.timeDelivered &&
             timeSent == other.timeSent &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
         Objects.hash(
-            apiKey,
-            attachmentsCount,
+            chatId,
             direction,
-            externalId,
+            error,
             messageId,
-            metadata,
             protocol,
             status,
-            textLength,
+            timeDelivered,
             timeSent,
             additionalProperties,
         )
@@ -760,5 +845,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageRetrieveResponse{apiKey=$apiKey, attachmentsCount=$attachmentsCount, direction=$direction, externalId=$externalId, messageId=$messageId, metadata=$metadata, protocol=$protocol, status=$status, textLength=$textLength, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+        "MessageGetStatusResponse{chatId=$chatId, direction=$direction, error=$error, messageId=$messageId, protocol=$protocol, status=$status, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
new file mode 100644
index 0000000..6761c61
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
@@ -0,0 +1,585 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonCreator
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all messages in a conversation with optional filtering. */
+class MessageListParams
+private constructor(
+    private val chatId: String?,
+    private val direction: Direction?,
+    private val limit: Long?,
+    private val offset: Long?,
+    private val since: Long?,
+    private val sort: Sort?,
+    private val until: Long?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Filter by message direction */
+    fun direction(): Optional<Direction> = Optional.ofNullable(direction)
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Only messages sent after this timestamp (ms) */
+    fun since(): Optional<Long> = Optional.ofNullable(since)
+
+    /** Sort order by time */
+    fun sort(): Optional<Sort> = Optional.ofNullable(sort)
+
+    /** Only messages sent before this timestamp (ms) */
+    fun until(): Optional<Long> = Optional.ofNullable(until)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): MessageListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [MessageListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageListParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var direction: Direction? = null
+        private var limit: Long? = null
+        private var offset: Long? = null
+        private var since: Long? = null
+        private var sort: Sort? = null
+        private var until: Long? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(messageListParams: MessageListParams) = apply {
+            chatId = messageListParams.chatId
+            direction = messageListParams.direction
+            limit = messageListParams.limit
+            offset = messageListParams.offset
+            since = messageListParams.since
+            sort = messageListParams.sort
+            until = messageListParams.until
+            additionalHeaders = messageListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = messageListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        /** Filter by message direction */
+        fun direction(direction: Direction?) = apply { this.direction = direction }
+
+        /** Alias for calling [Builder.direction] with `direction.orElse(null)`. */
+        fun direction(direction: Optional<Direction>) = direction(direction.getOrNull())
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        /** Only messages sent after this timestamp (ms) */
+        fun since(since: Long?) = apply { this.since = since }
+
+        /**
+         * Alias for [Builder.since].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun since(since: Long) = since(since as Long?)
+
+        /** Alias for calling [Builder.since] with `since.orElse(null)`. */
+        fun since(since: Optional<Long>) = since(since.getOrNull())
+
+        /** Sort order by time */
+        fun sort(sort: Sort?) = apply { this.sort = sort }
+
+        /** Alias for calling [Builder.sort] with `sort.orElse(null)`. */
+        fun sort(sort: Optional<Sort>) = sort(sort.getOrNull())
+
+        /** Only messages sent before this timestamp (ms) */
+        fun until(until: Long?) = apply { this.until = until }
+
+        /**
+         * Alias for [Builder.until].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun until(until: Long) = until(until as Long?)
+
+        /** Alias for calling [Builder.until] with `until.orElse(null)`. */
+        fun until(until: Optional<Long>) = until(until.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageListParams =
+            MessageListParams(
+                chatId,
+                direction,
+                limit,
+                offset,
+                since,
+                sort,
+                until,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                direction?.let { put("direction", it.toString()) }
+                limit?.let { put("limit", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                since?.let { put("since", it.toString()) }
+                sort?.let { put("sort", it.toString()) }
+                until?.let { put("until", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    /** Filter by message direction */
+    class Direction @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INBOUND = of("inbound")
+
+            @JvmField val OUTBOUND = of("outbound")
+
+            @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
+        }
+
+        /** An enum containing [Direction]'s known values. */
+        enum class Known {
+            INBOUND,
+            OUTBOUND,
+        }
+
+        /**
+         * An enum containing [Direction]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Direction] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INBOUND,
+            OUTBOUND,
+            /**
+             * An enum member indicating that [Direction] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
+                else -> throw BlooioInvalidDataException("Unknown Direction: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Direction = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Direction && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Sort order by time */
+    class Sort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val ASC = of("asc")
+
+            @JvmField val DESC = of("desc")
+
+            @JvmStatic fun of(value: String) = Sort(JsonField.of(value))
+        }
+
+        /** An enum containing [Sort]'s known values. */
+        enum class Known {
+            ASC,
+            DESC,
+        }
+
+        /**
+         * An enum containing [Sort]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Sort] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            ASC,
+            DESC,
+            /** An enum member indicating that [Sort] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                ASC -> Value.ASC
+                DESC -> Value.DESC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                ASC -> Known.ASC
+                DESC -> Known.DESC
+                else -> throw BlooioInvalidDataException("Unknown Sort: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sort = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sort && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageListParams &&
+            chatId == other.chatId &&
+            direction == other.direction &&
+            limit == other.limit &&
+            offset == other.offset &&
+            since == other.since &&
+            sort == other.sort &&
+            until == other.until &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            chatId,
+            direction,
+            limit,
+            offset,
+            since,
+            sort,
+            until,
+            additionalHeaders,
+            additionalQueryParams,
+        )
+
+    override fun toString() =
+        "MessageListParams{chatId=$chatId, direction=$direction, limit=$limit, offset=$offset, since=$since, sort=$sort, until=$until, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
new file mode 100644
index 0000000..819c4b0
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -0,0 +1,1346 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class MessageListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatId: JsonField<String>,
+    private val messages: JsonField<List<Message>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("messages")
+        @ExcludeMissing
+        messages: JsonField<List<Message>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(chatId, messages, pagination, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messages(): Optional<List<Message>> = messages.getOptional("messages")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [messages].
+     *
+     * Unlike [messages], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("messages") @ExcludeMissing fun _messages(): JsonField<List<Message>> = messages
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MessageListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageListResponse]. */
+    class Builder internal constructor() {
+
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var messages: JsonField<MutableList<Message>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(messageListResponse: MessageListResponse) = apply {
+            chatId = messageListResponse.chatId
+            messages = messageListResponse.messages.map { it.toMutableList() }
+            pagination = messageListResponse.pagination
+            additionalProperties = messageListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        fun messages(messages: List<Message>) = messages(JsonField.of(messages))
+
+        /**
+         * Sets [Builder.messages] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messages] with a well-typed `List<Message>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun messages(messages: JsonField<List<Message>>) = apply {
+            this.messages = messages.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Message] to [messages].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addMessage(message: Message) = apply {
+            messages =
+                (messages ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("messages", it).add(message)
+                }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageListResponse =
+            MessageListResponse(
+                chatId,
+                (messages ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MessageListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatId()
+        messages().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (messages.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    class Message
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val attachments: JsonField<List<JsonValue>>,
+        private val direction: JsonField<Direction>,
+        private val error: JsonField<String>,
+        private val externalId: JsonField<String>,
+        private val internalId: JsonField<String>,
+        private val messageId: JsonField<String>,
+        private val protocol: JsonField<Protocol>,
+        private val reactions: JsonField<List<Reaction>>,
+        private val sender: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val text: JsonField<String>,
+        private val timeDelivered: JsonField<Long>,
+        private val timeSent: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("attachments")
+            @ExcludeMissing
+            attachments: JsonField<List<JsonValue>> = JsonMissing.of(),
+            @JsonProperty("direction")
+            @ExcludeMissing
+            direction: JsonField<Direction> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("external_id")
+            @ExcludeMissing
+            externalId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("internal_id")
+            @ExcludeMissing
+            internalId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            messageId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("protocol")
+            @ExcludeMissing
+            protocol: JsonField<Protocol> = JsonMissing.of(),
+            @JsonProperty("reactions")
+            @ExcludeMissing
+            reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+            @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("time_delivered")
+            @ExcludeMissing
+            timeDelivered: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("time_sent") @ExcludeMissing timeSent: JsonField<Long> = JsonMissing.of(),
+        ) : this(
+            attachments,
+            direction,
+            error,
+            externalId,
+            internalId,
+            messageId,
+            protocol,
+            reactions,
+            sender,
+            status,
+            text,
+            timeDelivered,
+            timeSent,
+            mutableMapOf(),
+        )
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun attachments(): Optional<List<JsonValue>> = attachments.getOptional("attachments")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun direction(): Optional<Direction> = direction.getOptional("direction")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * Phone number or email of the contact, or group ID for group messages
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun externalId(): Optional<String> = externalId.getOptional("external_id")
+
+        /**
+         * Organization phone number (from-number) used for this message
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun internalId(): Optional<String> = internalId.getOptional("internal_id")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun protocol(): Optional<Protocol> = protocol.getOptional("protocol")
+
+        /**
+         * Reactions on this message (tapbacks and emoji reactions)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
+
+        /**
+         * Sender's phone number or email for inbound group messages. Null for outbound messages and
+         * 1-1 chats.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun sender(): Optional<String> = sender.getOptional("sender")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<String> = text.getOptional("text")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun timeDelivered(): Optional<Long> = timeDelivered.getOptional("time_delivered")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun timeSent(): Optional<Long> = timeSent.getOptional("time_sent")
+
+        /**
+         * Returns the raw JSON value of [attachments].
+         *
+         * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("attachments")
+        @ExcludeMissing
+        fun _attachments(): JsonField<List<JsonValue>> = attachments
+
+        /**
+         * Returns the raw JSON value of [direction].
+         *
+         * Unlike [direction], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("direction")
+        @ExcludeMissing
+        fun _direction(): JsonField<Direction> = direction
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [externalId].
+         *
+         * Unlike [externalId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("external_id")
+        @ExcludeMissing
+        fun _externalId(): JsonField<String> = externalId
+
+        /**
+         * Returns the raw JSON value of [internalId].
+         *
+         * Unlike [internalId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("internal_id")
+        @ExcludeMissing
+        fun _internalId(): JsonField<String> = internalId
+
+        /**
+         * Returns the raw JSON value of [messageId].
+         *
+         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+        /**
+         * Returns the raw JSON value of [protocol].
+         *
+         * Unlike [protocol], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("protocol") @ExcludeMissing fun _protocol(): JsonField<Protocol> = protocol
+
+        /**
+         * Returns the raw JSON value of [reactions].
+         *
+         * Unlike [reactions], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reactions")
+        @ExcludeMissing
+        fun _reactions(): JsonField<List<Reaction>> = reactions
+
+        /**
+         * Returns the raw JSON value of [sender].
+         *
+         * Unlike [sender], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("sender") @ExcludeMissing fun _sender(): JsonField<String> = sender
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        /**
+         * Returns the raw JSON value of [timeDelivered].
+         *
+         * Unlike [timeDelivered], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("time_delivered")
+        @ExcludeMissing
+        fun _timeDelivered(): JsonField<Long> = timeDelivered
+
+        /**
+         * Returns the raw JSON value of [timeSent].
+         *
+         * Unlike [timeSent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("time_sent") @ExcludeMissing fun _timeSent(): JsonField<Long> = timeSent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Message]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Message]. */
+        class Builder internal constructor() {
+
+            private var attachments: JsonField<MutableList<JsonValue>>? = null
+            private var direction: JsonField<Direction> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var externalId: JsonField<String> = JsonMissing.of()
+            private var internalId: JsonField<String> = JsonMissing.of()
+            private var messageId: JsonField<String> = JsonMissing.of()
+            private var protocol: JsonField<Protocol> = JsonMissing.of()
+            private var reactions: JsonField<MutableList<Reaction>>? = null
+            private var sender: JsonField<String> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var text: JsonField<String> = JsonMissing.of()
+            private var timeDelivered: JsonField<Long> = JsonMissing.of()
+            private var timeSent: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(message: Message) = apply {
+                attachments = message.attachments.map { it.toMutableList() }
+                direction = message.direction
+                error = message.error
+                externalId = message.externalId
+                internalId = message.internalId
+                messageId = message.messageId
+                protocol = message.protocol
+                reactions = message.reactions.map { it.toMutableList() }
+                sender = message.sender
+                status = message.status
+                text = message.text
+                timeDelivered = message.timeDelivered
+                timeSent = message.timeSent
+                additionalProperties = message.additionalProperties.toMutableMap()
+            }
+
+            fun attachments(attachments: List<JsonValue>) = attachments(JsonField.of(attachments))
+
+            /**
+             * Sets [Builder.attachments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.attachments] with a well-typed `List<JsonValue>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun attachments(attachments: JsonField<List<JsonValue>>) = apply {
+                this.attachments = attachments.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [JsonValue] to [attachments].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAttachment(attachment: JsonValue) = apply {
+                attachments =
+                    (attachments ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("attachments", it).add(attachment)
+                    }
+            }
+
+            fun direction(direction: Direction) = direction(JsonField.of(direction))
+
+            /**
+             * Sets [Builder.direction] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.direction] with a well-typed [Direction] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun direction(direction: JsonField<Direction>) = apply { this.direction = direction }
+
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            /** Phone number or email of the contact, or group ID for group messages */
+            fun externalId(externalId: String) = externalId(JsonField.of(externalId))
+
+            /**
+             * Sets [Builder.externalId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.externalId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun externalId(externalId: JsonField<String>) = apply { this.externalId = externalId }
+
+            /** Organization phone number (from-number) used for this message */
+            fun internalId(internalId: String?) = internalId(JsonField.ofNullable(internalId))
+
+            /** Alias for calling [Builder.internalId] with `internalId.orElse(null)`. */
+            fun internalId(internalId: Optional<String>) = internalId(internalId.getOrNull())
+
+            /**
+             * Sets [Builder.internalId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.internalId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun internalId(internalId: JsonField<String>) = apply { this.internalId = internalId }
+
+            fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+            /**
+             * Sets [Builder.messageId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+            fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
+
+            /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
+            fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+
+            /**
+             * Sets [Builder.protocol] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.protocol] with a well-typed [Protocol] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun protocol(protocol: JsonField<Protocol>) = apply { this.protocol = protocol }
+
+            /** Reactions on this message (tapbacks and emoji reactions) */
+            fun reactions(reactions: List<Reaction>) = reactions(JsonField.of(reactions))
+
+            /**
+             * Sets [Builder.reactions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reactions] with a well-typed `List<Reaction>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reactions(reactions: JsonField<List<Reaction>>) = apply {
+                this.reactions = reactions.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Reaction] to [reactions].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addReaction(reaction: Reaction) = apply {
+                reactions =
+                    (reactions ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("reactions", it).add(reaction)
+                    }
+            }
+
+            /**
+             * Sender's phone number or email for inbound group messages. Null for outbound messages
+             * and 1-1 chats.
+             */
+            fun sender(sender: String?) = sender(JsonField.ofNullable(sender))
+
+            /** Alias for calling [Builder.sender] with `sender.orElse(null)`. */
+            fun sender(sender: Optional<String>) = sender(sender.getOrNull())
+
+            /**
+             * Sets [Builder.sender] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.sender] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun sender(sender: JsonField<String>) = apply { this.sender = sender }
+
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun text(text: String?) = text(JsonField.ofNullable(text))
+
+            /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+            fun text(text: Optional<String>) = text(text.getOrNull())
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            fun timeDelivered(timeDelivered: Long?) =
+                timeDelivered(JsonField.ofNullable(timeDelivered))
+
+            /**
+             * Alias for [Builder.timeDelivered].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun timeDelivered(timeDelivered: Long) = timeDelivered(timeDelivered as Long?)
+
+            /** Alias for calling [Builder.timeDelivered] with `timeDelivered.orElse(null)`. */
+            fun timeDelivered(timeDelivered: Optional<Long>) =
+                timeDelivered(timeDelivered.getOrNull())
+
+            /**
+             * Sets [Builder.timeDelivered] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.timeDelivered] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun timeDelivered(timeDelivered: JsonField<Long>) = apply {
+                this.timeDelivered = timeDelivered
+            }
+
+            fun timeSent(timeSent: Long) = timeSent(JsonField.of(timeSent))
+
+            /**
+             * Sets [Builder.timeSent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.timeSent] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun timeSent(timeSent: JsonField<Long>) = apply { this.timeSent = timeSent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Message].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Message =
+                Message(
+                    (attachments ?: JsonMissing.of()).map { it.toImmutable() },
+                    direction,
+                    error,
+                    externalId,
+                    internalId,
+                    messageId,
+                    protocol,
+                    (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                    sender,
+                    status,
+                    text,
+                    timeDelivered,
+                    timeSent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Message = apply {
+            if (validated) {
+                return@apply
+            }
+
+            attachments()
+            direction().ifPresent { it.validate() }
+            error()
+            externalId()
+            internalId()
+            messageId()
+            protocol().ifPresent { it.validate() }
+            reactions().ifPresent { it.forEach { it.validate() } }
+            sender()
+            status().ifPresent { it.validate() }
+            text()
+            timeDelivered()
+            timeSent()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (attachments.asKnown().getOrNull()?.size ?: 0) +
+                (direction.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (externalId.asKnown().isPresent) 1 else 0) +
+                (if (internalId.asKnown().isPresent) 1 else 0) +
+                (if (messageId.asKnown().isPresent) 1 else 0) +
+                (protocol.asKnown().getOrNull()?.validity() ?: 0) +
+                (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (sender.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (text.asKnown().isPresent) 1 else 0) +
+                (if (timeDelivered.asKnown().isPresent) 1 else 0) +
+                (if (timeSent.asKnown().isPresent) 1 else 0)
+
+        class Direction @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val INBOUND = of("inbound")
+
+                @JvmField val OUTBOUND = of("outbound")
+
+                @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
+            }
+
+            /** An enum containing [Direction]'s known values. */
+            enum class Known {
+                INBOUND,
+                OUTBOUND,
+            }
+
+            /**
+             * An enum containing [Direction]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Direction] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                INBOUND,
+                OUTBOUND,
+                /**
+                 * An enum member indicating that [Direction] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    INBOUND -> Value.INBOUND
+                    OUTBOUND -> Value.OUTBOUND
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    INBOUND -> Known.INBOUND
+                    OUTBOUND -> Known.OUTBOUND
+                    else -> throw BlooioInvalidDataException("Unknown Direction: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Direction = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Direction && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        class Protocol @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMESSAGE = of("imessage")
+
+                @JvmField val SMS = of("sms")
+
+                @JvmField val RCS = of("rcs")
+
+                @JvmField val NON_IMESSAGE = of("non-imessage")
+
+                @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
+            }
+
+            /** An enum containing [Protocol]'s known values. */
+            enum class Known {
+                IMESSAGE,
+                SMS,
+                RCS,
+                NON_IMESSAGE,
+            }
+
+            /**
+             * An enum containing [Protocol]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Protocol] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMESSAGE,
+                SMS,
+                RCS,
+                NON_IMESSAGE,
+                /**
+                 * An enum member indicating that [Protocol] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMESSAGE -> Value.IMESSAGE
+                    SMS -> Value.SMS
+                    RCS -> Value.RCS
+                    NON_IMESSAGE -> Value.NON_IMESSAGE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMESSAGE -> Known.IMESSAGE
+                    SMS -> Known.SMS
+                    RCS -> Known.RCS
+                    NON_IMESSAGE -> Known.NON_IMESSAGE
+                    else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Protocol = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Protocol && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val PENDING = of("pending")
+
+                @JvmField val QUEUED = of("queued")
+
+                @JvmField val SENT = of("sent")
+
+                @JvmField val DELIVERED = of("delivered")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmField val CANCELLATION_REQUESTED = of("cancellation_requested")
+
+                @JvmField val CANCELLED = of("cancelled")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                PENDING,
+                QUEUED,
+                SENT,
+                DELIVERED,
+                FAILED,
+                CANCELLATION_REQUESTED,
+                CANCELLED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                PENDING,
+                QUEUED,
+                SENT,
+                DELIVERED,
+                FAILED,
+                CANCELLATION_REQUESTED,
+                CANCELLED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    PENDING -> Value.PENDING
+                    QUEUED -> Value.QUEUED
+                    SENT -> Value.SENT
+                    DELIVERED -> Value.DELIVERED
+                    FAILED -> Value.FAILED
+                    CANCELLATION_REQUESTED -> Value.CANCELLATION_REQUESTED
+                    CANCELLED -> Value.CANCELLED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    PENDING -> Known.PENDING
+                    QUEUED -> Known.QUEUED
+                    SENT -> Known.SENT
+                    DELIVERED -> Known.DELIVERED
+                    FAILED -> Known.FAILED
+                    CANCELLATION_REQUESTED -> Known.CANCELLATION_REQUESTED
+                    CANCELLED -> Known.CANCELLED
+                    else -> throw BlooioInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Message &&
+                attachments == other.attachments &&
+                direction == other.direction &&
+                error == other.error &&
+                externalId == other.externalId &&
+                internalId == other.internalId &&
+                messageId == other.messageId &&
+                protocol == other.protocol &&
+                reactions == other.reactions &&
+                sender == other.sender &&
+                status == other.status &&
+                text == other.text &&
+                timeDelivered == other.timeDelivered &&
+                timeSent == other.timeSent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                attachments,
+                direction,
+                error,
+                externalId,
+                internalId,
+                messageId,
+                protocol,
+                reactions,
+                sender,
+                status,
+                text,
+                timeDelivered,
+                timeSent,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageListResponse &&
+            chatId == other.chatId &&
+            messages == other.messages &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, messages, pagination, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MessageListResponse{chatId=$chatId, messages=$messages, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
new file mode 100644
index 0000000..abd189b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
@@ -0,0 +1,695 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Add or remove a reaction to a message. Supports classic iMessage tapbacks (love, like, dislike,
+ * laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).
+ *
+ * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
+ * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter by
+ * message direction (inbound/outbound only).
+ *
+ * Emoji reactions require macOS 14 (Sonoma) or later on the device.
+ */
+class MessageReactParams
+private constructor(
+    private val chatId: String,
+    private val messageId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): String = chatId
+
+    fun messageId(): Optional<String> = Optional.ofNullable(messageId)
+
+    /**
+     * The reaction to add or remove. Must be prefixed with `+` to add or `-` to remove.
+     *
+     * **Classic tapbacks:** `+love`, `-love`, `+like`, `-like`, `+dislike`, `-dislike`, `+laugh`,
+     * `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
+     *
+     * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`, `-🔥`).
+     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun reaction(): String = body.reaction()
+
+    /**
+     * Filter by message direction (only used when messageId is a relative index like -1, -2)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun direction(): Optional<Direction> = body.direction()
+
+    /**
+     * Returns the raw JSON value of [reaction].
+     *
+     * Unlike [reaction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _reaction(): JsonField<String> = body._reaction()
+
+    /**
+     * Returns the raw JSON value of [direction].
+     *
+     * Unlike [direction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _direction(): JsonField<Direction> = body._direction()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [MessageReactParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * .reaction()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageReactParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var messageId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(messageReactParams: MessageReactParams) = apply {
+            chatId = messageReactParams.chatId
+            messageId = messageReactParams.messageId
+            body = messageReactParams.body.toBuilder()
+            additionalHeaders = messageReactParams.additionalHeaders.toBuilder()
+            additionalQueryParams = messageReactParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String) = apply { this.chatId = chatId }
+
+        fun messageId(messageId: String?) = apply { this.messageId = messageId }
+
+        /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
+        fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [reaction]
+         * - [direction]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /**
+         * The reaction to add or remove. Must be prefixed with `+` to add or `-` to remove.
+         *
+         * **Classic tapbacks:** `+love`, `-love`, `+like`, `-like`, `+dislike`, `-dislike`,
+         * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
+         *
+         * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
+         * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+         */
+        fun reaction(reaction: String) = apply { body.reaction(reaction) }
+
+        /**
+         * Sets [Builder.reaction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reaction] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun reaction(reaction: JsonField<String>) = apply { body.reaction(reaction) }
+
+        /**
+         * Filter by message direction (only used when messageId is a relative index like -1, -2)
+         */
+        fun direction(direction: Direction) = apply { body.direction(direction) }
+
+        /**
+         * Sets [Builder.direction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.direction] with a well-typed [Direction] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun direction(direction: JsonField<Direction>) = apply { body.direction(direction) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageReactParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * .reaction()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): MessageReactParams =
+            MessageReactParams(
+                checkRequired("chatId", chatId),
+                messageId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId
+            1 -> messageId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val reaction: JsonField<String>,
+        private val direction: JsonField<Direction>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("reaction")
+            @ExcludeMissing
+            reaction: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("direction")
+            @ExcludeMissing
+            direction: JsonField<Direction> = JsonMissing.of(),
+        ) : this(reaction, direction, mutableMapOf())
+
+        /**
+         * The reaction to add or remove. Must be prefixed with `+` to add or `-` to remove.
+         *
+         * **Classic tapbacks:** `+love`, `-love`, `+like`, `-like`, `+dislike`, `-dislike`,
+         * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
+         *
+         * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
+         * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun reaction(): String = reaction.getRequired("reaction")
+
+        /**
+         * Filter by message direction (only used when messageId is a relative index like -1, -2)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun direction(): Optional<Direction> = direction.getOptional("direction")
+
+        /**
+         * Returns the raw JSON value of [reaction].
+         *
+         * Unlike [reaction], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reaction") @ExcludeMissing fun _reaction(): JsonField<String> = reaction
+
+        /**
+         * Returns the raw JSON value of [direction].
+         *
+         * Unlike [direction], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("direction")
+        @ExcludeMissing
+        fun _direction(): JsonField<Direction> = direction
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .reaction()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var reaction: JsonField<String>? = null
+            private var direction: JsonField<Direction> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                reaction = body.reaction
+                direction = body.direction
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The reaction to add or remove. Must be prefixed with `+` to add or `-` to remove.
+             *
+             * **Classic tapbacks:** `+love`, `-love`, `+like`, `-like`, `+dislike`, `-dislike`,
+             * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
+             *
+             * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
+             * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+             */
+            fun reaction(reaction: String) = reaction(JsonField.of(reaction))
+
+            /**
+             * Sets [Builder.reaction] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reaction] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reaction(reaction: JsonField<String>) = apply { this.reaction = reaction }
+
+            /**
+             * Filter by message direction (only used when messageId is a relative index like -1,
+             * -2)
+             */
+            fun direction(direction: Direction) = direction(JsonField.of(direction))
+
+            /**
+             * Sets [Builder.direction] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.direction] with a well-typed [Direction] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun direction(direction: JsonField<Direction>) = apply { this.direction = direction }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .reaction()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("reaction", reaction),
+                    direction,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            reaction()
+            direction().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (reaction.asKnown().isPresent) 1 else 0) +
+                (direction.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                reaction == other.reaction &&
+                direction == other.direction &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(reaction, direction, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{reaction=$reaction, direction=$direction, additionalProperties=$additionalProperties}"
+    }
+
+    /** Filter by message direction (only used when messageId is a relative index like -1, -2) */
+    class Direction @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INBOUND = of("inbound")
+
+            @JvmField val OUTBOUND = of("outbound")
+
+            @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
+        }
+
+        /** An enum containing [Direction]'s known values. */
+        enum class Known {
+            INBOUND,
+            OUTBOUND,
+        }
+
+        /**
+         * An enum containing [Direction]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Direction] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INBOUND,
+            OUTBOUND,
+            /**
+             * An enum member indicating that [Direction] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
+                else -> throw BlooioInvalidDataException("Unknown Direction: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Direction = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Direction && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageReactParams &&
+            chatId == other.chatId &&
+            messageId == other.messageId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, messageId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "MessageReactParams{chatId=$chatId, messageId=$messageId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
new file mode 100644
index 0000000..7d92561
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
@@ -0,0 +1,398 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class MessageReactResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val action: JsonField<Action>,
+    private val messageId: JsonField<String>,
+    private val reaction: JsonField<String>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("reaction") @ExcludeMissing reaction: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(action, messageId, reaction, success, mutableMapOf())
+
+    /**
+     * The action that was performed
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun action(): Optional<Action> = action.getOptional("action")
+
+    /**
+     * The ID of the message that was reacted to
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+    /**
+     * The reaction that was added or removed. For classic tapbacks: love, like, dislike, laugh,
+     * emphasize, question. For emoji reactions: the emoji character (e.g. 😂, 👍, 🔥).
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reaction(): Optional<String> = reaction.getOptional("reaction")
+
+    /**
+     * Whether the reaction was sent successfully
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [action].
+     *
+     * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+    /**
+     * Returns the raw JSON value of [messageId].
+     *
+     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+    /**
+     * Returns the raw JSON value of [reaction].
+     *
+     * Unlike [reaction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reaction") @ExcludeMissing fun _reaction(): JsonField<String> = reaction
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MessageReactResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageReactResponse]. */
+    class Builder internal constructor() {
+
+        private var action: JsonField<Action> = JsonMissing.of()
+        private var messageId: JsonField<String> = JsonMissing.of()
+        private var reaction: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(messageReactResponse: MessageReactResponse) = apply {
+            action = messageReactResponse.action
+            messageId = messageReactResponse.messageId
+            reaction = messageReactResponse.reaction
+            success = messageReactResponse.success
+            additionalProperties = messageReactResponse.additionalProperties.toMutableMap()
+        }
+
+        /** The action that was performed */
+        fun action(action: Action) = action(JsonField.of(action))
+
+        /**
+         * Sets [Builder.action] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.action] with a well-typed [Action] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun action(action: JsonField<Action>) = apply { this.action = action }
+
+        /** The ID of the message that was reacted to */
+        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+        /**
+         * Sets [Builder.messageId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+        /**
+         * The reaction that was added or removed. For classic tapbacks: love, like, dislike, laugh,
+         * emphasize, question. For emoji reactions: the emoji character (e.g. 😂, 👍, 🔥).
+         */
+        fun reaction(reaction: String) = reaction(JsonField.of(reaction))
+
+        /**
+         * Sets [Builder.reaction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reaction] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun reaction(reaction: JsonField<String>) = apply { this.reaction = reaction }
+
+        /** Whether the reaction was sent successfully */
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageReactResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageReactResponse =
+            MessageReactResponse(
+                action,
+                messageId,
+                reaction,
+                success,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MessageReactResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        action().ifPresent { it.validate() }
+        messageId()
+        reaction()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (action.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (messageId.asKnown().isPresent) 1 else 0) +
+            (if (reaction.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    /** The action that was performed */
+    class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val ADD = of("add")
+
+            @JvmField val REMOVE = of("remove")
+
+            @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+        }
+
+        /** An enum containing [Action]'s known values. */
+        enum class Known {
+            ADD,
+            REMOVE,
+        }
+
+        /**
+         * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Action] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            ADD,
+            REMOVE,
+            /** An enum member indicating that [Action] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                ADD -> Value.ADD
+                REMOVE -> Value.REMOVE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                ADD -> Known.ADD
+                REMOVE -> Known.REMOVE
+                else -> throw BlooioInvalidDataException("Unknown Action: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Action = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Action && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageReactResponse &&
+            action == other.action &&
+            messageId == other.messageId &&
+            reaction == other.reaction &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(action, messageId, reaction, success, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MessageReactResponse{action=$action, messageId=$messageId, reaction=$reaction, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParams.kt
similarity index 84%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParams.kt
index aeea016..bcba649 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageRetrieveParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParams.kt
@@ -1,25 +1,26 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats.messages
 
 import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.QueryParams
 import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/**
- * Retrieve full message metadata including direction, protocol, text length, attachments count,
- * timestamps, current status, and original metadata.
- */
+/** Get details for a specific message. */
 class MessageRetrieveParams
 private constructor(
+    private val chatId: String,
     private val messageId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
+    fun chatId(): String = chatId
+
     fun messageId(): Optional<String> = Optional.ofNullable(messageId)
 
     /** Additional headers to send with the request. */
@@ -32,26 +33,35 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): MessageRetrieveParams = builder().build()
-
-        /** Returns a mutable builder for constructing an instance of [MessageRetrieveParams]. */
+        /**
+         * Returns a mutable builder for constructing an instance of [MessageRetrieveParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         */
         @JvmStatic fun builder() = Builder()
     }
 
     /** A builder for [MessageRetrieveParams]. */
     class Builder internal constructor() {
 
+        private var chatId: String? = null
         private var messageId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
         internal fun from(messageRetrieveParams: MessageRetrieveParams) = apply {
+            chatId = messageRetrieveParams.chatId
             messageId = messageRetrieveParams.messageId
             additionalHeaders = messageRetrieveParams.additionalHeaders.toBuilder()
             additionalQueryParams = messageRetrieveParams.additionalQueryParams.toBuilder()
         }
 
+        fun chatId(chatId: String) = apply { this.chatId = chatId }
+
         fun messageId(messageId: String?) = apply { this.messageId = messageId }
 
         /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
@@ -159,9 +169,17 @@ private constructor(
          * Returns an immutable instance of [MessageRetrieveParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
          */
         fun build(): MessageRetrieveParams =
             MessageRetrieveParams(
+                checkRequired("chatId", chatId),
                 messageId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
@@ -170,7 +188,8 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> messageId ?: ""
+            0 -> chatId
+            1 -> messageId ?: ""
             else -> ""
         }
 
@@ -184,13 +203,15 @@ private constructor(
         }
 
         return other is MessageRetrieveParams &&
+            chatId == other.chatId &&
             messageId == other.messageId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(messageId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int =
+        Objects.hash(chatId, messageId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "MessageRetrieveParams{messageId=$messageId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "MessageRetrieveParams{chatId=$chatId, messageId=$messageId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
new file mode 100644
index 0000000..3d96814
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -0,0 +1,1332 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class MessageRetrieveResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val attachments: JsonField<List<JsonValue>>,
+    private val chatId: JsonField<String>,
+    private val contact: JsonField<Contact>,
+    private val direction: JsonField<Direction>,
+    private val error: JsonField<String>,
+    private val internalId: JsonField<String>,
+    private val messageId: JsonField<String>,
+    private val protocol: JsonField<Protocol>,
+    private val reactions: JsonField<List<Reaction>>,
+    private val sender: JsonField<String>,
+    private val status: JsonField<Status>,
+    private val text: JsonField<String>,
+    private val timeDelivered: JsonField<Long>,
+    private val timeSent: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("attachments")
+        @ExcludeMissing
+        attachments: JsonField<List<JsonValue>> = JsonMissing.of(),
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
+        @JsonProperty("direction")
+        @ExcludeMissing
+        direction: JsonField<Direction> = JsonMissing.of(),
+        @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("internal_id")
+        @ExcludeMissing
+        internalId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("protocol") @ExcludeMissing protocol: JsonField<Protocol> = JsonMissing.of(),
+        @JsonProperty("reactions")
+        @ExcludeMissing
+        reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+        @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("time_delivered")
+        @ExcludeMissing
+        timeDelivered: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("time_sent") @ExcludeMissing timeSent: JsonField<Long> = JsonMissing.of(),
+    ) : this(
+        attachments,
+        chatId,
+        contact,
+        direction,
+        error,
+        internalId,
+        messageId,
+        protocol,
+        reactions,
+        sender,
+        status,
+        text,
+        timeDelivered,
+        timeSent,
+        mutableMapOf(),
+    )
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun attachments(): Optional<List<JsonValue>> = attachments.getOptional("attachments")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contact(): Optional<Contact> = contact.getOptional("contact")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun direction(): Optional<Direction> = direction.getOptional("direction")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun error(): Optional<String> = error.getOptional("error")
+
+    /**
+     * Organization phone number (from-number) used for this message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun internalId(): Optional<String> = internalId.getOptional("internal_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun protocol(): Optional<Protocol> = protocol.getOptional("protocol")
+
+    /**
+     * Reactions on this message (tapbacks and emoji reactions)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
+
+    /**
+     * Sender's phone number or email for inbound group messages. Null for outbound messages and 1-1
+     * chats.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun sender(): Optional<String> = sender.getOptional("sender")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<String> = text.getOptional("text")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun timeDelivered(): Optional<Long> = timeDelivered.getOptional("time_delivered")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun timeSent(): Optional<Long> = timeSent.getOptional("time_sent")
+
+    /**
+     * Returns the raw JSON value of [attachments].
+     *
+     * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("attachments")
+    @ExcludeMissing
+    fun _attachments(): JsonField<List<JsonValue>> = attachments
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [contact].
+     *
+     * Unlike [contact], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("contact") @ExcludeMissing fun _contact(): JsonField<Contact> = contact
+
+    /**
+     * Returns the raw JSON value of [direction].
+     *
+     * Unlike [direction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("direction") @ExcludeMissing fun _direction(): JsonField<Direction> = direction
+
+    /**
+     * Returns the raw JSON value of [error].
+     *
+     * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+    /**
+     * Returns the raw JSON value of [internalId].
+     *
+     * Unlike [internalId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("internal_id") @ExcludeMissing fun _internalId(): JsonField<String> = internalId
+
+    /**
+     * Returns the raw JSON value of [messageId].
+     *
+     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+    /**
+     * Returns the raw JSON value of [protocol].
+     *
+     * Unlike [protocol], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("protocol") @ExcludeMissing fun _protocol(): JsonField<Protocol> = protocol
+
+    /**
+     * Returns the raw JSON value of [reactions].
+     *
+     * Unlike [reactions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reactions")
+    @ExcludeMissing
+    fun _reactions(): JsonField<List<Reaction>> = reactions
+
+    /**
+     * Returns the raw JSON value of [sender].
+     *
+     * Unlike [sender], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sender") @ExcludeMissing fun _sender(): JsonField<String> = sender
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [timeDelivered].
+     *
+     * Unlike [timeDelivered], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("time_delivered")
+    @ExcludeMissing
+    fun _timeDelivered(): JsonField<Long> = timeDelivered
+
+    /**
+     * Returns the raw JSON value of [timeSent].
+     *
+     * Unlike [timeSent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("time_sent") @ExcludeMissing fun _timeSent(): JsonField<Long> = timeSent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MessageRetrieveResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageRetrieveResponse]. */
+    class Builder internal constructor() {
+
+        private var attachments: JsonField<MutableList<JsonValue>>? = null
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var contact: JsonField<Contact> = JsonMissing.of()
+        private var direction: JsonField<Direction> = JsonMissing.of()
+        private var error: JsonField<String> = JsonMissing.of()
+        private var internalId: JsonField<String> = JsonMissing.of()
+        private var messageId: JsonField<String> = JsonMissing.of()
+        private var protocol: JsonField<Protocol> = JsonMissing.of()
+        private var reactions: JsonField<MutableList<Reaction>>? = null
+        private var sender: JsonField<String> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var text: JsonField<String> = JsonMissing.of()
+        private var timeDelivered: JsonField<Long> = JsonMissing.of()
+        private var timeSent: JsonField<Long> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(messageRetrieveResponse: MessageRetrieveResponse) = apply {
+            attachments = messageRetrieveResponse.attachments.map { it.toMutableList() }
+            chatId = messageRetrieveResponse.chatId
+            contact = messageRetrieveResponse.contact
+            direction = messageRetrieveResponse.direction
+            error = messageRetrieveResponse.error
+            internalId = messageRetrieveResponse.internalId
+            messageId = messageRetrieveResponse.messageId
+            protocol = messageRetrieveResponse.protocol
+            reactions = messageRetrieveResponse.reactions.map { it.toMutableList() }
+            sender = messageRetrieveResponse.sender
+            status = messageRetrieveResponse.status
+            text = messageRetrieveResponse.text
+            timeDelivered = messageRetrieveResponse.timeDelivered
+            timeSent = messageRetrieveResponse.timeSent
+            additionalProperties = messageRetrieveResponse.additionalProperties.toMutableMap()
+        }
+
+        fun attachments(attachments: List<JsonValue>) = attachments(JsonField.of(attachments))
+
+        /**
+         * Sets [Builder.attachments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.attachments] with a well-typed `List<JsonValue>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun attachments(attachments: JsonField<List<JsonValue>>) = apply {
+            this.attachments = attachments.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [JsonValue] to [attachments].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAttachment(attachment: JsonValue) = apply {
+            attachments =
+                (attachments ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("attachments", it).add(attachment)
+                }
+        }
+
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
+
+        /** Alias for calling [Builder.contact] with `contact.orElse(null)`. */
+        fun contact(contact: Optional<Contact>) = contact(contact.getOrNull())
+
+        /**
+         * Sets [Builder.contact] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contact] with a well-typed [Contact] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun contact(contact: JsonField<Contact>) = apply { this.contact = contact }
+
+        fun direction(direction: Direction) = direction(JsonField.of(direction))
+
+        /**
+         * Sets [Builder.direction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.direction] with a well-typed [Direction] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun direction(direction: JsonField<Direction>) = apply { this.direction = direction }
+
+        fun error(error: String?) = error(JsonField.ofNullable(error))
+
+        /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+        fun error(error: Optional<String>) = error(error.getOrNull())
+
+        /**
+         * Sets [Builder.error] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.error] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun error(error: JsonField<String>) = apply { this.error = error }
+
+        /** Organization phone number (from-number) used for this message */
+        fun internalId(internalId: String?) = internalId(JsonField.ofNullable(internalId))
+
+        /** Alias for calling [Builder.internalId] with `internalId.orElse(null)`. */
+        fun internalId(internalId: Optional<String>) = internalId(internalId.getOrNull())
+
+        /**
+         * Sets [Builder.internalId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.internalId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun internalId(internalId: JsonField<String>) = apply { this.internalId = internalId }
+
+        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+        /**
+         * Sets [Builder.messageId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+        fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
+
+        /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
+        fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+
+        /**
+         * Sets [Builder.protocol] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.protocol] with a well-typed [Protocol] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun protocol(protocol: JsonField<Protocol>) = apply { this.protocol = protocol }
+
+        /** Reactions on this message (tapbacks and emoji reactions) */
+        fun reactions(reactions: List<Reaction>) = reactions(JsonField.of(reactions))
+
+        /**
+         * Sets [Builder.reactions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reactions] with a well-typed `List<Reaction>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun reactions(reactions: JsonField<List<Reaction>>) = apply {
+            this.reactions = reactions.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Reaction] to [reactions].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addReaction(reaction: Reaction) = apply {
+            reactions =
+                (reactions ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("reactions", it).add(reaction)
+                }
+        }
+
+        /**
+         * Sender's phone number or email for inbound group messages. Null for outbound messages and
+         * 1-1 chats.
+         */
+        fun sender(sender: String?) = sender(JsonField.ofNullable(sender))
+
+        /** Alias for calling [Builder.sender] with `sender.orElse(null)`. */
+        fun sender(sender: Optional<String>) = sender(sender.getOrNull())
+
+        /**
+         * Sets [Builder.sender] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sender] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun sender(sender: JsonField<String>) = apply { this.sender = sender }
+
+        fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+        /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+        fun status(status: Optional<Status>) = status(status.getOrNull())
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun text(text: String?) = text(JsonField.ofNullable(text))
+
+        /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+        fun text(text: Optional<String>) = text(text.getOrNull())
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        fun timeDelivered(timeDelivered: Long?) = timeDelivered(JsonField.ofNullable(timeDelivered))
+
+        /**
+         * Alias for [Builder.timeDelivered].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun timeDelivered(timeDelivered: Long) = timeDelivered(timeDelivered as Long?)
+
+        /** Alias for calling [Builder.timeDelivered] with `timeDelivered.orElse(null)`. */
+        fun timeDelivered(timeDelivered: Optional<Long>) = timeDelivered(timeDelivered.getOrNull())
+
+        /**
+         * Sets [Builder.timeDelivered] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.timeDelivered] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun timeDelivered(timeDelivered: JsonField<Long>) = apply {
+            this.timeDelivered = timeDelivered
+        }
+
+        fun timeSent(timeSent: Long) = timeSent(JsonField.of(timeSent))
+
+        /**
+         * Sets [Builder.timeSent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.timeSent] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun timeSent(timeSent: JsonField<Long>) = apply { this.timeSent = timeSent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageRetrieveResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageRetrieveResponse =
+            MessageRetrieveResponse(
+                (attachments ?: JsonMissing.of()).map { it.toImmutable() },
+                chatId,
+                contact,
+                direction,
+                error,
+                internalId,
+                messageId,
+                protocol,
+                (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                sender,
+                status,
+                text,
+                timeDelivered,
+                timeSent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MessageRetrieveResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        attachments()
+        chatId()
+        contact().ifPresent { it.validate() }
+        direction().ifPresent { it.validate() }
+        error()
+        internalId()
+        messageId()
+        protocol().ifPresent { it.validate() }
+        reactions().ifPresent { it.forEach { it.validate() } }
+        sender()
+        status().ifPresent { it.validate() }
+        text()
+        timeDelivered()
+        timeSent()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (attachments.asKnown().getOrNull()?.size ?: 0) +
+            (if (chatId.asKnown().isPresent) 1 else 0) +
+            (contact.asKnown().getOrNull()?.validity() ?: 0) +
+            (direction.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (error.asKnown().isPresent) 1 else 0) +
+            (if (internalId.asKnown().isPresent) 1 else 0) +
+            (if (messageId.asKnown().isPresent) 1 else 0) +
+            (protocol.asKnown().getOrNull()?.validity() ?: 0) +
+            (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (sender.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            (if (timeDelivered.asKnown().isPresent) 1 else 0) +
+            (if (timeSent.asKnown().isPresent) 1 else 0)
+
+    class Contact
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val contactId: JsonField<String>,
+        private val identifier: JsonField<String>,
+        private val name: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("contact_id")
+            @ExcludeMissing
+            contactId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("identifier")
+            @ExcludeMissing
+            identifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        ) : this(contactId, identifier, name, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+        /**
+         * The contact's phone number or email
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Returns the raw JSON value of [contactId].
+         *
+         * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("contact_id") @ExcludeMissing fun _contactId(): JsonField<String> = contactId
+
+        /**
+         * Returns the raw JSON value of [identifier].
+         *
+         * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("identifier")
+        @ExcludeMissing
+        fun _identifier(): JsonField<String> = identifier
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Contact]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Contact]. */
+        class Builder internal constructor() {
+
+            private var contactId: JsonField<String> = JsonMissing.of()
+            private var identifier: JsonField<String> = JsonMissing.of()
+            private var name: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(contact: Contact) = apply {
+                contactId = contact.contactId
+                identifier = contact.identifier
+                name = contact.name
+                additionalProperties = contact.additionalProperties.toMutableMap()
+            }
+
+            fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+            /**
+             * Sets [Builder.contactId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+            /** The contact's phone number or email */
+            fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+            /**
+             * Sets [Builder.identifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.identifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun identifier(identifier: JsonField<String>) = apply { this.identifier = identifier }
+
+            fun name(name: String?) = name(JsonField.ofNullable(name))
+
+            /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+            fun name(name: Optional<String>) = name(name.getOrNull())
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Contact].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Contact =
+                Contact(contactId, identifier, name, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Contact = apply {
+            if (validated) {
+                return@apply
+            }
+
+            contactId()
+            identifier()
+            name()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (contactId.asKnown().isPresent) 1 else 0) +
+                (if (identifier.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Contact &&
+                contactId == other.contactId &&
+                identifier == other.identifier &&
+                name == other.name &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(contactId, identifier, name, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Contact{contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+    }
+
+    class Direction @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INBOUND = of("inbound")
+
+            @JvmField val OUTBOUND = of("outbound")
+
+            @JvmStatic fun of(value: String) = Direction(JsonField.of(value))
+        }
+
+        /** An enum containing [Direction]'s known values. */
+        enum class Known {
+            INBOUND,
+            OUTBOUND,
+        }
+
+        /**
+         * An enum containing [Direction]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Direction] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INBOUND,
+            OUTBOUND,
+            /**
+             * An enum member indicating that [Direction] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
+                else -> throw BlooioInvalidDataException("Unknown Direction: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Direction = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Direction && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class Protocol @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IMESSAGE = of("imessage")
+
+            @JvmField val SMS = of("sms")
+
+            @JvmField val RCS = of("rcs")
+
+            @JvmField val NON_IMESSAGE = of("non-imessage")
+
+            @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
+        }
+
+        /** An enum containing [Protocol]'s known values. */
+        enum class Known {
+            IMESSAGE,
+            SMS,
+            RCS,
+            NON_IMESSAGE,
+        }
+
+        /**
+         * An enum containing [Protocol]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Protocol] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IMESSAGE,
+            SMS,
+            RCS,
+            NON_IMESSAGE,
+            /** An enum member indicating that [Protocol] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IMESSAGE -> Value.IMESSAGE
+                SMS -> Value.SMS
+                RCS -> Value.RCS
+                NON_IMESSAGE -> Value.NON_IMESSAGE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IMESSAGE -> Known.IMESSAGE
+                SMS -> Known.SMS
+                RCS -> Known.RCS
+                NON_IMESSAGE -> Known.NON_IMESSAGE
+                else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Protocol = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Protocol && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val PENDING = of("pending")
+
+            @JvmField val QUEUED = of("queued")
+
+            @JvmField val SENT = of("sent")
+
+            @JvmField val DELIVERED = of("delivered")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmField val CANCELLATION_REQUESTED = of("cancellation_requested")
+
+            @JvmField val CANCELLED = of("cancelled")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            PENDING,
+            QUEUED,
+            SENT,
+            DELIVERED,
+            FAILED,
+            CANCELLATION_REQUESTED,
+            CANCELLED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            PENDING,
+            QUEUED,
+            SENT,
+            DELIVERED,
+            FAILED,
+            CANCELLATION_REQUESTED,
+            CANCELLED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                PENDING -> Value.PENDING
+                QUEUED -> Value.QUEUED
+                SENT -> Value.SENT
+                DELIVERED -> Value.DELIVERED
+                FAILED -> Value.FAILED
+                CANCELLATION_REQUESTED -> Value.CANCELLATION_REQUESTED
+                CANCELLED -> Value.CANCELLED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                PENDING -> Known.PENDING
+                QUEUED -> Known.QUEUED
+                SENT -> Known.SENT
+                DELIVERED -> Known.DELIVERED
+                FAILED -> Known.FAILED
+                CANCELLATION_REQUESTED -> Known.CANCELLATION_REQUESTED
+                CANCELLED -> Known.CANCELLED
+                else -> throw BlooioInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageRetrieveResponse &&
+            attachments == other.attachments &&
+            chatId == other.chatId &&
+            contact == other.contact &&
+            direction == other.direction &&
+            error == other.error &&
+            internalId == other.internalId &&
+            messageId == other.messageId &&
+            protocol == other.protocol &&
+            reactions == other.reactions &&
+            sender == other.sender &&
+            status == other.status &&
+            text == other.text &&
+            timeDelivered == other.timeDelivered &&
+            timeSent == other.timeSent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            attachments,
+            chatId,
+            contact,
+            direction,
+            error,
+            internalId,
+            messageId,
+            protocol,
+            reactions,
+            sender,
+            status,
+            text,
+            timeDelivered,
+            timeSent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
new file mode 100644
index 0000000..c9c5b51
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -0,0 +1,1895 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.BaseDeserializer
+import com.blooio.api.core.BaseSerializer
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.allMaxBy
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.getOrThrow
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Send a message to a chat. The chatId can be: (1) E.164 phone number, (2) email address, (3) group
+ * ID (grp_xxxx), or (4) comma-separated list of phone/email for multi-recipient chats. For
+ * multi-recipient, an unnamed group is automatically created or reused if the exact participant
+ * combination already exists. For explicit groups, the group must be linked to an existing iMessage
+ * chat.
+ */
+class MessageSendParams
+private constructor(
+    private val chatId: String?,
+    private val idempotencyKey: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    fun idempotencyKey(): Optional<String> = Optional.ofNullable(idempotencyKey)
+
+    /**
+     * Array of attachment URLs or objects with url/name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun attachments(): Optional<List<Attachment>> = body.attachments()
+
+    /**
+     * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
+     * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this selects a
+     * specific number from your pool. Must be a number assigned to your API key.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fromNumber(): Optional<String> = body.fromNumber()
+
+    /**
+     * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are optional.
+     * Only applies when the message text (or the concatenated part text) is exactly a single
+     * http(s) URL. If omitted but the text is a URL, Blooio auto-fetches the page's Open Graph
+     * metadata to generate a preview. If the image download fails, the send still succeeds — Blooio
+     * silently falls back to the auto-generated preview.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun linkPreview(): Optional<LinkPreview> = body.linkPreview()
+
+    /**
+     * Ordered array of message parts. Two modes:
+     * 1. **Multipart mode** — parts sent as a single unified iMessage bubble (mix of text and
+     *    attachment parts). This is the default.
+     * 2. **URL-balloon batch mode** — triggered when any part has a `link_preview` object. Each
+     *    part becomes its own rich-link-preview iMessage; parts are sent sequentially in array
+     *    order. In batch mode every part must be text-only with `text` being a single http(s) URL.
+     *    Response contains `message_ids[]` + `count` instead of `message_id`.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parts(): Optional<List<Part>> = body.parts()
+
+    /**
+     * If true, the contact card (Name & Photo) will be shared with this message. The contact card
+     * is piggybacked onto the outgoing message. Defaults to false.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun shareContact(): Optional<Boolean> = body.shareContact()
+
+    /**
+     * Message text. Can be a single string or array of strings (each becomes a separate message)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<Text> = body.text()
+
+    /**
+     * Whether to show typing indicator before sending. Defaults to org preference.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun useTypingIndicator(): Optional<Boolean> = body.useTypingIndicator()
+
+    /**
+     * Returns the raw JSON value of [attachments].
+     *
+     * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _attachments(): JsonField<List<Attachment>> = body._attachments()
+
+    /**
+     * Returns the raw JSON value of [fromNumber].
+     *
+     * Unlike [fromNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _fromNumber(): JsonField<String> = body._fromNumber()
+
+    /**
+     * Returns the raw JSON value of [linkPreview].
+     *
+     * Unlike [linkPreview], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _linkPreview(): JsonField<LinkPreview> = body._linkPreview()
+
+    /**
+     * Returns the raw JSON value of [parts].
+     *
+     * Unlike [parts], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _parts(): JsonField<List<Part>> = body._parts()
+
+    /**
+     * Returns the raw JSON value of [shareContact].
+     *
+     * Unlike [shareContact], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _shareContact(): JsonField<Boolean> = body._shareContact()
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _text(): JsonField<Text> = body._text()
+
+    /**
+     * Returns the raw JSON value of [useTypingIndicator].
+     *
+     * Unlike [useTypingIndicator], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _useTypingIndicator(): JsonField<Boolean> = body._useTypingIndicator()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): MessageSendParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [MessageSendParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageSendParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var idempotencyKey: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(messageSendParams: MessageSendParams) = apply {
+            chatId = messageSendParams.chatId
+            idempotencyKey = messageSendParams.idempotencyKey
+            body = messageSendParams.body.toBuilder()
+            additionalHeaders = messageSendParams.additionalHeaders.toBuilder()
+            additionalQueryParams = messageSendParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun idempotencyKey(idempotencyKey: String?) = apply { this.idempotencyKey = idempotencyKey }
+
+        /** Alias for calling [Builder.idempotencyKey] with `idempotencyKey.orElse(null)`. */
+        fun idempotencyKey(idempotencyKey: Optional<String>) =
+            idempotencyKey(idempotencyKey.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [attachments]
+         * - [fromNumber]
+         * - [linkPreview]
+         * - [parts]
+         * - [shareContact]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Array of attachment URLs or objects with url/name */
+        fun attachments(attachments: List<Attachment>) = apply { body.attachments(attachments) }
+
+        /**
+         * Sets [Builder.attachments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.attachments] with a well-typed `List<Attachment>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun attachments(attachments: JsonField<List<Attachment>>) = apply {
+            body.attachments(attachments)
+        }
+
+        /**
+         * Adds a single [Attachment] to [attachments].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAttachment(attachment: Attachment) = apply { body.addAttachment(attachment) }
+
+        /** Alias for calling [addAttachment] with `Attachment.ofString(string)`. */
+        fun addAttachment(string: String) = apply { body.addAttachment(string) }
+
+        /** Alias for calling [addAttachment] with `Attachment.ofUnionMember1(unionMember1)`. */
+        fun addAttachment(unionMember1: Attachment.UnionMember1) = apply {
+            body.addAttachment(unionMember1)
+        }
+
+        /**
+         * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
+         * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this
+         * selects a specific number from your pool. Must be a number assigned to your API key.
+         */
+        fun fromNumber(fromNumber: String) = apply { body.fromNumber(fromNumber) }
+
+        /**
+         * Sets [Builder.fromNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fromNumber] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun fromNumber(fromNumber: JsonField<String>) = apply { body.fromNumber(fromNumber) }
+
+        /**
+         * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are
+         * optional. Only applies when the message text (or the concatenated part text) is exactly a
+         * single http(s) URL. If omitted but the text is a URL, Blooio auto-fetches the page's Open
+         * Graph metadata to generate a preview. If the image download fails, the send still
+         * succeeds — Blooio silently falls back to the auto-generated preview.
+         */
+        fun linkPreview(linkPreview: LinkPreview?) = apply { body.linkPreview(linkPreview) }
+
+        /** Alias for calling [Builder.linkPreview] with `linkPreview.orElse(null)`. */
+        fun linkPreview(linkPreview: Optional<LinkPreview>) = linkPreview(linkPreview.getOrNull())
+
+        /**
+         * Sets [Builder.linkPreview] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.linkPreview] with a well-typed [LinkPreview] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun linkPreview(linkPreview: JsonField<LinkPreview>) = apply {
+            body.linkPreview(linkPreview)
+        }
+
+        /**
+         * Ordered array of message parts. Two modes:
+         * 1. **Multipart mode** — parts sent as a single unified iMessage bubble (mix of text and
+         *    attachment parts). This is the default.
+         * 2. **URL-balloon batch mode** — triggered when any part has a `link_preview` object. Each
+         *    part becomes its own rich-link-preview iMessage; parts are sent sequentially in array
+         *    order. In batch mode every part must be text-only with `text` being a single http(s)
+         *    URL. Response contains `message_ids[]` + `count` instead of `message_id`.
+         */
+        fun parts(parts: List<Part>) = apply { body.parts(parts) }
+
+        /**
+         * Sets [Builder.parts] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parts] with a well-typed `List<Part>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun parts(parts: JsonField<List<Part>>) = apply { body.parts(parts) }
+
+        /**
+         * Adds a single [Part] to [parts].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addPart(part: Part) = apply { body.addPart(part) }
+
+        /**
+         * If true, the contact card (Name & Photo) will be shared with this message. The contact
+         * card is piggybacked onto the outgoing message. Defaults to false.
+         */
+        fun shareContact(shareContact: Boolean) = apply { body.shareContact(shareContact) }
+
+        /**
+         * Sets [Builder.shareContact] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.shareContact] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun shareContact(shareContact: JsonField<Boolean>) = apply {
+            body.shareContact(shareContact)
+        }
+
+        /**
+         * Message text. Can be a single string or array of strings (each becomes a separate
+         * message)
+         */
+        fun text(text: Text) = apply { body.text(text) }
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [Text] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<Text>) = apply { body.text(text) }
+
+        /** Alias for calling [text] with `Text.ofString(string)`. */
+        fun text(string: String) = apply { body.text(string) }
+
+        /** Alias for calling [text] with `Text.ofStrings(strings)`. */
+        fun textOfStrings(strings: List<String>) = apply { body.textOfStrings(strings) }
+
+        /** Whether to show typing indicator before sending. Defaults to org preference. */
+        fun useTypingIndicator(useTypingIndicator: Boolean) = apply {
+            body.useTypingIndicator(useTypingIndicator)
+        }
+
+        /**
+         * Sets [Builder.useTypingIndicator] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.useTypingIndicator] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun useTypingIndicator(useTypingIndicator: JsonField<Boolean>) = apply {
+            body.useTypingIndicator(useTypingIndicator)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageSendParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageSendParams =
+            MessageSendParams(
+                chatId,
+                idempotencyKey,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                idempotencyKey?.let { put("Idempotency-Key", it) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    /** Request body for sending a message */
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val attachments: JsonField<List<Attachment>>,
+        private val fromNumber: JsonField<String>,
+        private val linkPreview: JsonField<LinkPreview>,
+        private val parts: JsonField<List<Part>>,
+        private val shareContact: JsonField<Boolean>,
+        private val text: JsonField<Text>,
+        private val useTypingIndicator: JsonField<Boolean>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("attachments")
+            @ExcludeMissing
+            attachments: JsonField<List<Attachment>> = JsonMissing.of(),
+            @JsonProperty("from_number")
+            @ExcludeMissing
+            fromNumber: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("link_preview")
+            @ExcludeMissing
+            linkPreview: JsonField<LinkPreview> = JsonMissing.of(),
+            @JsonProperty("parts") @ExcludeMissing parts: JsonField<List<Part>> = JsonMissing.of(),
+            @JsonProperty("share_contact")
+            @ExcludeMissing
+            shareContact: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("text") @ExcludeMissing text: JsonField<Text> = JsonMissing.of(),
+            @JsonProperty("use_typing_indicator")
+            @ExcludeMissing
+            useTypingIndicator: JsonField<Boolean> = JsonMissing.of(),
+        ) : this(
+            attachments,
+            fromNumber,
+            linkPreview,
+            parts,
+            shareContact,
+            text,
+            useTypingIndicator,
+            mutableMapOf(),
+        )
+
+        /**
+         * Array of attachment URLs or objects with url/name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun attachments(): Optional<List<Attachment>> = attachments.getOptional("attachments")
+
+        /**
+         * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
+         * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this
+         * selects a specific number from your pool. Must be a number assigned to your API key.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun fromNumber(): Optional<String> = fromNumber.getOptional("from_number")
+
+        /**
+         * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are
+         * optional. Only applies when the message text (or the concatenated part text) is exactly a
+         * single http(s) URL. If omitted but the text is a URL, Blooio auto-fetches the page's Open
+         * Graph metadata to generate a preview. If the image download fails, the send still
+         * succeeds — Blooio silently falls back to the auto-generated preview.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun linkPreview(): Optional<LinkPreview> = linkPreview.getOptional("link_preview")
+
+        /**
+         * Ordered array of message parts. Two modes:
+         * 1. **Multipart mode** — parts sent as a single unified iMessage bubble (mix of text and
+         *    attachment parts). This is the default.
+         * 2. **URL-balloon batch mode** — triggered when any part has a `link_preview` object. Each
+         *    part becomes its own rich-link-preview iMessage; parts are sent sequentially in array
+         *    order. In batch mode every part must be text-only with `text` being a single http(s)
+         *    URL. Response contains `message_ids[]` + `count` instead of `message_id`.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun parts(): Optional<List<Part>> = parts.getOptional("parts")
+
+        /**
+         * If true, the contact card (Name & Photo) will be shared with this message. The contact
+         * card is piggybacked onto the outgoing message. Defaults to false.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun shareContact(): Optional<Boolean> = shareContact.getOptional("share_contact")
+
+        /**
+         * Message text. Can be a single string or array of strings (each becomes a separate
+         * message)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<Text> = text.getOptional("text")
+
+        /**
+         * Whether to show typing indicator before sending. Defaults to org preference.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun useTypingIndicator(): Optional<Boolean> =
+            useTypingIndicator.getOptional("use_typing_indicator")
+
+        /**
+         * Returns the raw JSON value of [attachments].
+         *
+         * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("attachments")
+        @ExcludeMissing
+        fun _attachments(): JsonField<List<Attachment>> = attachments
+
+        /**
+         * Returns the raw JSON value of [fromNumber].
+         *
+         * Unlike [fromNumber], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("from_number")
+        @ExcludeMissing
+        fun _fromNumber(): JsonField<String> = fromNumber
+
+        /**
+         * Returns the raw JSON value of [linkPreview].
+         *
+         * Unlike [linkPreview], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("link_preview")
+        @ExcludeMissing
+        fun _linkPreview(): JsonField<LinkPreview> = linkPreview
+
+        /**
+         * Returns the raw JSON value of [parts].
+         *
+         * Unlike [parts], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("parts") @ExcludeMissing fun _parts(): JsonField<List<Part>> = parts
+
+        /**
+         * Returns the raw JSON value of [shareContact].
+         *
+         * Unlike [shareContact], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("share_contact")
+        @ExcludeMissing
+        fun _shareContact(): JsonField<Boolean> = shareContact
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<Text> = text
+
+        /**
+         * Returns the raw JSON value of [useTypingIndicator].
+         *
+         * Unlike [useTypingIndicator], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("use_typing_indicator")
+        @ExcludeMissing
+        fun _useTypingIndicator(): JsonField<Boolean> = useTypingIndicator
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var attachments: JsonField<MutableList<Attachment>>? = null
+            private var fromNumber: JsonField<String> = JsonMissing.of()
+            private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
+            private var parts: JsonField<MutableList<Part>>? = null
+            private var shareContact: JsonField<Boolean> = JsonMissing.of()
+            private var text: JsonField<Text> = JsonMissing.of()
+            private var useTypingIndicator: JsonField<Boolean> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                attachments = body.attachments.map { it.toMutableList() }
+                fromNumber = body.fromNumber
+                linkPreview = body.linkPreview
+                parts = body.parts.map { it.toMutableList() }
+                shareContact = body.shareContact
+                text = body.text
+                useTypingIndicator = body.useTypingIndicator
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Array of attachment URLs or objects with url/name */
+            fun attachments(attachments: List<Attachment>) = attachments(JsonField.of(attachments))
+
+            /**
+             * Sets [Builder.attachments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.attachments] with a well-typed `List<Attachment>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun attachments(attachments: JsonField<List<Attachment>>) = apply {
+                this.attachments = attachments.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Attachment] to [attachments].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAttachment(attachment: Attachment) = apply {
+                attachments =
+                    (attachments ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("attachments", it).add(attachment)
+                    }
+            }
+
+            /** Alias for calling [addAttachment] with `Attachment.ofString(string)`. */
+            fun addAttachment(string: String) = addAttachment(Attachment.ofString(string))
+
+            /** Alias for calling [addAttachment] with `Attachment.ofUnionMember1(unionMember1)`. */
+            fun addAttachment(unionMember1: Attachment.UnionMember1) =
+                addAttachment(Attachment.ofUnionMember1(unionMember1))
+
+            /**
+             * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted,
+             * the first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys,
+             * this selects a specific number from your pool. Must be a number assigned to your API
+             * key.
+             */
+            fun fromNumber(fromNumber: String) = fromNumber(JsonField.of(fromNumber))
+
+            /**
+             * Sets [Builder.fromNumber] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fromNumber] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fromNumber(fromNumber: JsonField<String>) = apply { this.fromNumber = fromNumber }
+
+            /**
+             * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are
+             * optional. Only applies when the message text (or the concatenated part text) is
+             * exactly a single http(s) URL. If omitted but the text is a URL, Blooio auto-fetches
+             * the page's Open Graph metadata to generate a preview. If the image download fails,
+             * the send still succeeds — Blooio silently falls back to the auto-generated preview.
+             */
+            fun linkPreview(linkPreview: LinkPreview?) =
+                linkPreview(JsonField.ofNullable(linkPreview))
+
+            /** Alias for calling [Builder.linkPreview] with `linkPreview.orElse(null)`. */
+            fun linkPreview(linkPreview: Optional<LinkPreview>) =
+                linkPreview(linkPreview.getOrNull())
+
+            /**
+             * Sets [Builder.linkPreview] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.linkPreview] with a well-typed [LinkPreview] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun linkPreview(linkPreview: JsonField<LinkPreview>) = apply {
+                this.linkPreview = linkPreview
+            }
+
+            /**
+             * Ordered array of message parts. Two modes:
+             * 1. **Multipart mode** — parts sent as a single unified iMessage bubble (mix of text
+             *    and attachment parts). This is the default.
+             * 2. **URL-balloon batch mode** — triggered when any part has a `link_preview` object.
+             *    Each part becomes its own rich-link-preview iMessage; parts are sent sequentially
+             *    in array order. In batch mode every part must be text-only with `text` being a
+             *    single http(s) URL. Response contains `message_ids[]` + `count` instead of
+             *    `message_id`.
+             */
+            fun parts(parts: List<Part>) = parts(JsonField.of(parts))
+
+            /**
+             * Sets [Builder.parts] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parts] with a well-typed `List<Part>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parts(parts: JsonField<List<Part>>) = apply {
+                this.parts = parts.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Part] to [parts].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addPart(part: Part) = apply {
+                parts =
+                    (parts ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("parts", it).add(part)
+                    }
+            }
+
+            /**
+             * If true, the contact card (Name & Photo) will be shared with this message. The
+             * contact card is piggybacked onto the outgoing message. Defaults to false.
+             */
+            fun shareContact(shareContact: Boolean) = shareContact(JsonField.of(shareContact))
+
+            /**
+             * Sets [Builder.shareContact] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.shareContact] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun shareContact(shareContact: JsonField<Boolean>) = apply {
+                this.shareContact = shareContact
+            }
+
+            /**
+             * Message text. Can be a single string or array of strings (each becomes a separate
+             * message)
+             */
+            fun text(text: Text) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [Text] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<Text>) = apply { this.text = text }
+
+            /** Alias for calling [text] with `Text.ofString(string)`. */
+            fun text(string: String) = text(Text.ofString(string))
+
+            /** Alias for calling [text] with `Text.ofStrings(strings)`. */
+            fun textOfStrings(strings: List<String>) = text(Text.ofStrings(strings))
+
+            /** Whether to show typing indicator before sending. Defaults to org preference. */
+            fun useTypingIndicator(useTypingIndicator: Boolean) =
+                useTypingIndicator(JsonField.of(useTypingIndicator))
+
+            /**
+             * Sets [Builder.useTypingIndicator] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.useTypingIndicator] with a well-typed [Boolean]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun useTypingIndicator(useTypingIndicator: JsonField<Boolean>) = apply {
+                this.useTypingIndicator = useTypingIndicator
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body =
+                Body(
+                    (attachments ?: JsonMissing.of()).map { it.toImmutable() },
+                    fromNumber,
+                    linkPreview,
+                    (parts ?: JsonMissing.of()).map { it.toImmutable() },
+                    shareContact,
+                    text,
+                    useTypingIndicator,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            attachments().ifPresent { it.forEach { it.validate() } }
+            fromNumber()
+            linkPreview().ifPresent { it.validate() }
+            parts().ifPresent { it.forEach { it.validate() } }
+            shareContact()
+            text().ifPresent { it.validate() }
+            useTypingIndicator()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (attachments.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (fromNumber.asKnown().isPresent) 1 else 0) +
+                (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
+                (parts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (shareContact.asKnown().isPresent) 1 else 0) +
+                (text.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (useTypingIndicator.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                attachments == other.attachments &&
+                fromNumber == other.fromNumber &&
+                linkPreview == other.linkPreview &&
+                parts == other.parts &&
+                shareContact == other.shareContact &&
+                text == other.text &&
+                useTypingIndicator == other.useTypingIndicator &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                attachments,
+                fromNumber,
+                linkPreview,
+                parts,
+                shareContact,
+                text,
+                useTypingIndicator,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{attachments=$attachments, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
+    }
+
+    /** URL to the attachment */
+    @JsonDeserialize(using = Attachment.Deserializer::class)
+    @JsonSerialize(using = Attachment.Serializer::class)
+    class Attachment
+    private constructor(
+        private val string: String? = null,
+        private val unionMember1: UnionMember1? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** URL to the attachment */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        fun unionMember1(): Optional<UnionMember1> = Optional.ofNullable(unionMember1)
+
+        fun isString(): Boolean = string != null
+
+        fun isUnionMember1(): Boolean = unionMember1 != null
+
+        /** URL to the attachment */
+        fun asString(): String = string.getOrThrow("string")
+
+        fun asUnionMember1(): UnionMember1 = unionMember1.getOrThrow("unionMember1")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                unionMember1 != null -> visitor.visitUnionMember1(unionMember1)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        fun validate(): Attachment = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitUnionMember1(unionMember1: UnionMember1) {
+                        unionMember1.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitUnionMember1(unionMember1: UnionMember1) =
+                        unionMember1.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Attachment &&
+                string == other.string &&
+                unionMember1 == other.unionMember1
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, unionMember1)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Attachment{string=$string}"
+                unionMember1 != null -> "Attachment{unionMember1=$unionMember1}"
+                _json != null -> "Attachment{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Attachment")
+            }
+
+        companion object {
+
+            /** URL to the attachment */
+            @JvmStatic fun ofString(string: String) = Attachment(string = string)
+
+            @JvmStatic
+            fun ofUnionMember1(unionMember1: UnionMember1) = Attachment(unionMember1 = unionMember1)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Attachment] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** URL to the attachment */
+            fun visitString(string: String): T
+
+            fun visitUnionMember1(unionMember1: UnionMember1): T
+
+            /**
+             * Maps an unknown variant of [Attachment] to a value of type [T].
+             *
+             * An instance of [Attachment] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws BlooioInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw BlooioInvalidDataException("Unknown Attachment: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Attachment>(Attachment::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Attachment {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<UnionMember1>())?.let {
+                                Attachment(unionMember1 = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Attachment(string = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Attachment(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Attachment>(Attachment::class) {
+
+            override fun serialize(
+                value: Attachment,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.unionMember1 != null -> generator.writeObject(value.unionMember1)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Attachment")
+                }
+            }
+        }
+
+        class UnionMember1
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val url: JsonField<String>,
+            private val name: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            ) : this(url, name, mutableMapOf())
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun url(): String = url.getRequired("url")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun name(): Optional<String> = name.getOptional("name")
+
+            /**
+             * Returns the raw JSON value of [url].
+             *
+             * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [UnionMember1].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .url()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [UnionMember1]. */
+            class Builder internal constructor() {
+
+                private var url: JsonField<String>? = null
+                private var name: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(unionMember1: UnionMember1) = apply {
+                    url = unionMember1.url
+                    name = unionMember1.name
+                    additionalProperties = unionMember1.additionalProperties.toMutableMap()
+                }
+
+                fun url(url: String) = url(JsonField.of(url))
+
+                /**
+                 * Sets [Builder.url] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.url] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun url(url: JsonField<String>) = apply { this.url = url }
+
+                fun name(name: String) = name(JsonField.of(name))
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [UnionMember1].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .url()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): UnionMember1 =
+                    UnionMember1(
+                        checkRequired("url", url),
+                        name,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            fun validate(): UnionMember1 = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                url()
+                name()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (url.asKnown().isPresent) 1 else 0) + (if (name.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is UnionMember1 &&
+                    url == other.url &&
+                    name == other.name &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(url, name, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "UnionMember1{url=$url, name=$name, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    class Part
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val linkPreview: JsonField<LinkPreview>,
+        private val mention: JsonField<String>,
+        private val name: JsonField<String>,
+        private val text: JsonField<String>,
+        private val url: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("link_preview")
+            @ExcludeMissing
+            linkPreview: JsonField<LinkPreview> = JsonMissing.of(),
+            @JsonProperty("mention") @ExcludeMissing mention: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+        ) : this(linkPreview, mention, name, text, url, mutableMapOf())
+
+        /**
+         * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are
+         * optional. Only applies when the message text (or the concatenated part text) is exactly a
+         * single http(s) URL. If omitted but the text is a URL, Blooio auto-fetches the page's Open
+         * Graph metadata to generate a preview. If the image download fails, the send still
+         * succeeds — Blooio silently falls back to the auto-generated preview.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun linkPreview(): Optional<LinkPreview> = linkPreview.getOptional("link_preview")
+
+        /**
+         * Participant phone number or email to @-mention. Only valid with 'text'. The entire text
+         * of the part is rendered as the mention.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mention(): Optional<String> = mention.getOptional("mention")
+
+        /**
+         * Filename for the attachment. Only valid with 'url'.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Text content for this part. Mutually exclusive with 'url'.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<String> = text.getOptional("text")
+
+        /**
+         * URL to an attachment for this part. Mutually exclusive with 'text'.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun url(): Optional<String> = url.getOptional("url")
+
+        /**
+         * Returns the raw JSON value of [linkPreview].
+         *
+         * Unlike [linkPreview], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("link_preview")
+        @ExcludeMissing
+        fun _linkPreview(): JsonField<LinkPreview> = linkPreview
+
+        /**
+         * Returns the raw JSON value of [mention].
+         *
+         * Unlike [mention], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mention") @ExcludeMissing fun _mention(): JsonField<String> = mention
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        /**
+         * Returns the raw JSON value of [url].
+         *
+         * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Part]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Part]. */
+        class Builder internal constructor() {
+
+            private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
+            private var mention: JsonField<String> = JsonMissing.of()
+            private var name: JsonField<String> = JsonMissing.of()
+            private var text: JsonField<String> = JsonMissing.of()
+            private var url: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(part: Part) = apply {
+                linkPreview = part.linkPreview
+                mention = part.mention
+                name = part.name
+                text = part.text
+                url = part.url
+                additionalProperties = part.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Rich-link-preview overrides for URL messages (iMessage URL balloon). All fields are
+             * optional. Only applies when the message text (or the concatenated part text) is
+             * exactly a single http(s) URL. If omitted but the text is a URL, Blooio auto-fetches
+             * the page's Open Graph metadata to generate a preview. If the image download fails,
+             * the send still succeeds — Blooio silently falls back to the auto-generated preview.
+             */
+            fun linkPreview(linkPreview: LinkPreview?) =
+                linkPreview(JsonField.ofNullable(linkPreview))
+
+            /** Alias for calling [Builder.linkPreview] with `linkPreview.orElse(null)`. */
+            fun linkPreview(linkPreview: Optional<LinkPreview>) =
+                linkPreview(linkPreview.getOrNull())
+
+            /**
+             * Sets [Builder.linkPreview] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.linkPreview] with a well-typed [LinkPreview] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun linkPreview(linkPreview: JsonField<LinkPreview>) = apply {
+                this.linkPreview = linkPreview
+            }
+
+            /**
+             * Participant phone number or email to @-mention. Only valid with 'text'. The entire
+             * text of the part is rendered as the mention.
+             */
+            fun mention(mention: String) = mention(JsonField.of(mention))
+
+            /**
+             * Sets [Builder.mention] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mention] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mention(mention: JsonField<String>) = apply { this.mention = mention }
+
+            /** Filename for the attachment. Only valid with 'url'. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** Text content for this part. Mutually exclusive with 'url'. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /** URL to an attachment for this part. Mutually exclusive with 'text'. */
+            fun url(url: String) = url(JsonField.of(url))
+
+            /**
+             * Sets [Builder.url] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.url] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun url(url: JsonField<String>) = apply { this.url = url }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Part].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Part =
+                Part(linkPreview, mention, name, text, url, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Part = apply {
+            if (validated) {
+                return@apply
+            }
+
+            linkPreview().ifPresent { it.validate() }
+            mention()
+            name()
+            text()
+            url()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (mention.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (text.asKnown().isPresent) 1 else 0) +
+                (if (url.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Part &&
+                linkPreview == other.linkPreview &&
+                mention == other.mention &&
+                name == other.name &&
+                text == other.text &&
+                url == other.url &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(linkPreview, mention, name, text, url, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Part{linkPreview=$linkPreview, mention=$mention, name=$name, text=$text, url=$url, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Message text. Can be a single string or array of strings (each becomes a separate message)
+     */
+    @JsonDeserialize(using = Text.Deserializer::class)
+    @JsonSerialize(using = Text.Serializer::class)
+    class Text
+    private constructor(
+        private val string: String? = null,
+        private val strings: List<String>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        fun strings(): Optional<List<String>> = Optional.ofNullable(strings)
+
+        fun isString(): Boolean = string != null
+
+        fun isStrings(): Boolean = strings != null
+
+        fun asString(): String = string.getOrThrow("string")
+
+        fun asStrings(): List<String> = strings.getOrThrow("strings")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                strings != null -> visitor.visitStrings(strings)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        fun validate(): Text = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitStrings(strings: List<String>) {}
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitStrings(strings: List<String>) = strings.size
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Text && string == other.string && strings == other.strings
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, strings)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Text{string=$string}"
+                strings != null -> "Text{strings=$strings}"
+                _json != null -> "Text{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Text")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofString(string: String) = Text(string = string)
+
+            @JvmStatic fun ofStrings(strings: List<String>) = Text(strings = strings.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Text] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitString(string: String): T
+
+            fun visitStrings(strings: List<String>): T
+
+            /**
+             * Maps an unknown variant of [Text] to a value of type [T].
+             *
+             * An instance of [Text] can contain an unknown variant if it was deserialized from data
+             * that doesn't match any known variant. For example, if the SDK is on an older version
+             * than the API, then the API may respond with new variants that the SDK is unaware of.
+             *
+             * @throws BlooioInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw BlooioInvalidDataException("Unknown Text: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Text>(Text::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Text {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Text(string = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<String>>())?.let {
+                                Text(strings = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Text(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Text>(Text::class) {
+
+            override fun serialize(
+                value: Text,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.strings != null -> generator.writeObject(value.strings)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Text")
+                }
+            }
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageSendParams &&
+            chatId == other.chatId &&
+            idempotencyKey == other.idempotencyKey &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, idempotencyKey, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "MessageSendParams{chatId=$chatId, idempotencyKey=$idempotencyKey, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
new file mode 100644
index 0000000..ad427b2
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -0,0 +1,566 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Response after sending a message */
+class MessageSendResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val count: JsonField<Long>,
+    private val groupCreated: JsonField<Boolean>,
+    private val groupId: JsonField<String>,
+    private val messageId: JsonField<String>,
+    private val messageIds: JsonField<List<String>>,
+    private val participants: JsonField<List<String>>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("count") @ExcludeMissing count: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("group_created")
+        @ExcludeMissing
+        groupCreated: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message_ids")
+        @ExcludeMissing
+        messageIds: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("participants")
+        @ExcludeMissing
+        participants: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(
+        count,
+        groupCreated,
+        groupId,
+        messageId,
+        messageIds,
+        participants,
+        status,
+        mutableMapOf(),
+    )
+
+    /**
+     * Number of messages sent. Only present in URL-balloon batch mode.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun count(): Optional<Long> = count.getOptional("count")
+
+    /**
+     * True if a new unnamed group was created for this multi-recipient message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupCreated(): Optional<Boolean> = groupCreated.getOptional("group_created")
+
+    /**
+     * Group ID when sending to multi-recipient (new or existing)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * ID of the sent message (single-message sends)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+    /**
+     * IDs of sent messages. Present when `text` is an array or when `parts` uses per-part
+     * `link_preview` (URL-balloon batch mode).
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageIds(): Optional<List<String>> = messageIds.getOptional("message_ids")
+
+    /**
+     * List of participants (present for multi-recipient)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun participants(): Optional<List<String>> = participants.getOptional("participants")
+
+    /**
+     * Initial status of the message(s)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [count].
+     *
+     * Unlike [count], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("count") @ExcludeMissing fun _count(): JsonField<Long> = count
+
+    /**
+     * Returns the raw JSON value of [groupCreated].
+     *
+     * Unlike [groupCreated], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_created")
+    @ExcludeMissing
+    fun _groupCreated(): JsonField<Boolean> = groupCreated
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [messageId].
+     *
+     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+    /**
+     * Returns the raw JSON value of [messageIds].
+     *
+     * Unlike [messageIds], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_ids")
+    @ExcludeMissing
+    fun _messageIds(): JsonField<List<String>> = messageIds
+
+    /**
+     * Returns the raw JSON value of [participants].
+     *
+     * Unlike [participants], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("participants")
+    @ExcludeMissing
+    fun _participants(): JsonField<List<String>> = participants
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MessageSendResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MessageSendResponse]. */
+    class Builder internal constructor() {
+
+        private var count: JsonField<Long> = JsonMissing.of()
+        private var groupCreated: JsonField<Boolean> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var messageId: JsonField<String> = JsonMissing.of()
+        private var messageIds: JsonField<MutableList<String>>? = null
+        private var participants: JsonField<MutableList<String>>? = null
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(messageSendResponse: MessageSendResponse) = apply {
+            count = messageSendResponse.count
+            groupCreated = messageSendResponse.groupCreated
+            groupId = messageSendResponse.groupId
+            messageId = messageSendResponse.messageId
+            messageIds = messageSendResponse.messageIds.map { it.toMutableList() }
+            participants = messageSendResponse.participants.map { it.toMutableList() }
+            status = messageSendResponse.status
+            additionalProperties = messageSendResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Number of messages sent. Only present in URL-balloon batch mode. */
+        fun count(count: Long) = count(JsonField.of(count))
+
+        /**
+         * Sets [Builder.count] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.count] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun count(count: JsonField<Long>) = apply { this.count = count }
+
+        /** True if a new unnamed group was created for this multi-recipient message */
+        fun groupCreated(groupCreated: Boolean) = groupCreated(JsonField.of(groupCreated))
+
+        /**
+         * Sets [Builder.groupCreated] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupCreated] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun groupCreated(groupCreated: JsonField<Boolean>) = apply {
+            this.groupCreated = groupCreated
+        }
+
+        /** Group ID when sending to multi-recipient (new or existing) */
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** ID of the sent message (single-message sends) */
+        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+        /**
+         * Sets [Builder.messageId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+        /**
+         * IDs of sent messages. Present when `text` is an array or when `parts` uses per-part
+         * `link_preview` (URL-balloon batch mode).
+         */
+        fun messageIds(messageIds: List<String>) = messageIds(JsonField.of(messageIds))
+
+        /**
+         * Sets [Builder.messageIds] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageIds] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun messageIds(messageIds: JsonField<List<String>>) = apply {
+            this.messageIds = messageIds.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [messageIds].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addMessageId(messageId: String) = apply {
+            messageIds =
+                (messageIds ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("messageIds", it).add(messageId)
+                }
+        }
+
+        /** List of participants (present for multi-recipient) */
+        fun participants(participants: List<String>) = participants(JsonField.of(participants))
+
+        /**
+         * Sets [Builder.participants] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.participants] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun participants(participants: JsonField<List<String>>) = apply {
+            this.participants = participants.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [participants].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addParticipant(participant: String) = apply {
+            participants =
+                (participants ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("participants", it).add(participant)
+                }
+        }
+
+        /** Initial status of the message(s) */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MessageSendResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MessageSendResponse =
+            MessageSendResponse(
+                count,
+                groupCreated,
+                groupId,
+                messageId,
+                (messageIds ?: JsonMissing.of()).map { it.toImmutable() },
+                (participants ?: JsonMissing.of()).map { it.toImmutable() },
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MessageSendResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        count()
+        groupCreated()
+        groupId()
+        messageId()
+        messageIds()
+        participants()
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (count.asKnown().isPresent) 1 else 0) +
+            (if (groupCreated.asKnown().isPresent) 1 else 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (messageId.asKnown().isPresent) 1 else 0) +
+            (messageIds.asKnown().getOrNull()?.size ?: 0) +
+            (participants.asKnown().getOrNull()?.size ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Initial status of the message(s) */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val QUEUED = of("queued")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            QUEUED,
+            FAILED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            QUEUED,
+            FAILED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                QUEUED -> Value.QUEUED
+                FAILED -> Value.FAILED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                QUEUED -> Known.QUEUED
+                FAILED -> Known.FAILED
+                else -> throw BlooioInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MessageSendResponse &&
+            count == other.count &&
+            groupCreated == other.groupCreated &&
+            groupId == other.groupId &&
+            messageId == other.messageId &&
+            messageIds == other.messageIds &&
+            participants == other.participants &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            count,
+            groupCreated,
+            groupId,
+            messageId,
+            messageIds,
+            participants,
+            status,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
new file mode 100644
index 0000000..a63dd51
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
@@ -0,0 +1,271 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class Reaction
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val isAdded: JsonField<Boolean>,
+    private val reaction: JsonField<String>,
+    private val sender: JsonField<String>,
+    private val timeSent: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("is_added") @ExcludeMissing isAdded: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("reaction") @ExcludeMissing reaction: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("time_sent") @ExcludeMissing timeSent: JsonField<Long> = JsonMissing.of(),
+    ) : this(isAdded, reaction, sender, timeSent, mutableMapOf())
+
+    /**
+     * Whether the reaction is currently active (true) or was removed (false)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun isAdded(): Optional<Boolean> = isAdded.getOptional("is_added")
+
+    /**
+     * The reaction value. Classic tapbacks: love, like, dislike, laugh, emphasize, question. Emoji
+     * reactions: the emoji character (e.g. 😂, 👍).
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reaction(): Optional<String> = reaction.getOptional("reaction")
+
+    /**
+     * Phone number or email of who sent the reaction. Null when the reaction was sent by you
+     * (outbound).
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun sender(): Optional<String> = sender.getOptional("sender")
+
+    /**
+     * Timestamp when the reaction was sent (ms)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun timeSent(): Optional<Long> = timeSent.getOptional("time_sent")
+
+    /**
+     * Returns the raw JSON value of [isAdded].
+     *
+     * Unlike [isAdded], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("is_added") @ExcludeMissing fun _isAdded(): JsonField<Boolean> = isAdded
+
+    /**
+     * Returns the raw JSON value of [reaction].
+     *
+     * Unlike [reaction], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reaction") @ExcludeMissing fun _reaction(): JsonField<String> = reaction
+
+    /**
+     * Returns the raw JSON value of [sender].
+     *
+     * Unlike [sender], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sender") @ExcludeMissing fun _sender(): JsonField<String> = sender
+
+    /**
+     * Returns the raw JSON value of [timeSent].
+     *
+     * Unlike [timeSent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("time_sent") @ExcludeMissing fun _timeSent(): JsonField<Long> = timeSent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [Reaction]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [Reaction]. */
+    class Builder internal constructor() {
+
+        private var isAdded: JsonField<Boolean> = JsonMissing.of()
+        private var reaction: JsonField<String> = JsonMissing.of()
+        private var sender: JsonField<String> = JsonMissing.of()
+        private var timeSent: JsonField<Long> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(reaction: Reaction) = apply {
+            isAdded = reaction.isAdded
+            this.reaction = reaction.reaction
+            sender = reaction.sender
+            timeSent = reaction.timeSent
+            additionalProperties = reaction.additionalProperties.toMutableMap()
+        }
+
+        /** Whether the reaction is currently active (true) or was removed (false) */
+        fun isAdded(isAdded: Boolean) = isAdded(JsonField.of(isAdded))
+
+        /**
+         * Sets [Builder.isAdded] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.isAdded] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun isAdded(isAdded: JsonField<Boolean>) = apply { this.isAdded = isAdded }
+
+        /**
+         * The reaction value. Classic tapbacks: love, like, dislike, laugh, emphasize, question.
+         * Emoji reactions: the emoji character (e.g. 😂, 👍).
+         */
+        fun reaction(reaction: String) = reaction(JsonField.of(reaction))
+
+        /**
+         * Sets [Builder.reaction] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reaction] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun reaction(reaction: JsonField<String>) = apply { this.reaction = reaction }
+
+        /**
+         * Phone number or email of who sent the reaction. Null when the reaction was sent by you
+         * (outbound).
+         */
+        fun sender(sender: String?) = sender(JsonField.ofNullable(sender))
+
+        /** Alias for calling [Builder.sender] with `sender.orElse(null)`. */
+        fun sender(sender: Optional<String>) = sender(sender.getOrNull())
+
+        /**
+         * Sets [Builder.sender] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sender] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun sender(sender: JsonField<String>) = apply { this.sender = sender }
+
+        /** Timestamp when the reaction was sent (ms) */
+        fun timeSent(timeSent: Long) = timeSent(JsonField.of(timeSent))
+
+        /**
+         * Sets [Builder.timeSent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.timeSent] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun timeSent(timeSent: JsonField<Long>) = apply { this.timeSent = timeSent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [Reaction].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): Reaction =
+            Reaction(isAdded, reaction, sender, timeSent, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): Reaction = apply {
+        if (validated) {
+            return@apply
+        }
+
+        isAdded()
+        reaction()
+        sender()
+        timeSent()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (isAdded.asKnown().isPresent) 1 else 0) +
+            (if (reaction.asKnown().isPresent) 1 else 0) +
+            (if (sender.asKnown().isPresent) 1 else 0) +
+            (if (timeSent.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is Reaction &&
+            isAdded == other.isAdded &&
+            reaction == other.reaction &&
+            sender == other.sender &&
+            timeSent == other.timeSent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(isAdded, reaction, sender, timeSent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "Reaction{isAdded=$isAdded, reaction=$reaction, sender=$sender, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParams.kt
new file mode 100644
index 0000000..b15a832
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParams.kt
@@ -0,0 +1,220 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Retrieve a poll's definition and aggregated vote counts. The pollId is the poll_id returned in
+ * the poll.received or poll.created webhook event.
+ */
+class PollGetResultsParams
+private constructor(
+    private val chatId: String,
+    private val pollId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): String = chatId
+
+    fun pollId(): Optional<String> = Optional.ofNullable(pollId)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [PollGetResultsParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PollGetResultsParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var pollId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(pollGetResultsParams: PollGetResultsParams) = apply {
+            chatId = pollGetResultsParams.chatId
+            pollId = pollGetResultsParams.pollId
+            additionalHeaders = pollGetResultsParams.additionalHeaders.toBuilder()
+            additionalQueryParams = pollGetResultsParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String) = apply { this.chatId = chatId }
+
+        fun pollId(pollId: String?) = apply { this.pollId = pollId }
+
+        /** Alias for calling [Builder.pollId] with `pollId.orElse(null)`. */
+        fun pollId(pollId: Optional<String>) = pollId(pollId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [PollGetResultsParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .chatId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): PollGetResultsParams =
+            PollGetResultsParams(
+                checkRequired("chatId", chatId),
+                pollId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId
+            1 -> pollId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PollGetResultsParams &&
+            chatId == other.chatId &&
+            pollId == other.pollId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, pollId, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "PollGetResultsParams{chatId=$chatId, pollId=$pollId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
new file mode 100644
index 0000000..e9d889f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
@@ -0,0 +1,474 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class PollGetResultsResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatId: JsonField<String>,
+    private val options: JsonField<List<Option>>,
+    private val pollId: JsonField<String>,
+    private val title: JsonField<String>,
+    private val totalVotes: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("options")
+        @ExcludeMissing
+        options: JsonField<List<Option>> = JsonMissing.of(),
+        @JsonProperty("poll_id") @ExcludeMissing pollId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("title") @ExcludeMissing title: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("total_votes") @ExcludeMissing totalVotes: JsonField<Long> = JsonMissing.of(),
+    ) : this(chatId, options, pollId, title, totalVotes, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun options(): Optional<List<Option>> = options.getOptional("options")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pollId(): Optional<String> = pollId.getOptional("poll_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun title(): Optional<String> = title.getOptional("title")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun totalVotes(): Optional<Long> = totalVotes.getOptional("total_votes")
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [options].
+     *
+     * Unlike [options], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("options") @ExcludeMissing fun _options(): JsonField<List<Option>> = options
+
+    /**
+     * Returns the raw JSON value of [pollId].
+     *
+     * Unlike [pollId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("poll_id") @ExcludeMissing fun _pollId(): JsonField<String> = pollId
+
+    /**
+     * Returns the raw JSON value of [title].
+     *
+     * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+    /**
+     * Returns the raw JSON value of [totalVotes].
+     *
+     * Unlike [totalVotes], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("total_votes") @ExcludeMissing fun _totalVotes(): JsonField<Long> = totalVotes
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [PollGetResultsResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PollGetResultsResponse]. */
+    class Builder internal constructor() {
+
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var options: JsonField<MutableList<Option>>? = null
+        private var pollId: JsonField<String> = JsonMissing.of()
+        private var title: JsonField<String> = JsonMissing.of()
+        private var totalVotes: JsonField<Long> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(pollGetResultsResponse: PollGetResultsResponse) = apply {
+            chatId = pollGetResultsResponse.chatId
+            options = pollGetResultsResponse.options.map { it.toMutableList() }
+            pollId = pollGetResultsResponse.pollId
+            title = pollGetResultsResponse.title
+            totalVotes = pollGetResultsResponse.totalVotes
+            additionalProperties = pollGetResultsResponse.additionalProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        fun options(options: List<Option>) = options(JsonField.of(options))
+
+        /**
+         * Sets [Builder.options] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.options] with a well-typed `List<Option>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun options(options: JsonField<List<Option>>) = apply {
+            this.options = options.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Option] to [options].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOption(option: Option) = apply {
+            options =
+                (options ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("options", it).add(option)
+                }
+        }
+
+        fun pollId(pollId: String) = pollId(JsonField.of(pollId))
+
+        /**
+         * Sets [Builder.pollId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pollId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun pollId(pollId: JsonField<String>) = apply { this.pollId = pollId }
+
+        fun title(title: String) = title(JsonField.of(title))
+
+        /**
+         * Sets [Builder.title] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.title] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun title(title: JsonField<String>) = apply { this.title = title }
+
+        fun totalVotes(totalVotes: Long) = totalVotes(JsonField.of(totalVotes))
+
+        /**
+         * Sets [Builder.totalVotes] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.totalVotes] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun totalVotes(totalVotes: JsonField<Long>) = apply { this.totalVotes = totalVotes }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [PollGetResultsResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): PollGetResultsResponse =
+            PollGetResultsResponse(
+                chatId,
+                (options ?: JsonMissing.of()).map { it.toImmutable() },
+                pollId,
+                title,
+                totalVotes,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): PollGetResultsResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatId()
+        options().ifPresent { it.forEach { it.validate() } }
+        pollId()
+        title()
+        totalVotes()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (options.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (pollId.asKnown().isPresent) 1 else 0) +
+            (if (title.asKnown().isPresent) 1 else 0) +
+            (if (totalVotes.asKnown().isPresent) 1 else 0)
+
+    class Option
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val votes: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("votes") @ExcludeMissing votes: JsonField<Long> = JsonMissing.of(),
+        ) : this(text, votes, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<String> = text.getOptional("text")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun votes(): Optional<Long> = votes.getOptional("votes")
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        /**
+         * Returns the raw JSON value of [votes].
+         *
+         * Unlike [votes], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("votes") @ExcludeMissing fun _votes(): JsonField<Long> = votes
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Option]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Option]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String> = JsonMissing.of()
+            private var votes: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(option: Option) = apply {
+                text = option.text
+                votes = option.votes
+                additionalProperties = option.additionalProperties.toMutableMap()
+            }
+
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            fun votes(votes: Long) = votes(JsonField.of(votes))
+
+            /**
+             * Sets [Builder.votes] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.votes] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun votes(votes: JsonField<Long>) = apply { this.votes = votes }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Option].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Option = Option(text, votes, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Option = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            votes()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) + (if (votes.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Option &&
+                text == other.text &&
+                votes == other.votes &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, votes, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Option{text=$text, votes=$votes, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PollGetResultsResponse &&
+            chatId == other.chatId &&
+            options == other.options &&
+            pollId == other.pollId &&
+            title == other.title &&
+            totalVotes == other.totalVotes &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, options, pollId, title, totalVotes, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "PollGetResultsResponse{chatId=$chatId, options=$options, pollId=$pollId, title=$title, totalVotes=$totalVotes, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
new file mode 100644
index 0000000..65f79d2
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
@@ -0,0 +1,531 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Send a native iMessage poll to a chat. The poll appears as an interactive ballot that recipients
+ * can vote on.
+ */
+class PollSendParams
+private constructor(
+    private val chatId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /**
+     * Array of 2-10 option strings for the poll
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun options(): List<String> = body.options()
+
+    /**
+     * Poll question or title (optional)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun title(): Optional<String> = body.title()
+
+    /**
+     * Returns the raw JSON value of [options].
+     *
+     * Unlike [options], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _options(): JsonField<List<String>> = body._options()
+
+    /**
+     * Returns the raw JSON value of [title].
+     *
+     * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _title(): JsonField<String> = body._title()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [PollSendParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .options()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PollSendParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(pollSendParams: PollSendParams) = apply {
+            chatId = pollSendParams.chatId
+            body = pollSendParams.body.toBuilder()
+            additionalHeaders = pollSendParams.additionalHeaders.toBuilder()
+            additionalQueryParams = pollSendParams.additionalQueryParams.toBuilder()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [options]
+         * - [title]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Array of 2-10 option strings for the poll */
+        fun options(options: List<String>) = apply { body.options(options) }
+
+        /**
+         * Sets [Builder.options] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.options] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun options(options: JsonField<List<String>>) = apply { body.options(options) }
+
+        /**
+         * Adds a single [String] to [options].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOption(option: String) = apply { body.addOption(option) }
+
+        /** Poll question or title (optional) */
+        fun title(title: String) = apply { body.title(title) }
+
+        /**
+         * Sets [Builder.title] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.title] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun title(title: JsonField<String>) = apply { body.title(title) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [PollSendParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .options()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): PollSendParams =
+            PollSendParams(
+                chatId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val options: JsonField<List<String>>,
+        private val title: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("options")
+            @ExcludeMissing
+            options: JsonField<List<String>> = JsonMissing.of(),
+            @JsonProperty("title") @ExcludeMissing title: JsonField<String> = JsonMissing.of(),
+        ) : this(options, title, mutableMapOf())
+
+        /**
+         * Array of 2-10 option strings for the poll
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun options(): List<String> = options.getRequired("options")
+
+        /**
+         * Poll question or title (optional)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun title(): Optional<String> = title.getOptional("title")
+
+        /**
+         * Returns the raw JSON value of [options].
+         *
+         * Unlike [options], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("options") @ExcludeMissing fun _options(): JsonField<List<String>> = options
+
+        /**
+         * Returns the raw JSON value of [title].
+         *
+         * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .options()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var options: JsonField<MutableList<String>>? = null
+            private var title: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                options = body.options.map { it.toMutableList() }
+                title = body.title
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Array of 2-10 option strings for the poll */
+            fun options(options: List<String>) = options(JsonField.of(options))
+
+            /**
+             * Sets [Builder.options] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.options] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun options(options: JsonField<List<String>>) = apply {
+                this.options = options.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [options].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOption(option: String) = apply {
+                options =
+                    (options ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("options", it).add(option)
+                    }
+            }
+
+            /** Poll question or title (optional) */
+            fun title(title: String) = title(JsonField.of(title))
+
+            /**
+             * Sets [Builder.title] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.title] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun title(title: JsonField<String>) = apply { this.title = title }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .options()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("options", options).map { it.toImmutable() },
+                    title,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            options()
+            title()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (options.asKnown().getOrNull()?.size ?: 0) + (if (title.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                options == other.options &&
+                title == other.title &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(options, title, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{options=$options, title=$title, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PollSendParams &&
+            chatId == other.chatId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "PollSendParams{chatId=$chatId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
new file mode 100644
index 0000000..3324a44
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
@@ -0,0 +1,444 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class PollSendResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatId: JsonField<String>,
+    private val poll: JsonField<Poll>,
+    private val pollId: JsonField<String>,
+    private val sentAt: JsonField<Double>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("poll") @ExcludeMissing poll: JsonField<Poll> = JsonMissing.of(),
+        @JsonProperty("poll_id") @ExcludeMissing pollId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sent_at") @ExcludeMissing sentAt: JsonField<Double> = JsonMissing.of(),
+    ) : this(chatId, poll, pollId, sentAt, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun poll(): Optional<Poll> = poll.getOptional("poll")
+
+    /**
+     * Unique identifier for the poll
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pollId(): Optional<String> = pollId.getOptional("poll_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun sentAt(): Optional<Double> = sentAt.getOptional("sent_at")
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [poll].
+     *
+     * Unlike [poll], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("poll") @ExcludeMissing fun _poll(): JsonField<Poll> = poll
+
+    /**
+     * Returns the raw JSON value of [pollId].
+     *
+     * Unlike [pollId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("poll_id") @ExcludeMissing fun _pollId(): JsonField<String> = pollId
+
+    /**
+     * Returns the raw JSON value of [sentAt].
+     *
+     * Unlike [sentAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sent_at") @ExcludeMissing fun _sentAt(): JsonField<Double> = sentAt
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [PollSendResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PollSendResponse]. */
+    class Builder internal constructor() {
+
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var poll: JsonField<Poll> = JsonMissing.of()
+        private var pollId: JsonField<String> = JsonMissing.of()
+        private var sentAt: JsonField<Double> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(pollSendResponse: PollSendResponse) = apply {
+            chatId = pollSendResponse.chatId
+            poll = pollSendResponse.poll
+            pollId = pollSendResponse.pollId
+            sentAt = pollSendResponse.sentAt
+            additionalProperties = pollSendResponse.additionalProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        fun poll(poll: Poll) = poll(JsonField.of(poll))
+
+        /**
+         * Sets [Builder.poll] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.poll] with a well-typed [Poll] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun poll(poll: JsonField<Poll>) = apply { this.poll = poll }
+
+        /** Unique identifier for the poll */
+        fun pollId(pollId: String) = pollId(JsonField.of(pollId))
+
+        /**
+         * Sets [Builder.pollId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pollId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun pollId(pollId: JsonField<String>) = apply { this.pollId = pollId }
+
+        fun sentAt(sentAt: Double) = sentAt(JsonField.of(sentAt))
+
+        /**
+         * Sets [Builder.sentAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sentAt] with a well-typed [Double] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun sentAt(sentAt: JsonField<Double>) = apply { this.sentAt = sentAt }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [PollSendResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): PollSendResponse =
+            PollSendResponse(chatId, poll, pollId, sentAt, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): PollSendResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatId()
+        poll().ifPresent { it.validate() }
+        pollId()
+        sentAt()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (poll.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (pollId.asKnown().isPresent) 1 else 0) +
+            (if (sentAt.asKnown().isPresent) 1 else 0)
+
+    class Poll
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val options: JsonField<List<String>>,
+        private val title: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("options")
+            @ExcludeMissing
+            options: JsonField<List<String>> = JsonMissing.of(),
+            @JsonProperty("title") @ExcludeMissing title: JsonField<String> = JsonMissing.of(),
+        ) : this(options, title, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun options(): Optional<List<String>> = options.getOptional("options")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun title(): Optional<String> = title.getOptional("title")
+
+        /**
+         * Returns the raw JSON value of [options].
+         *
+         * Unlike [options], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("options") @ExcludeMissing fun _options(): JsonField<List<String>> = options
+
+        /**
+         * Returns the raw JSON value of [title].
+         *
+         * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Poll]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Poll]. */
+        class Builder internal constructor() {
+
+            private var options: JsonField<MutableList<String>>? = null
+            private var title: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(poll: Poll) = apply {
+                options = poll.options.map { it.toMutableList() }
+                title = poll.title
+                additionalProperties = poll.additionalProperties.toMutableMap()
+            }
+
+            fun options(options: List<String>) = options(JsonField.of(options))
+
+            /**
+             * Sets [Builder.options] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.options] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun options(options: JsonField<List<String>>) = apply {
+                this.options = options.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [options].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOption(option: String) = apply {
+                options =
+                    (options ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("options", it).add(option)
+                    }
+            }
+
+            fun title(title: String) = title(JsonField.of(title))
+
+            /**
+             * Sets [Builder.title] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.title] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun title(title: JsonField<String>) = apply { this.title = title }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Poll].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Poll =
+                Poll(
+                    (options ?: JsonMissing.of()).map { it.toImmutable() },
+                    title,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Poll = apply {
+            if (validated) {
+                return@apply
+            }
+
+            options()
+            title()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (options.asKnown().getOrNull()?.size ?: 0) + (if (title.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Poll &&
+                options == other.options &&
+                title == other.title &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(options, title, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Poll{options=$options, title=$title, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PollSendResponse &&
+            chatId == other.chatId &&
+            poll == other.poll &&
+            pollId == other.pollId &&
+            sentAt == other.sentAt &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, poll, pollId, sentAt, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "PollSendResponse{chatId=$chatId, poll=$poll, pollId=$pollId, sentAt=$sentAt, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
new file mode 100644
index 0000000..a2432e8
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
@@ -0,0 +1,265 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.typing
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class TypingResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatId: JsonField<String>,
+    private val startedAt: JsonField<Long>,
+    private val stoppedAt: JsonField<Long>,
+    private val typing: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_id") @ExcludeMissing chatId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("started_at") @ExcludeMissing startedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("stopped_at") @ExcludeMissing stoppedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("typing") @ExcludeMissing typing: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(chatId, startedAt, stoppedAt, typing, mutableMapOf())
+
+    /**
+     * Chat identifier
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatId(): Optional<String> = chatId.getOptional("chat_id")
+
+    /**
+     * Timestamp when typing started (only for start)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun startedAt(): Optional<Long> = startedAt.getOptional("started_at")
+
+    /**
+     * Timestamp when typing stopped (only for stop)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun stoppedAt(): Optional<Long> = stoppedAt.getOptional("stopped_at")
+
+    /**
+     * Whether typing indicator is active
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun typing(): Optional<Boolean> = typing.getOptional("typing")
+
+    /**
+     * Returns the raw JSON value of [chatId].
+     *
+     * Unlike [chatId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_id") @ExcludeMissing fun _chatId(): JsonField<String> = chatId
+
+    /**
+     * Returns the raw JSON value of [startedAt].
+     *
+     * Unlike [startedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("started_at") @ExcludeMissing fun _startedAt(): JsonField<Long> = startedAt
+
+    /**
+     * Returns the raw JSON value of [stoppedAt].
+     *
+     * Unlike [stoppedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("stopped_at") @ExcludeMissing fun _stoppedAt(): JsonField<Long> = stoppedAt
+
+    /**
+     * Returns the raw JSON value of [typing].
+     *
+     * Unlike [typing], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("typing") @ExcludeMissing fun _typing(): JsonField<Boolean> = typing
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [TypingResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TypingResponse]. */
+    class Builder internal constructor() {
+
+        private var chatId: JsonField<String> = JsonMissing.of()
+        private var startedAt: JsonField<Long> = JsonMissing.of()
+        private var stoppedAt: JsonField<Long> = JsonMissing.of()
+        private var typing: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(typingResponse: TypingResponse) = apply {
+            chatId = typingResponse.chatId
+            startedAt = typingResponse.startedAt
+            stoppedAt = typingResponse.stoppedAt
+            typing = typingResponse.typing
+            additionalProperties = typingResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Chat identifier */
+        fun chatId(chatId: String) = chatId(JsonField.of(chatId))
+
+        /**
+         * Sets [Builder.chatId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatId(chatId: JsonField<String>) = apply { this.chatId = chatId }
+
+        /** Timestamp when typing started (only for start) */
+        fun startedAt(startedAt: Long) = startedAt(JsonField.of(startedAt))
+
+        /**
+         * Sets [Builder.startedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.startedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun startedAt(startedAt: JsonField<Long>) = apply { this.startedAt = startedAt }
+
+        /** Timestamp when typing stopped (only for stop) */
+        fun stoppedAt(stoppedAt: Long) = stoppedAt(JsonField.of(stoppedAt))
+
+        /**
+         * Sets [Builder.stoppedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.stoppedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun stoppedAt(stoppedAt: JsonField<Long>) = apply { this.stoppedAt = stoppedAt }
+
+        /** Whether typing indicator is active */
+        fun typing(typing: Boolean) = typing(JsonField.of(typing))
+
+        /**
+         * Sets [Builder.typing] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.typing] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun typing(typing: JsonField<Boolean>) = apply { this.typing = typing }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TypingResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TypingResponse =
+            TypingResponse(
+                chatId,
+                startedAt,
+                stoppedAt,
+                typing,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): TypingResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatId()
+        startedAt()
+        stoppedAt()
+        typing()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatId.asKnown().isPresent) 1 else 0) +
+            (if (startedAt.asKnown().isPresent) 1 else 0) +
+            (if (stoppedAt.asKnown().isPresent) 1 else 0) +
+            (if (typing.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TypingResponse &&
+            chatId == other.chatId &&
+            startedAt == other.startedAt &&
+            stoppedAt == other.stoppedAt &&
+            typing == other.typing &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatId, startedAt, stoppedAt, typing, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "TypingResponse{chatId=$chatId, startedAt=$startedAt, stoppedAt=$stoppedAt, typing=$typing, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
new file mode 100644
index 0000000..26adcf4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
@@ -0,0 +1,229 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.typing
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Start the typing indicator for a chat. The indicator shows the recipient that you are typing. */
+class TypingStartParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): TypingStartParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [TypingStartParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TypingStartParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(typingStartParams: TypingStartParams) = apply {
+            chatId = typingStartParams.chatId
+            additionalHeaders = typingStartParams.additionalHeaders.toBuilder()
+            additionalQueryParams = typingStartParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = typingStartParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TypingStartParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TypingStartParams =
+            TypingStartParams(
+                chatId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TypingStartParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "TypingStartParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
new file mode 100644
index 0000000..d344b5e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
@@ -0,0 +1,229 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.typing
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Stop the typing indicator for a chat. */
+class TypingStopParams
+private constructor(
+    private val chatId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun chatId(): Optional<String> = Optional.ofNullable(chatId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): TypingStopParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [TypingStopParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TypingStopParams]. */
+    class Builder internal constructor() {
+
+        private var chatId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(typingStopParams: TypingStopParams) = apply {
+            chatId = typingStopParams.chatId
+            additionalHeaders = typingStopParams.additionalHeaders.toBuilder()
+            additionalQueryParams = typingStopParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = typingStopParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun chatId(chatId: String?) = apply { this.chatId = chatId }
+
+        /** Alias for calling [Builder.chatId] with `chatId.orElse(null)`. */
+        fun chatId(chatId: Optional<String>) = chatId(chatId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TypingStopParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TypingStopParams =
+            TypingStopParams(
+                chatId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> chatId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TypingStopParams &&
+            chatId == other.chatId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(chatId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "TypingStopParams{chatId=$chatId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
new file mode 100644
index 0000000..9790f8b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
@@ -0,0 +1,573 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class Contact
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val contactId: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val identifier: JsonField<String>,
+    private val lastMessageTime: JsonField<Long>,
+    private val name: JsonField<String>,
+    private val tags: JsonField<List<String>>,
+    private val type: JsonField<Type>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("contact_id") @ExcludeMissing contactId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("identifier")
+        @ExcludeMissing
+        identifier: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        lastMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("tags") @ExcludeMissing tags: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+    ) : this(
+        id,
+        contactId,
+        createdAt,
+        identifier,
+        lastMessageTime,
+        name,
+        tags,
+        type,
+        mutableMapOf(),
+    )
+
+    /**
+     * Contact identifier (phone or email)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * Internal contact ID
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+    /**
+     * Phone number (E.164) or email
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun tags(): Optional<List<String>> = tags.getOptional("tags")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun type(): Optional<Type> = type.getOptional("type")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [contactId].
+     *
+     * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("contact_id") @ExcludeMissing fun _contactId(): JsonField<String> = contactId
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [identifier].
+     *
+     * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("identifier") @ExcludeMissing fun _identifier(): JsonField<String> = identifier
+
+    /**
+     * Returns the raw JSON value of [lastMessageTime].
+     *
+     * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_time")
+    @ExcludeMissing
+    fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [tags].
+     *
+     * Unlike [tags], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tags") @ExcludeMissing fun _tags(): JsonField<List<String>> = tags
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [Contact]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [Contact]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String> = JsonMissing.of()
+        private var contactId: JsonField<String> = JsonMissing.of()
+        private var createdAt: JsonField<Long> = JsonMissing.of()
+        private var identifier: JsonField<String> = JsonMissing.of()
+        private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var tags: JsonField<MutableList<String>>? = null
+        private var type: JsonField<Type> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contact: Contact) = apply {
+            id = contact.id
+            contactId = contact.contactId
+            createdAt = contact.createdAt
+            identifier = contact.identifier
+            lastMessageTime = contact.lastMessageTime
+            name = contact.name
+            tags = contact.tags.map { it.toMutableList() }
+            type = contact.type
+            additionalProperties = contact.additionalProperties.toMutableMap()
+        }
+
+        /** Contact identifier (phone or email) */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Internal contact ID */
+        fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+        /**
+         * Sets [Builder.contactId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        /** Phone number (E.164) or email */
+        fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+        /**
+         * Sets [Builder.identifier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.identifier] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun identifier(identifier: JsonField<String>) = apply { this.identifier = identifier }
+
+        fun lastMessageTime(lastMessageTime: Long?) =
+            lastMessageTime(JsonField.ofNullable(lastMessageTime))
+
+        /**
+         * Alias for [Builder.lastMessageTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastMessageTime(lastMessageTime: Long) = lastMessageTime(lastMessageTime as Long?)
+
+        /** Alias for calling [Builder.lastMessageTime] with `lastMessageTime.orElse(null)`. */
+        fun lastMessageTime(lastMessageTime: Optional<Long>) =
+            lastMessageTime(lastMessageTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+            this.lastMessageTime = lastMessageTime
+        }
+
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        fun tags(tags: List<String>) = tags(JsonField.of(tags))
+
+        /**
+         * Sets [Builder.tags] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tags] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tags(tags: JsonField<List<String>>) = apply {
+            this.tags = tags.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [tags].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTag(tag: String) = apply {
+            tags = (tags ?: JsonField.of(mutableListOf())).also { checkKnown("tags", it).add(tag) }
+        }
+
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [Contact].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): Contact =
+            Contact(
+                id,
+                contactId,
+                createdAt,
+                identifier,
+                lastMessageTime,
+                name,
+                (tags ?: JsonMissing.of()).map { it.toImmutable() },
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): Contact = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        contactId()
+        createdAt()
+        identifier()
+        lastMessageTime()
+        name()
+        tags()
+        type().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (contactId.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (if (identifier.asKnown().isPresent) 1 else 0) +
+            (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (tags.asKnown().getOrNull()?.size ?: 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0)
+
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val PHONE = of("phone")
+
+            @JvmField val EMAIL = of("email")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            PHONE,
+            EMAIL,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            PHONE,
+            EMAIL,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                PHONE -> Value.PHONE
+                EMAIL -> Value.EMAIL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                PHONE -> Known.PHONE
+                EMAIL -> Known.EMAIL
+                else -> throw BlooioInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is Contact &&
+            id == other.id &&
+            contactId == other.contactId &&
+            createdAt == other.createdAt &&
+            identifier == other.identifier &&
+            lastMessageTime == other.lastMessageTime &&
+            name == other.name &&
+            tags == other.tags &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            contactId,
+            createdAt,
+            identifier,
+            lastMessageTime,
+            name,
+            tags,
+            type,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "Contact{id=$id, contactId=$contactId, createdAt=$createdAt, identifier=$identifier, lastMessageTime=$lastMessageTime, name=$name, tags=$tags, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParams.kt
index 0f90f7d..6ae2da6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParams.kt
@@ -9,18 +9,15 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/**
- * Check if a phone number or email address supports iMessage, SMS, RCS, and other messaging
- * capabilities.
- */
+/** Check if a contact supports iMessage and/or SMS. */
 class ContactCheckCapabilitiesParams
 private constructor(
-    private val contact: String?,
+    private val contactId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    fun contact(): Optional<String> = Optional.ofNullable(contact)
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
 
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
@@ -44,21 +41,21 @@ private constructor(
     /** A builder for [ContactCheckCapabilitiesParams]. */
     class Builder internal constructor() {
 
-        private var contact: String? = null
+        private var contactId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
         internal fun from(contactCheckCapabilitiesParams: ContactCheckCapabilitiesParams) = apply {
-            contact = contactCheckCapabilitiesParams.contact
+            contactId = contactCheckCapabilitiesParams.contactId
             additionalHeaders = contactCheckCapabilitiesParams.additionalHeaders.toBuilder()
             additionalQueryParams = contactCheckCapabilitiesParams.additionalQueryParams.toBuilder()
         }
 
-        fun contact(contact: String?) = apply { this.contact = contact }
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
 
-        /** Alias for calling [Builder.contact] with `contact.orElse(null)`. */
-        fun contact(contact: Optional<String>) = contact(contact.getOrNull())
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -165,7 +162,7 @@ private constructor(
          */
         fun build(): ContactCheckCapabilitiesParams =
             ContactCheckCapabilitiesParams(
-                contact,
+                contactId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
             )
@@ -173,7 +170,7 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> contact ?: ""
+            0 -> contactId ?: ""
             else -> ""
         }
 
@@ -187,13 +184,13 @@ private constructor(
         }
 
         return other is ContactCheckCapabilitiesParams &&
-            contact == other.contact &&
+            contactId == other.contactId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(contact, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(contactId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "ContactCheckCapabilitiesParams{contact=$contact, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "ContactCheckCapabilitiesParams{contactId=$contactId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
index aea1e0a..bf667f0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
@@ -12,7 +12,6 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
-import java.time.OffsetDateTime
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
@@ -23,7 +22,7 @@ class ContactCheckCapabilitiesResponse
 private constructor(
     private val capabilities: JsonField<Capabilities>,
     private val contact: JsonField<String>,
-    private val lastChecked: JsonField<OffsetDateTime>,
+    private val lastChecked: JsonField<Long>,
     private val type: JsonField<Type>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -34,22 +33,20 @@ private constructor(
         @ExcludeMissing
         capabilities: JsonField<Capabilities> = JsonMissing.of(),
         @JsonProperty("contact") @ExcludeMissing contact: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("lastChecked")
+        @JsonProperty("last_checked")
         @ExcludeMissing
-        lastChecked: JsonField<OffsetDateTime> = JsonMissing.of(),
+        lastChecked: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
     ) : this(capabilities, contact, lastChecked, type, mutableMapOf())
 
     /**
-     * Messaging capabilities for this contact.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun capabilities(): Optional<Capabilities> = capabilities.getOptional("capabilities")
 
     /**
-     * The contact identifier (phone number or email).
+     * Normalized contact identifier
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -57,16 +54,14 @@ private constructor(
     fun contact(): Optional<String> = contact.getOptional("contact")
 
     /**
-     * ISO 8601 timestamp of when capabilities were last checked.
+     * Timestamp when capabilities were checked
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun lastChecked(): Optional<OffsetDateTime> = lastChecked.getOptional("lastChecked")
+    fun lastChecked(): Optional<Long> = lastChecked.getOptional("last_checked")
 
     /**
-     * Type of contact identifier.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -93,9 +88,7 @@ private constructor(
      *
      * Unlike [lastChecked], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("lastChecked")
-    @ExcludeMissing
-    fun _lastChecked(): JsonField<OffsetDateTime> = lastChecked
+    @JsonProperty("last_checked") @ExcludeMissing fun _lastChecked(): JsonField<Long> = lastChecked
 
     /**
      * Returns the raw JSON value of [type].
@@ -130,7 +123,7 @@ private constructor(
 
         private var capabilities: JsonField<Capabilities> = JsonMissing.of()
         private var contact: JsonField<String> = JsonMissing.of()
-        private var lastChecked: JsonField<OffsetDateTime> = JsonMissing.of()
+        private var lastChecked: JsonField<Long> = JsonMissing.of()
         private var type: JsonField<Type> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -145,7 +138,6 @@ private constructor(
                     contactCheckCapabilitiesResponse.additionalProperties.toMutableMap()
             }
 
-        /** Messaging capabilities for this contact. */
         fun capabilities(capabilities: Capabilities) = capabilities(JsonField.of(capabilities))
 
         /**
@@ -159,7 +151,7 @@ private constructor(
             this.capabilities = capabilities
         }
 
-        /** The contact identifier (phone number or email). */
+        /** Normalized contact identifier */
         fun contact(contact: String) = contact(JsonField.of(contact))
 
         /**
@@ -170,21 +162,18 @@ private constructor(
          */
         fun contact(contact: JsonField<String>) = apply { this.contact = contact }
 
-        /** ISO 8601 timestamp of when capabilities were last checked. */
-        fun lastChecked(lastChecked: OffsetDateTime) = lastChecked(JsonField.of(lastChecked))
+        /** Timestamp when capabilities were checked */
+        fun lastChecked(lastChecked: Long) = lastChecked(JsonField.of(lastChecked))
 
         /**
          * Sets [Builder.lastChecked] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.lastChecked] with a well-typed [OffsetDateTime] value
-         * instead. This method is primarily for setting the field to an undocumented or not yet
-         * supported value.
+         * You should usually call [Builder.lastChecked] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
          */
-        fun lastChecked(lastChecked: JsonField<OffsetDateTime>) = apply {
-            this.lastChecked = lastChecked
-        }
+        fun lastChecked(lastChecked: JsonField<Long>) = apply { this.lastChecked = lastChecked }
 
-        /** Type of contact identifier. */
         fun type(type: Type) = type(JsonField.of(type))
 
         /**
@@ -263,10 +252,10 @@ private constructor(
             (if (lastChecked.asKnown().isPresent) 1 else 0) +
             (type.asKnown().getOrNull()?.validity() ?: 0)
 
-    /** Messaging capabilities for this contact. */
     class Capabilities
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
+        private val facetime: JsonField<Boolean>,
         private val imessage: JsonField<Boolean>,
         private val sms: JsonField<Boolean>,
         private val additionalProperties: MutableMap<String, JsonValue>,
@@ -274,14 +263,25 @@ private constructor(
 
         @JsonCreator
         private constructor(
+            @JsonProperty("facetime")
+            @ExcludeMissing
+            facetime: JsonField<Boolean> = JsonMissing.of(),
             @JsonProperty("imessage")
             @ExcludeMissing
             imessage: JsonField<Boolean> = JsonMissing.of(),
             @JsonProperty("sms") @ExcludeMissing sms: JsonField<Boolean> = JsonMissing.of(),
-        ) : this(imessage, sms, mutableMapOf())
+        ) : this(facetime, imessage, sms, mutableMapOf())
 
         /**
-         * Whether this contact supports iMessage.
+         * Whether FaceTime is available
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun facetime(): Optional<Boolean> = facetime.getOptional("facetime")
+
+        /**
+         * Whether iMessage is available
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -289,13 +289,20 @@ private constructor(
         fun imessage(): Optional<Boolean> = imessage.getOptional("imessage")
 
         /**
-         * Whether this contact supports SMS (always true for phone numbers, false for emails).
+         * Whether SMS is available (phone only)
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
         fun sms(): Optional<Boolean> = sms.getOptional("sms")
 
+        /**
+         * Returns the raw JSON value of [facetime].
+         *
+         * Unlike [facetime], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("facetime") @ExcludeMissing fun _facetime(): JsonField<Boolean> = facetime
+
         /**
          * Returns the raw JSON value of [imessage].
          *
@@ -331,18 +338,32 @@ private constructor(
         /** A builder for [Capabilities]. */
         class Builder internal constructor() {
 
+            private var facetime: JsonField<Boolean> = JsonMissing.of()
             private var imessage: JsonField<Boolean> = JsonMissing.of()
             private var sms: JsonField<Boolean> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(capabilities: Capabilities) = apply {
+                facetime = capabilities.facetime
                 imessage = capabilities.imessage
                 sms = capabilities.sms
                 additionalProperties = capabilities.additionalProperties.toMutableMap()
             }
 
-            /** Whether this contact supports iMessage. */
+            /** Whether FaceTime is available */
+            fun facetime(facetime: Boolean) = facetime(JsonField.of(facetime))
+
+            /**
+             * Sets [Builder.facetime] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.facetime] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun facetime(facetime: JsonField<Boolean>) = apply { this.facetime = facetime }
+
+            /** Whether iMessage is available */
             fun imessage(imessage: Boolean) = imessage(JsonField.of(imessage))
 
             /**
@@ -354,9 +375,7 @@ private constructor(
              */
             fun imessage(imessage: JsonField<Boolean>) = apply { this.imessage = imessage }
 
-            /**
-             * Whether this contact supports SMS (always true for phone numbers, false for emails).
-             */
+            /** Whether SMS is available (phone only) */
             fun sms(sms: Boolean) = sms(JsonField.of(sms))
 
             /**
@@ -393,7 +412,7 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): Capabilities =
-                Capabilities(imessage, sms, additionalProperties.toMutableMap())
+                Capabilities(facetime, imessage, sms, additionalProperties.toMutableMap())
         }
 
         private var validated: Boolean = false
@@ -403,6 +422,7 @@ private constructor(
                 return@apply
             }
 
+            facetime()
             imessage()
             sms()
             validated = true
@@ -424,7 +444,9 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (imessage.asKnown().isPresent) 1 else 0) + (if (sms.asKnown().isPresent) 1 else 0)
+            (if (facetime.asKnown().isPresent) 1 else 0) +
+                (if (imessage.asKnown().isPresent) 1 else 0) +
+                (if (sms.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -432,20 +454,22 @@ private constructor(
             }
 
             return other is Capabilities &&
+                facetime == other.facetime &&
                 imessage == other.imessage &&
                 sms == other.sms &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(imessage, sms, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(facetime, imessage, sms, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Capabilities{imessage=$imessage, sms=$sms, additionalProperties=$additionalProperties}"
+            "Capabilities{facetime=$facetime, imessage=$imessage, sms=$sms, additionalProperties=$additionalProperties}"
     }
 
-    /** Type of contact identifier. */
     class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
new file mode 100644
index 0000000..e384936
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
@@ -0,0 +1,488 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+/** Create a new contact with a phone number (E.164 format) or email address. */
+class ContactCreateParams
+private constructor(
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /**
+     * Phone number (E.164 format, e.g., +15551234567) or email address
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun identifier(): String = body.identifier()
+
+    /**
+     * Display name for the contact
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = body.name()
+
+    /**
+     * Returns the raw JSON value of [identifier].
+     *
+     * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _identifier(): JsonField<String> = body._identifier()
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _name(): JsonField<String> = body._name()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ContactCreateParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .identifier()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactCreateParams]. */
+    class Builder internal constructor() {
+
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactCreateParams: ContactCreateParams) = apply {
+            body = contactCreateParams.body.toBuilder()
+            additionalHeaders = contactCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactCreateParams.additionalQueryParams.toBuilder()
+        }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [identifier]
+         * - [name]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Phone number (E.164 format, e.g., +15551234567) or email address */
+        fun identifier(identifier: String) = apply { body.identifier(identifier) }
+
+        /**
+         * Sets [Builder.identifier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.identifier] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun identifier(identifier: JsonField<String>) = apply { body.identifier(identifier) }
+
+        /** Display name for the contact */
+        fun name(name: String) = apply { body.name(name) }
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { body.name(name) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactCreateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .identifier()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): ContactCreateParams =
+            ContactCreateParams(
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val identifier: JsonField<String>,
+        private val name: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("identifier")
+            @ExcludeMissing
+            identifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        ) : this(identifier, name, mutableMapOf())
+
+        /**
+         * Phone number (E.164 format, e.g., +15551234567) or email address
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun identifier(): String = identifier.getRequired("identifier")
+
+        /**
+         * Display name for the contact
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Returns the raw JSON value of [identifier].
+         *
+         * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("identifier")
+        @ExcludeMissing
+        fun _identifier(): JsonField<String> = identifier
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .identifier()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var identifier: JsonField<String>? = null
+            private var name: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                identifier = body.identifier
+                name = body.name
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Phone number (E.164 format, e.g., +15551234567) or email address */
+            fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+            /**
+             * Sets [Builder.identifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.identifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun identifier(identifier: JsonField<String>) = apply { this.identifier = identifier }
+
+            /** Display name for the contact */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .identifier()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("identifier", identifier),
+                    name,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            identifier()
+            name()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (identifier.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                identifier == other.identifier &&
+                name == other.name &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(identifier, name, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactCreateParams &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactCreateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactDeleteParams.kt
similarity index 82%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactDeleteParams.kt
index 63332bb..78b5059 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactDeleteParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.contacts
 
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.Params
@@ -11,20 +11,16 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/**
- * Request cancellation for a queued or scheduled message. If the message is already in a
- * non-cancellable state (e.g., sent), the response indicates the current status. Note: response may
- * include deprecated `current_status`; use `status` instead.
- */
-class MessageCancelParams
+/** Soft-delete a contact. */
+class ContactDeleteParams
 private constructor(
-    private val messageId: String?,
+    private val contactId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
     private val additionalBodyProperties: Map<String, JsonValue>,
 ) : Params {
 
-    fun messageId(): Optional<String> = Optional.ofNullable(messageId)
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
 
     /** Additional body properties to send with the request. */
     fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
@@ -39,32 +35,32 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): MessageCancelParams = builder().build()
+        @JvmStatic fun none(): ContactDeleteParams = builder().build()
 
-        /** Returns a mutable builder for constructing an instance of [MessageCancelParams]. */
+        /** Returns a mutable builder for constructing an instance of [ContactDeleteParams]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [MessageCancelParams]. */
+    /** A builder for [ContactDeleteParams]. */
     class Builder internal constructor() {
 
-        private var messageId: String? = null
+        private var contactId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
         private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(messageCancelParams: MessageCancelParams) = apply {
-            messageId = messageCancelParams.messageId
-            additionalHeaders = messageCancelParams.additionalHeaders.toBuilder()
-            additionalQueryParams = messageCancelParams.additionalQueryParams.toBuilder()
-            additionalBodyProperties = messageCancelParams.additionalBodyProperties.toMutableMap()
+        internal fun from(contactDeleteParams: ContactDeleteParams) = apply {
+            contactId = contactDeleteParams.contactId
+            additionalHeaders = contactDeleteParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactDeleteParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = contactDeleteParams.additionalBodyProperties.toMutableMap()
         }
 
-        fun messageId(messageId: String?) = apply { this.messageId = messageId }
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
 
-        /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
-        fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -187,13 +183,13 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [MessageCancelParams].
+         * Returns an immutable instance of [ContactDeleteParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): MessageCancelParams =
-            MessageCancelParams(
-                messageId,
+        fun build(): ContactDeleteParams =
+            ContactDeleteParams(
+                contactId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
                 additionalBodyProperties.toImmutable(),
@@ -205,7 +201,7 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> messageId ?: ""
+            0 -> contactId ?: ""
             else -> ""
         }
 
@@ -218,16 +214,16 @@ private constructor(
             return true
         }
 
-        return other is MessageCancelParams &&
-            messageId == other.messageId &&
+        return other is ContactDeleteParams &&
+            contactId == other.contactId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams &&
             additionalBodyProperties == other.additionalBodyProperties
     }
 
     override fun hashCode(): Int =
-        Objects.hash(messageId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+        Objects.hash(contactId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
 
     override fun toString() =
-        "MessageCancelParams{messageId=$messageId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+        "ContactDeleteParams{contactId=$contactId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
new file mode 100644
index 0000000..06da038
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
@@ -0,0 +1,397 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonCreator
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all contacts for the organization with optional search and pagination. */
+class ContactListParams
+private constructor(
+    private val limit: Long?,
+    private val offset: Long?,
+    private val q: String?,
+    private val sort: Sort?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Search query (matches identifier or name) */
+    fun q(): Optional<String> = Optional.ofNullable(q)
+
+    /** Sort order */
+    fun sort(): Optional<Sort> = Optional.ofNullable(sort)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ContactListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactListParams]. */
+    class Builder internal constructor() {
+
+        private var limit: Long? = null
+        private var offset: Long? = null
+        private var q: String? = null
+        private var sort: Sort? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactListParams: ContactListParams) = apply {
+            limit = contactListParams.limit
+            offset = contactListParams.offset
+            q = contactListParams.q
+            sort = contactListParams.sort
+            additionalHeaders = contactListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactListParams.additionalQueryParams.toBuilder()
+        }
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        /** Search query (matches identifier or name) */
+        fun q(q: String?) = apply { this.q = q }
+
+        /** Alias for calling [Builder.q] with `q.orElse(null)`. */
+        fun q(q: Optional<String>) = q(q.getOrNull())
+
+        /** Sort order */
+        fun sort(sort: Sort?) = apply { this.sort = sort }
+
+        /** Alias for calling [Builder.sort] with `sort.orElse(null)`. */
+        fun sort(sort: Optional<Sort>) = sort(sort.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactListParams =
+            ContactListParams(
+                limit,
+                offset,
+                q,
+                sort,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                limit?.let { put("limit", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                q?.let { put("q", it) }
+                sort?.let { put("sort", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    /** Sort order */
+    class Sort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RECENT = of("recent")
+
+            @JvmField val OLDEST = of("oldest")
+
+            @JvmField val NAME_ASC = of("name_asc")
+
+            @JvmField val NAME_DESC = of("name_desc")
+
+            @JvmStatic fun of(value: String) = Sort(JsonField.of(value))
+        }
+
+        /** An enum containing [Sort]'s known values. */
+        enum class Known {
+            RECENT,
+            OLDEST,
+            NAME_ASC,
+            NAME_DESC,
+        }
+
+        /**
+         * An enum containing [Sort]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Sort] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RECENT,
+            OLDEST,
+            NAME_ASC,
+            NAME_DESC,
+            /** An enum member indicating that [Sort] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RECENT -> Value.RECENT
+                OLDEST -> Value.OLDEST
+                NAME_ASC -> Value.NAME_ASC
+                NAME_DESC -> Value.NAME_DESC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RECENT -> Known.RECENT
+                OLDEST -> Known.OLDEST
+                NAME_ASC -> Known.NAME_ASC
+                NAME_DESC -> Known.NAME_DESC
+                else -> throw BlooioInvalidDataException("Unknown Sort: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sort = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sort && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactListParams &&
+            limit == other.limit &&
+            offset == other.offset &&
+            q == other.q &&
+            sort == other.sort &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(limit, offset, q, sort, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactListParams{limit=$limit, offset=$offset, q=$q, sort=$sort, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
new file mode 100644
index 0000000..68dac3e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
@@ -0,0 +1,214 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contacts: JsonField<List<Contact>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("contacts")
+        @ExcludeMissing
+        contacts: JsonField<List<Contact>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(contacts, pagination, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contacts(): Optional<List<Contact>> = contacts.getOptional("contacts")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [contacts].
+     *
+     * Unlike [contacts], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("contacts") @ExcludeMissing fun _contacts(): JsonField<List<Contact>> = contacts
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ContactListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactListResponse]. */
+    class Builder internal constructor() {
+
+        private var contacts: JsonField<MutableList<Contact>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactListResponse: ContactListResponse) = apply {
+            contacts = contactListResponse.contacts.map { it.toMutableList() }
+            pagination = contactListResponse.pagination
+            additionalProperties = contactListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun contacts(contacts: List<Contact>) = contacts(JsonField.of(contacts))
+
+        /**
+         * Sets [Builder.contacts] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contacts] with a well-typed `List<Contact>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun contacts(contacts: JsonField<List<Contact>>) = apply {
+            this.contacts = contacts.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Contact] to [contacts].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addContact(contact: Contact) = apply {
+            contacts =
+                (contacts ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("contacts", it).add(contact)
+                }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactListResponse =
+            ContactListResponse(
+                (contacts ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contacts().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (contacts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactListResponse &&
+            contacts == other.contacts &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(contacts, pagination, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactListResponse{contacts=$contacts, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactRetrieveParams.kt
similarity index 78%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactRetrieveParams.kt
index 60c5841..169f8cb 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactRetrieveParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.contacts
 
 import com.blooio.api.core.Params
 import com.blooio.api.core.http.Headers
@@ -9,15 +9,15 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Get batch status (stub) */
-class BatchRetrieveStatusParams
+/** Get details for a specific contact by phone number or email. */
+class ContactRetrieveParams
 private constructor(
-    private val batchId: String?,
+    private val contactId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    fun batchId(): Optional<String> = Optional.ofNullable(batchId)
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
 
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
@@ -29,32 +29,30 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): BatchRetrieveStatusParams = builder().build()
+        @JvmStatic fun none(): ContactRetrieveParams = builder().build()
 
-        /**
-         * Returns a mutable builder for constructing an instance of [BatchRetrieveStatusParams].
-         */
+        /** Returns a mutable builder for constructing an instance of [ContactRetrieveParams]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [BatchRetrieveStatusParams]. */
+    /** A builder for [ContactRetrieveParams]. */
     class Builder internal constructor() {
 
-        private var batchId: String? = null
+        private var contactId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
-        internal fun from(batchRetrieveStatusParams: BatchRetrieveStatusParams) = apply {
-            batchId = batchRetrieveStatusParams.batchId
-            additionalHeaders = batchRetrieveStatusParams.additionalHeaders.toBuilder()
-            additionalQueryParams = batchRetrieveStatusParams.additionalQueryParams.toBuilder()
+        internal fun from(contactRetrieveParams: ContactRetrieveParams) = apply {
+            contactId = contactRetrieveParams.contactId
+            additionalHeaders = contactRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactRetrieveParams.additionalQueryParams.toBuilder()
         }
 
-        fun batchId(batchId: String?) = apply { this.batchId = batchId }
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
 
-        /** Alias for calling [Builder.batchId] with `batchId.orElse(null)`. */
-        fun batchId(batchId: Optional<String>) = batchId(batchId.getOrNull())
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -155,13 +153,13 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [BatchRetrieveStatusParams].
+         * Returns an immutable instance of [ContactRetrieveParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): BatchRetrieveStatusParams =
-            BatchRetrieveStatusParams(
-                batchId,
+        fun build(): ContactRetrieveParams =
+            ContactRetrieveParams(
+                contactId,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
             )
@@ -169,7 +167,7 @@ private constructor(
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> batchId ?: ""
+            0 -> contactId ?: ""
             else -> ""
         }
 
@@ -182,14 +180,14 @@ private constructor(
             return true
         }
 
-        return other is BatchRetrieveStatusParams &&
-            batchId == other.batchId &&
+        return other is ContactRetrieveParams &&
+            contactId == other.contactId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(batchId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(contactId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "BatchRetrieveStatusParams{batchId=$batchId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "ContactRetrieveParams{contactId=$contactId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
new file mode 100644
index 0000000..13fcd6e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
@@ -0,0 +1,413 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Update a contact's name. */
+class ContactUpdateParams
+private constructor(
+    private val contactId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
+
+    /**
+     * New display name (null to clear)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = body.name()
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _name(): JsonField<String> = body._name()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactUpdateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ContactUpdateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactUpdateParams]. */
+    class Builder internal constructor() {
+
+        private var contactId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactUpdateParams: ContactUpdateParams) = apply {
+            contactId = contactUpdateParams.contactId
+            body = contactUpdateParams.body.toBuilder()
+            additionalHeaders = contactUpdateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactUpdateParams.additionalQueryParams.toBuilder()
+        }
+
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
+
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [name]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** New display name (null to clear) */
+        fun name(name: String?) = apply { body.name(name) }
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { body.name(name) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactUpdateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactUpdateParams =
+            ContactUpdateParams(
+                contactId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> contactId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val name: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of()
+        ) : this(name, mutableMapOf())
+
+        /**
+         * New display name (null to clear)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var name: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                name = body.name
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** New display name (null to clear) */
+            fun name(name: String?) = name(JsonField.ofNullable(name))
+
+            /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+            fun name(name: Optional<String>) = name(name.getOrNull())
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body = Body(name, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            name()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (name.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                name == other.name &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(name, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Body{name=$name, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactUpdateParams &&
+            contactId == other.contactId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(contactId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactUpdateParams{contactId=$contactId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
similarity index 51%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponse.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
index 98239b8..e028688 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.config.webhook
+package com.blooio.api.models.contacts
 
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
@@ -14,53 +14,46 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
-import kotlin.jvm.optionals.getOrNull
 
-class WebhookRetrieveResponse
+class DeleteResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
-    private val updatedAt: JsonField<Long>,
-    private val webhookUrl: JsonField<String>,
+    private val deletedAt: JsonField<Long>,
+    private val success: JsonField<Boolean>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("updated_at") @ExcludeMissing updatedAt: JsonField<Long> = JsonMissing.of(),
-        @JsonProperty("webhook_url")
-        @ExcludeMissing
-        webhookUrl: JsonField<String> = JsonMissing.of(),
-    ) : this(updatedAt, webhookUrl, mutableMapOf())
+        @JsonProperty("deleted_at") @ExcludeMissing deletedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(deletedAt, success, mutableMapOf())
 
     /**
-     * Unix timestamp (ms) when the webhook URL was last updated.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun updatedAt(): Optional<Long> = updatedAt.getOptional("updated_at")
+    fun deletedAt(): Optional<Long> = deletedAt.getOptional("deleted_at")
 
     /**
-     * The current webhook URL or null if not set.
-     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun webhookUrl(): Optional<String> = webhookUrl.getOptional("webhook_url")
+    fun success(): Optional<Boolean> = success.getOptional("success")
 
     /**
-     * Returns the raw JSON value of [updatedAt].
+     * Returns the raw JSON value of [deletedAt].
      *
-     * Unlike [updatedAt], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [deletedAt], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("updated_at") @ExcludeMissing fun _updatedAt(): JsonField<Long> = updatedAt
+    @JsonProperty("deleted_at") @ExcludeMissing fun _deletedAt(): JsonField<Long> = deletedAt
 
     /**
-     * Returns the raw JSON value of [webhookUrl].
+     * Returns the raw JSON value of [success].
      *
-     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("webhook_url") @ExcludeMissing fun _webhookUrl(): JsonField<String> = webhookUrl
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
 
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -76,49 +69,43 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [WebhookRetrieveResponse]. */
+        /** Returns a mutable builder for constructing an instance of [DeleteResponse]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [WebhookRetrieveResponse]. */
+    /** A builder for [DeleteResponse]. */
     class Builder internal constructor() {
 
-        private var updatedAt: JsonField<Long> = JsonMissing.of()
-        private var webhookUrl: JsonField<String> = JsonMissing.of()
+        private var deletedAt: JsonField<Long> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(webhookRetrieveResponse: WebhookRetrieveResponse) = apply {
-            updatedAt = webhookRetrieveResponse.updatedAt
-            webhookUrl = webhookRetrieveResponse.webhookUrl
-            additionalProperties = webhookRetrieveResponse.additionalProperties.toMutableMap()
+        internal fun from(deleteResponse: DeleteResponse) = apply {
+            deletedAt = deleteResponse.deletedAt
+            success = deleteResponse.success
+            additionalProperties = deleteResponse.additionalProperties.toMutableMap()
         }
 
-        /** Unix timestamp (ms) when the webhook URL was last updated. */
-        fun updatedAt(updatedAt: Long) = updatedAt(JsonField.of(updatedAt))
+        fun deletedAt(deletedAt: Long) = deletedAt(JsonField.of(deletedAt))
 
         /**
-         * Sets [Builder.updatedAt] to an arbitrary JSON value.
+         * Sets [Builder.deletedAt] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.updatedAt] with a well-typed [Long] value instead. This
+         * You should usually call [Builder.deletedAt] with a well-typed [Long] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun updatedAt(updatedAt: JsonField<Long>) = apply { this.updatedAt = updatedAt }
+        fun deletedAt(deletedAt: JsonField<Long>) = apply { this.deletedAt = deletedAt }
 
-        /** The current webhook URL or null if not set. */
-        fun webhookUrl(webhookUrl: String?) = webhookUrl(JsonField.ofNullable(webhookUrl))
-
-        /** Alias for calling [Builder.webhookUrl] with `webhookUrl.orElse(null)`. */
-        fun webhookUrl(webhookUrl: Optional<String>) = webhookUrl(webhookUrl.getOrNull())
+        fun success(success: Boolean) = success(JsonField.of(success))
 
         /**
-         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         * Sets [Builder.success] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -140,23 +127,23 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [WebhookRetrieveResponse].
+         * Returns an immutable instance of [DeleteResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): WebhookRetrieveResponse =
-            WebhookRetrieveResponse(updatedAt, webhookUrl, additionalProperties.toMutableMap())
+        fun build(): DeleteResponse =
+            DeleteResponse(deletedAt, success, additionalProperties.toMutableMap())
     }
 
     private var validated: Boolean = false
 
-    fun validate(): WebhookRetrieveResponse = apply {
+    fun validate(): DeleteResponse = apply {
         if (validated) {
             return@apply
         }
 
-        updatedAt()
-        webhookUrl()
+        deletedAt()
+        success()
         validated = true
     }
 
@@ -175,24 +162,23 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (if (updatedAt.asKnown().isPresent) 1 else 0) +
-            (if (webhookUrl.asKnown().isPresent) 1 else 0)
+        (if (deletedAt.asKnown().isPresent) 1 else 0) + (if (success.asKnown().isPresent) 1 else 0)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
         }
 
-        return other is WebhookRetrieveResponse &&
-            updatedAt == other.updatedAt &&
-            webhookUrl == other.webhookUrl &&
+        return other is DeleteResponse &&
+            deletedAt == other.deletedAt &&
+            success == other.success &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(updatedAt, webhookUrl, additionalProperties) }
+    private val hashCode: Int by lazy { Objects.hash(deletedAt, success, additionalProperties) }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "WebhookRetrieveResponse{updatedAt=$updatedAt, webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+        "DeleteResponse{deletedAt=$deletedAt, success=$success, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
new file mode 100644
index 0000000..674e00c
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
@@ -0,0 +1,215 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class Pagination
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val limit: JsonField<Long>,
+    private val offset: JsonField<Long>,
+    private val total: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("limit") @ExcludeMissing limit: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("offset") @ExcludeMissing offset: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("total") @ExcludeMissing total: JsonField<Long> = JsonMissing.of(),
+    ) : this(limit, offset, total, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun limit(): Optional<Long> = limit.getOptional("limit")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun offset(): Optional<Long> = offset.getOptional("offset")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun total(): Optional<Long> = total.getOptional("total")
+
+    /**
+     * Returns the raw JSON value of [limit].
+     *
+     * Unlike [limit], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("limit") @ExcludeMissing fun _limit(): JsonField<Long> = limit
+
+    /**
+     * Returns the raw JSON value of [offset].
+     *
+     * Unlike [offset], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("offset") @ExcludeMissing fun _offset(): JsonField<Long> = offset
+
+    /**
+     * Returns the raw JSON value of [total].
+     *
+     * Unlike [total], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("total") @ExcludeMissing fun _total(): JsonField<Long> = total
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [Pagination]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [Pagination]. */
+    class Builder internal constructor() {
+
+        private var limit: JsonField<Long> = JsonMissing.of()
+        private var offset: JsonField<Long> = JsonMissing.of()
+        private var total: JsonField<Long> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(pagination: Pagination) = apply {
+            limit = pagination.limit
+            offset = pagination.offset
+            total = pagination.total
+            additionalProperties = pagination.additionalProperties.toMutableMap()
+        }
+
+        fun limit(limit: Long) = limit(JsonField.of(limit))
+
+        /**
+         * Sets [Builder.limit] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.limit] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun limit(limit: JsonField<Long>) = apply { this.limit = limit }
+
+        fun offset(offset: Long) = offset(JsonField.of(offset))
+
+        /**
+         * Sets [Builder.offset] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.offset] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun offset(offset: JsonField<Long>) = apply { this.offset = offset }
+
+        fun total(total: Long) = total(JsonField.of(total))
+
+        /**
+         * Sets [Builder.total] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.total] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun total(total: JsonField<Long>) = apply { this.total = total }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [Pagination].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): Pagination =
+            Pagination(limit, offset, total, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): Pagination = apply {
+        if (validated) {
+            return@apply
+        }
+
+        limit()
+        offset()
+        total()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (limit.asKnown().isPresent) 1 else 0) +
+            (if (offset.asKnown().isPresent) 1 else 0) +
+            (if (total.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is Pagination &&
+            limit == other.limit &&
+            offset == other.offset &&
+            total == other.total &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(limit, offset, total, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "Pagination{limit=$limit, offset=$offset, total=$total, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
new file mode 100644
index 0000000..3185a04
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
@@ -0,0 +1,463 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Add one or more tags to a contact. If a tag already exists on the contact, it is re-activated
+ * (idempotent). Tags are free-form strings.
+ */
+class TagAddParams
+private constructor(
+    private val contactId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
+
+    /**
+     * Tags to add
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tags(): List<String> = body.tags()
+
+    /**
+     * Returns the raw JSON value of [tags].
+     *
+     * Unlike [tags], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _tags(): JsonField<List<String>> = body._tags()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [TagAddParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .tags()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TagAddParams]. */
+    class Builder internal constructor() {
+
+        private var contactId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(tagAddParams: TagAddParams) = apply {
+            contactId = tagAddParams.contactId
+            body = tagAddParams.body.toBuilder()
+            additionalHeaders = tagAddParams.additionalHeaders.toBuilder()
+            additionalQueryParams = tagAddParams.additionalQueryParams.toBuilder()
+        }
+
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
+
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [tags]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Tags to add */
+        fun tags(tags: List<String>) = apply { body.tags(tags) }
+
+        /**
+         * Sets [Builder.tags] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tags] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tags(tags: JsonField<List<String>>) = apply { body.tags(tags) }
+
+        /**
+         * Adds a single [String] to [tags].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTag(tag: String) = apply { body.addTag(tag) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [TagAddParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .tags()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): TagAddParams =
+            TagAddParams(
+                contactId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> contactId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val tags: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("tags") @ExcludeMissing tags: JsonField<List<String>> = JsonMissing.of()
+        ) : this(tags, mutableMapOf())
+
+        /**
+         * Tags to add
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tags(): List<String> = tags.getRequired("tags")
+
+        /**
+         * Returns the raw JSON value of [tags].
+         *
+         * Unlike [tags], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tags") @ExcludeMissing fun _tags(): JsonField<List<String>> = tags
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .tags()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var tags: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                tags = body.tags.map { it.toMutableList() }
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Tags to add */
+            fun tags(tags: List<String>) = tags(JsonField.of(tags))
+
+            /**
+             * Sets [Builder.tags] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tags] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tags(tags: JsonField<List<String>>) = apply {
+                this.tags = tags.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [tags].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTag(tag: String) = apply {
+                tags =
+                    (tags ?: JsonField.of(mutableListOf())).also { checkKnown("tags", it).add(tag) }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .tags()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("tags", tags).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            tags()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (tags.asKnown().getOrNull()?.size ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                tags == other.tags &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(tags, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Body{tags=$tags, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TagAddParams &&
+            contactId == other.contactId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(contactId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "TagAddParams{contactId=$contactId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
new file mode 100644
index 0000000..b63c89a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
@@ -0,0 +1,213 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class TagAddResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val success: JsonField<Boolean>,
+    private val tagsAdded: JsonField<List<String>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("tags_added")
+        @ExcludeMissing
+        tagsAdded: JsonField<List<String>> = JsonMissing.of(),
+    ) : this(success, tagsAdded, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Tags that were added
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun tagsAdded(): Optional<List<String>> = tagsAdded.getOptional("tags_added")
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    /**
+     * Returns the raw JSON value of [tagsAdded].
+     *
+     * Unlike [tagsAdded], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tags_added")
+    @ExcludeMissing
+    fun _tagsAdded(): JsonField<List<String>> = tagsAdded
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [TagAddResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TagAddResponse]. */
+    class Builder internal constructor() {
+
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var tagsAdded: JsonField<MutableList<String>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(tagAddResponse: TagAddResponse) = apply {
+            success = tagAddResponse.success
+            tagsAdded = tagAddResponse.tagsAdded.map { it.toMutableList() }
+            additionalProperties = tagAddResponse.additionalProperties.toMutableMap()
+        }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        /** Tags that were added */
+        fun tagsAdded(tagsAdded: List<String>) = tagsAdded(JsonField.of(tagsAdded))
+
+        /**
+         * Sets [Builder.tagsAdded] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tagsAdded] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun tagsAdded(tagsAdded: JsonField<List<String>>) = apply {
+            this.tagsAdded = tagsAdded.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [Builder.tagsAdded].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTagsAdded(tagsAdded: String) = apply {
+            this.tagsAdded =
+                (this.tagsAdded ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("tagsAdded", it).add(tagsAdded)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TagAddResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TagAddResponse =
+            TagAddResponse(
+                success,
+                (tagsAdded ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): TagAddResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        success()
+        tagsAdded()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (success.asKnown().isPresent) 1 else 0) + (tagsAdded.asKnown().getOrNull()?.size ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TagAddResponse &&
+            success == other.success &&
+            tagsAdded == other.tagsAdded &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(success, tagsAdded, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "TagAddResponse{success=$success, tagsAdded=$tagsAdded, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListParams.kt
new file mode 100644
index 0000000..f6e6b08
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListParams.kt
@@ -0,0 +1,189 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all tags assigned to a contact. */
+class TagListParams
+private constructor(
+    private val contactId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): TagListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [TagListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TagListParams]. */
+    class Builder internal constructor() {
+
+        private var contactId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(tagListParams: TagListParams) = apply {
+            contactId = tagListParams.contactId
+            additionalHeaders = tagListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = tagListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
+
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [TagListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TagListParams =
+            TagListParams(contactId, additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> contactId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TagListParams &&
+            contactId == other.contactId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(contactId, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "TagListParams{contactId=$contactId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
new file mode 100644
index 0000000..498c8c4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
@@ -0,0 +1,348 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class TagListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val tags: JsonField<List<Tag>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("tags") @ExcludeMissing tags: JsonField<List<Tag>> = JsonMissing.of()
+    ) : this(tags, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun tags(): Optional<List<Tag>> = tags.getOptional("tags")
+
+    /**
+     * Returns the raw JSON value of [tags].
+     *
+     * Unlike [tags], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tags") @ExcludeMissing fun _tags(): JsonField<List<Tag>> = tags
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [TagListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TagListResponse]. */
+    class Builder internal constructor() {
+
+        private var tags: JsonField<MutableList<Tag>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(tagListResponse: TagListResponse) = apply {
+            tags = tagListResponse.tags.map { it.toMutableList() }
+            additionalProperties = tagListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun tags(tags: List<Tag>) = tags(JsonField.of(tags))
+
+        /**
+         * Sets [Builder.tags] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tags] with a well-typed `List<Tag>` value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun tags(tags: JsonField<List<Tag>>) = apply { this.tags = tags.map { it.toMutableList() } }
+
+        /**
+         * Adds a single [Tag] to [tags].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTag(tag: Tag) = apply {
+            tags = (tags ?: JsonField.of(mutableListOf())).also { checkKnown("tags", it).add(tag) }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TagListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): TagListResponse =
+            TagListResponse(
+                (tags ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): TagListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        tags().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (tags.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    class Tag
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val createdAt: JsonField<Long>,
+        private val tag: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("created_at")
+            @ExcludeMissing
+            createdAt: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("tag") @ExcludeMissing tag: JsonField<String> = JsonMissing.of(),
+        ) : this(createdAt, tag, mutableMapOf())
+
+        /**
+         * Timestamp when the tag was added (ms since epoch)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+        /**
+         * The tag value
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun tag(): Optional<String> = tag.getOptional("tag")
+
+        /**
+         * Returns the raw JSON value of [createdAt].
+         *
+         * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+        /**
+         * Returns the raw JSON value of [tag].
+         *
+         * Unlike [tag], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tag") @ExcludeMissing fun _tag(): JsonField<String> = tag
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Tag]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Tag]. */
+        class Builder internal constructor() {
+
+            private var createdAt: JsonField<Long> = JsonMissing.of()
+            private var tag: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(tag: Tag) = apply {
+                createdAt = tag.createdAt
+                this.tag = tag.tag
+                additionalProperties = tag.additionalProperties.toMutableMap()
+            }
+
+            /** Timestamp when the tag was added (ms since epoch) */
+            fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+            /**
+             * Sets [Builder.createdAt] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.createdAt] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+            /** The tag value */
+            fun tag(tag: String) = tag(JsonField.of(tag))
+
+            /**
+             * Sets [Builder.tag] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tag] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun tag(tag: JsonField<String>) = apply { this.tag = tag }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Tag].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Tag = Tag(createdAt, tag, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Tag = apply {
+            if (validated) {
+                return@apply
+            }
+
+            createdAt()
+            tag()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (createdAt.asKnown().isPresent) 1 else 0) + (if (tag.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Tag &&
+                createdAt == other.createdAt &&
+                tag == other.tag &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(createdAt, tag, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Tag{createdAt=$createdAt, tag=$tag, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TagListResponse &&
+            tags == other.tags &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(tags, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "TagListResponse{tags=$tags, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParams.kt
new file mode 100644
index 0000000..a0f133f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParams.kt
@@ -0,0 +1,258 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Remove a specific tag from a contact. The tag is soft-deleted and can be re-added later. */
+class TagRemoveParams
+private constructor(
+    private val contactId: String,
+    private val tag: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun contactId(): String = contactId
+
+    fun tag(): Optional<String> = Optional.ofNullable(tag)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [TagRemoveParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .contactId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [TagRemoveParams]. */
+    class Builder internal constructor() {
+
+        private var contactId: String? = null
+        private var tag: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(tagRemoveParams: TagRemoveParams) = apply {
+            contactId = tagRemoveParams.contactId
+            tag = tagRemoveParams.tag
+            additionalHeaders = tagRemoveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = tagRemoveParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = tagRemoveParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun contactId(contactId: String) = apply { this.contactId = contactId }
+
+        fun tag(tag: String?) = apply { this.tag = tag }
+
+        /** Alias for calling [Builder.tag] with `tag.orElse(null)`. */
+        fun tag(tag: Optional<String>) = tag(tag.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [TagRemoveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contactId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): TagRemoveParams =
+            TagRemoveParams(
+                checkRequired("contactId", contactId),
+                tag,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> contactId
+            1 -> tag ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is TagRemoveParams &&
+            contactId == other.contactId &&
+            tag == other.tag &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            contactId,
+            tag,
+            additionalHeaders,
+            additionalQueryParams,
+            additionalBodyProperties,
+        )
+
+    override fun toString() =
+        "TagRemoveParams{contactId=$contactId, tag=$tag, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
similarity index 75%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
index 3157825..e0f86a7 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.config.webhook
+package com.blooio.api.models.facetime
 
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
@@ -19,18 +19,14 @@ import java.util.Collections
 import java.util.Objects
 
 /**
- * Configure the webhook URL that will receive all message events. Once configured, your endpoint
- * will receive POST requests with the following event types:
- * - `message.received` - When you receive an inbound message
- * - `message.sent` - When your outbound message is sent to the carrier
- * - `message.delivered` - When your outbound message is delivered to the recipient
- * - `message.failed` - When your outbound message fails to deliver
- * - `message.read` - When your outbound message is read by the recipient (iMessage only, recipient
- *   must have read receipts enabled)
+ * **Coming Soon** -- This endpoint is temporarily disabled while we stabilize the FaceTime call
+ * flow.
  *
- * See the webhook event schemas for detailed payload formats.
+ * Initiates a FaceTime call to the specified phone number or email address. Returns a shareable
+ * FaceTime link that anyone can use to join the call. The call will ring the contact and auto-admit
+ * the first person who joins via the link.
  */
-class WebhookUpdateParams
+class FacetimeInitiateCallParams
 private constructor(
     private val body: Body,
     private val additionalHeaders: Headers,
@@ -38,17 +34,19 @@ private constructor(
 ) : Params {
 
     /**
+     * Phone number (E.164) or email address to call
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun webhookUrl(): String = body.webhookUrl()
+    fun handle(): String = body.handle()
 
     /**
-     * Returns the raw JSON value of [webhookUrl].
+     * Returns the raw JSON value of [handle].
      *
-     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [handle], this method doesn't throw if the JSON field has an unexpected type.
      */
-    fun _webhookUrl(): JsonField<String> = body._webhookUrl()
+    fun _handle(): JsonField<String> = body._handle()
 
     fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
 
@@ -63,17 +61,17 @@ private constructor(
     companion object {
 
         /**
-         * Returns a mutable builder for constructing an instance of [WebhookUpdateParams].
+         * Returns a mutable builder for constructing an instance of [FacetimeInitiateCallParams].
          *
          * The following fields are required:
          * ```java
-         * .webhookUrl()
+         * .handle()
          * ```
          */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [WebhookUpdateParams]. */
+    /** A builder for [FacetimeInitiateCallParams]. */
     class Builder internal constructor() {
 
         private var body: Body.Builder = Body.builder()
@@ -81,10 +79,10 @@ private constructor(
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
-        internal fun from(webhookUpdateParams: WebhookUpdateParams) = apply {
-            body = webhookUpdateParams.body.toBuilder()
-            additionalHeaders = webhookUpdateParams.additionalHeaders.toBuilder()
-            additionalQueryParams = webhookUpdateParams.additionalQueryParams.toBuilder()
+        internal fun from(facetimeInitiateCallParams: FacetimeInitiateCallParams) = apply {
+            body = facetimeInitiateCallParams.body.toBuilder()
+            additionalHeaders = facetimeInitiateCallParams.additionalHeaders.toBuilder()
+            additionalQueryParams = facetimeInitiateCallParams.additionalQueryParams.toBuilder()
         }
 
         /**
@@ -92,20 +90,20 @@ private constructor(
          *
          * This is generally only useful if you are already constructing the body separately.
          * Otherwise, it's more convenient to use the top-level setters instead:
-         * - [webhookUrl]
+         * - [handle]
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
-        fun webhookUrl(webhookUrl: String) = apply { body.webhookUrl(webhookUrl) }
+        /** Phone number (E.164) or email address to call */
+        fun handle(handle: String) = apply { body.handle(handle) }
 
         /**
-         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         * Sets [Builder.handle] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
+         * You should usually call [Builder.handle] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun webhookUrl(webhookUrl: JsonField<String>) = apply { body.webhookUrl(webhookUrl) }
+        fun handle(handle: JsonField<String>) = apply { body.handle(handle) }
 
         fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
             body.additionalProperties(additionalBodyProperties)
@@ -225,19 +223,19 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [WebhookUpdateParams].
+         * Returns an immutable instance of [FacetimeInitiateCallParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          *
          * The following fields are required:
          * ```java
-         * .webhookUrl()
+         * .handle()
          * ```
          *
          * @throws IllegalStateException if any required field is unset.
          */
-        fun build(): WebhookUpdateParams =
-            WebhookUpdateParams(
+        fun build(): FacetimeInitiateCallParams =
+            FacetimeInitiateCallParams(
                 body.build(),
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
@@ -253,31 +251,29 @@ private constructor(
     class Body
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val webhookUrl: JsonField<String>,
+        private val handle: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("webhook_url")
-            @ExcludeMissing
-            webhookUrl: JsonField<String> = JsonMissing.of()
-        ) : this(webhookUrl, mutableMapOf())
+            @JsonProperty("handle") @ExcludeMissing handle: JsonField<String> = JsonMissing.of()
+        ) : this(handle, mutableMapOf())
 
         /**
+         * Phone number (E.164) or email address to call
+         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun webhookUrl(): String = webhookUrl.getRequired("webhook_url")
+        fun handle(): String = handle.getRequired("handle")
 
         /**
-         * Returns the raw JSON value of [webhookUrl].
+         * Returns the raw JSON value of [handle].
          *
-         * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [handle], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("webhook_url")
-        @ExcludeMissing
-        fun _webhookUrl(): JsonField<String> = webhookUrl
+        @JsonProperty("handle") @ExcludeMissing fun _handle(): JsonField<String> = handle
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -298,7 +294,7 @@ private constructor(
              *
              * The following fields are required:
              * ```java
-             * .webhookUrl()
+             * .handle()
              * ```
              */
             @JvmStatic fun builder() = Builder()
@@ -307,25 +303,26 @@ private constructor(
         /** A builder for [Body]. */
         class Builder internal constructor() {
 
-            private var webhookUrl: JsonField<String>? = null
+            private var handle: JsonField<String>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(body: Body) = apply {
-                webhookUrl = body.webhookUrl
+                handle = body.handle
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
-            fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+            /** Phone number (E.164) or email address to call */
+            fun handle(handle: String) = handle(JsonField.of(handle))
 
             /**
-             * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+             * Sets [Builder.handle] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.webhookUrl] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * You should usually call [Builder.handle] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+            fun handle(handle: JsonField<String>) = apply { this.handle = handle }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -353,13 +350,13 @@ private constructor(
              *
              * The following fields are required:
              * ```java
-             * .webhookUrl()
+             * .handle()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Body =
-                Body(checkRequired("webhookUrl", webhookUrl), additionalProperties.toMutableMap())
+                Body(checkRequired("handle", handle), additionalProperties.toMutableMap())
         }
 
         private var validated: Boolean = false
@@ -369,7 +366,7 @@ private constructor(
                 return@apply
             }
 
-            webhookUrl()
+            handle()
             validated = true
         }
 
@@ -387,7 +384,7 @@ private constructor(
          *
          * Used for best match union deserialization.
          */
-        @JvmSynthetic internal fun validity(): Int = (if (webhookUrl.asKnown().isPresent) 1 else 0)
+        @JvmSynthetic internal fun validity(): Int = (if (handle.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -395,16 +392,15 @@ private constructor(
             }
 
             return other is Body &&
-                webhookUrl == other.webhookUrl &&
+                handle == other.handle &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(webhookUrl, additionalProperties) }
+        private val hashCode: Int by lazy { Objects.hash(handle, additionalProperties) }
 
         override fun hashCode(): Int = hashCode
 
-        override fun toString() =
-            "Body{webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+        override fun toString() = "Body{handle=$handle, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
@@ -412,7 +408,7 @@ private constructor(
             return true
         }
 
-        return other is WebhookUpdateParams &&
+        return other is FacetimeInitiateCallParams &&
             body == other.body &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
@@ -421,5 +417,5 @@ private constructor(
     override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "WebhookUpdateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "FacetimeInitiateCallParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
new file mode 100644
index 0000000..28f184b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
@@ -0,0 +1,223 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.facetime
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class FacetimeInitiateCallResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val handle: JsonField<String>,
+    private val link: JsonField<String>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("handle") @ExcludeMissing handle: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("link") @ExcludeMissing link: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(handle, link, success, mutableMapOf())
+
+    /**
+     * The handle that was called
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun handle(): Optional<String> = handle.getOptional("handle")
+
+    /**
+     * Shareable FaceTime link
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun link(): Optional<String> = link.getOptional("link")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [handle].
+     *
+     * Unlike [handle], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("handle") @ExcludeMissing fun _handle(): JsonField<String> = handle
+
+    /**
+     * Returns the raw JSON value of [link].
+     *
+     * Unlike [link], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("link") @ExcludeMissing fun _link(): JsonField<String> = link
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [FacetimeInitiateCallResponse].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [FacetimeInitiateCallResponse]. */
+    class Builder internal constructor() {
+
+        private var handle: JsonField<String> = JsonMissing.of()
+        private var link: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(facetimeInitiateCallResponse: FacetimeInitiateCallResponse) = apply {
+            handle = facetimeInitiateCallResponse.handle
+            link = facetimeInitiateCallResponse.link
+            success = facetimeInitiateCallResponse.success
+            additionalProperties = facetimeInitiateCallResponse.additionalProperties.toMutableMap()
+        }
+
+        /** The handle that was called */
+        fun handle(handle: String) = handle(JsonField.of(handle))
+
+        /**
+         * Sets [Builder.handle] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.handle] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun handle(handle: JsonField<String>) = apply { this.handle = handle }
+
+        /** Shareable FaceTime link */
+        fun link(link: String) = link(JsonField.of(link))
+
+        /**
+         * Sets [Builder.link] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.link] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun link(link: JsonField<String>) = apply { this.link = link }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [FacetimeInitiateCallResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): FacetimeInitiateCallResponse =
+            FacetimeInitiateCallResponse(handle, link, success, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): FacetimeInitiateCallResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        handle()
+        link()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (handle.asKnown().isPresent) 1 else 0) +
+            (if (link.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is FacetimeInitiateCallResponse &&
+            handle == other.handle &&
+            link == other.link &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(handle, link, success, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "FacetimeInitiateCallResponse{handle=$handle, link=$link, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
new file mode 100644
index 0000000..c774541
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class Group
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatGuid: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val groupId: JsonField<String>,
+    private val iconUrl: JsonField<String>,
+    private val lastMessageDirection: JsonField<LastMessageDirection>,
+    private val lastMessageText: JsonField<String>,
+    private val lastMessageTime: JsonField<Long>,
+    private val memberCount: JsonField<Long>,
+    private val messageCount: JsonField<Long>,
+    private val name: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_guid") @ExcludeMissing chatGuid: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("icon_url") @ExcludeMissing iconUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_direction")
+        @ExcludeMissing
+        lastMessageDirection: JsonField<LastMessageDirection> = JsonMissing.of(),
+        @JsonProperty("last_message_text")
+        @ExcludeMissing
+        lastMessageText: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        lastMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("member_count")
+        @ExcludeMissing
+        memberCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("message_count")
+        @ExcludeMissing
+        messageCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        chatGuid,
+        createdAt,
+        groupId,
+        iconUrl,
+        lastMessageDirection,
+        lastMessageText,
+        lastMessageTime,
+        memberCount,
+        messageCount,
+        name,
+        mutableMapOf(),
+    )
+
+    /**
+     * BlueBubbles chat GUID if linked to a device group chat
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * URL of the group icon/photo
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun iconUrl(): Optional<String> = iconUrl.getOptional("icon_url")
+
+    /**
+     * Direction of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageDirection(): Optional<LastMessageDirection> =
+        lastMessageDirection.getOptional("last_message_direction")
+
+    /**
+     * Text of the most recent message in the group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageText(): Optional<String> = lastMessageText.getOptional("last_message_text")
+
+    /**
+     * Timestamp of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun memberCount(): Optional<Long> = memberCount.getOptional("member_count")
+
+    /**
+     * Total number of messages in this group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageCount(): Optional<Long> = messageCount.getOptional("message_count")
+
+    /**
+     * Group name. Null for unnamed groups.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * Returns the raw JSON value of [chatGuid].
+     *
+     * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [iconUrl].
+     *
+     * Unlike [iconUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("icon_url") @ExcludeMissing fun _iconUrl(): JsonField<String> = iconUrl
+
+    /**
+     * Returns the raw JSON value of [lastMessageDirection].
+     *
+     * Unlike [lastMessageDirection], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("last_message_direction")
+    @ExcludeMissing
+    fun _lastMessageDirection(): JsonField<LastMessageDirection> = lastMessageDirection
+
+    /**
+     * Returns the raw JSON value of [lastMessageText].
+     *
+     * Unlike [lastMessageText], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_text")
+    @ExcludeMissing
+    fun _lastMessageText(): JsonField<String> = lastMessageText
+
+    /**
+     * Returns the raw JSON value of [lastMessageTime].
+     *
+     * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_time")
+    @ExcludeMissing
+    fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+    /**
+     * Returns the raw JSON value of [memberCount].
+     *
+     * Unlike [memberCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("member_count") @ExcludeMissing fun _memberCount(): JsonField<Long> = memberCount
+
+    /**
+     * Returns the raw JSON value of [messageCount].
+     *
+     * Unlike [messageCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_count")
+    @ExcludeMissing
+    fun _messageCount(): JsonField<Long> = messageCount
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [Group]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [Group]. */
+    class Builder internal constructor() {
+
+        private var chatGuid: JsonField<String> = JsonMissing.of()
+        private var createdAt: JsonField<Long> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var iconUrl: JsonField<String> = JsonMissing.of()
+        private var lastMessageDirection: JsonField<LastMessageDirection> = JsonMissing.of()
+        private var lastMessageText: JsonField<String> = JsonMissing.of()
+        private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+        private var memberCount: JsonField<Long> = JsonMissing.of()
+        private var messageCount: JsonField<Long> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(group: Group) = apply {
+            chatGuid = group.chatGuid
+            createdAt = group.createdAt
+            groupId = group.groupId
+            iconUrl = group.iconUrl
+            lastMessageDirection = group.lastMessageDirection
+            lastMessageText = group.lastMessageText
+            lastMessageTime = group.lastMessageTime
+            memberCount = group.memberCount
+            messageCount = group.messageCount
+            name = group.name
+            additionalProperties = group.additionalProperties.toMutableMap()
+        }
+
+        /** BlueBubbles chat GUID if linked to a device group chat */
+        fun chatGuid(chatGuid: String?) = chatGuid(JsonField.ofNullable(chatGuid))
+
+        /** Alias for calling [Builder.chatGuid] with `chatGuid.orElse(null)`. */
+        fun chatGuid(chatGuid: Optional<String>) = chatGuid(chatGuid.getOrNull())
+
+        /**
+         * Sets [Builder.chatGuid] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatGuid] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** URL of the group icon/photo */
+        fun iconUrl(iconUrl: String?) = iconUrl(JsonField.ofNullable(iconUrl))
+
+        /** Alias for calling [Builder.iconUrl] with `iconUrl.orElse(null)`. */
+        fun iconUrl(iconUrl: Optional<String>) = iconUrl(iconUrl.getOrNull())
+
+        /**
+         * Sets [Builder.iconUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.iconUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun iconUrl(iconUrl: JsonField<String>) = apply { this.iconUrl = iconUrl }
+
+        /** Direction of the most recent message */
+        fun lastMessageDirection(lastMessageDirection: LastMessageDirection?) =
+            lastMessageDirection(JsonField.ofNullable(lastMessageDirection))
+
+        /**
+         * Alias for calling [Builder.lastMessageDirection] with
+         * `lastMessageDirection.orElse(null)`.
+         */
+        fun lastMessageDirection(lastMessageDirection: Optional<LastMessageDirection>) =
+            lastMessageDirection(lastMessageDirection.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageDirection] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageDirection] with a well-typed
+         * [LastMessageDirection] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun lastMessageDirection(lastMessageDirection: JsonField<LastMessageDirection>) = apply {
+            this.lastMessageDirection = lastMessageDirection
+        }
+
+        /** Text of the most recent message in the group */
+        fun lastMessageText(lastMessageText: String?) =
+            lastMessageText(JsonField.ofNullable(lastMessageText))
+
+        /** Alias for calling [Builder.lastMessageText] with `lastMessageText.orElse(null)`. */
+        fun lastMessageText(lastMessageText: Optional<String>) =
+            lastMessageText(lastMessageText.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageText] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageText] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun lastMessageText(lastMessageText: JsonField<String>) = apply {
+            this.lastMessageText = lastMessageText
+        }
+
+        /** Timestamp of the most recent message */
+        fun lastMessageTime(lastMessageTime: Long?) =
+            lastMessageTime(JsonField.ofNullable(lastMessageTime))
+
+        /**
+         * Alias for [Builder.lastMessageTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastMessageTime(lastMessageTime: Long) = lastMessageTime(lastMessageTime as Long?)
+
+        /** Alias for calling [Builder.lastMessageTime] with `lastMessageTime.orElse(null)`. */
+        fun lastMessageTime(lastMessageTime: Optional<Long>) =
+            lastMessageTime(lastMessageTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+            this.lastMessageTime = lastMessageTime
+        }
+
+        fun memberCount(memberCount: Long) = memberCount(JsonField.of(memberCount))
+
+        /**
+         * Sets [Builder.memberCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.memberCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun memberCount(memberCount: JsonField<Long>) = apply { this.memberCount = memberCount }
+
+        /** Total number of messages in this group */
+        fun messageCount(messageCount: Long) = messageCount(JsonField.of(messageCount))
+
+        /**
+         * Sets [Builder.messageCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageCount(messageCount: JsonField<Long>) = apply { this.messageCount = messageCount }
+
+        /** Group name. Null for unnamed groups. */
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [Group].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): Group =
+            Group(
+                chatGuid,
+                createdAt,
+                groupId,
+                iconUrl,
+                lastMessageDirection,
+                lastMessageText,
+                lastMessageTime,
+                memberCount,
+                messageCount,
+                name,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): Group = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatGuid()
+        createdAt()
+        groupId()
+        iconUrl()
+        lastMessageDirection().ifPresent { it.validate() }
+        lastMessageText()
+        lastMessageTime()
+        memberCount()
+        messageCount()
+        name()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatGuid.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (iconUrl.asKnown().isPresent) 1 else 0) +
+            (lastMessageDirection.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (lastMessageText.asKnown().isPresent) 1 else 0) +
+            (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (memberCount.asKnown().isPresent) 1 else 0) +
+            (if (messageCount.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0)
+
+    /** Direction of the most recent message */
+    class LastMessageDirection
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INBOUND = of("inbound")
+
+            @JvmField val OUTBOUND = of("outbound")
+
+            @JvmStatic fun of(value: String) = LastMessageDirection(JsonField.of(value))
+        }
+
+        /** An enum containing [LastMessageDirection]'s known values. */
+        enum class Known {
+            INBOUND,
+            OUTBOUND,
+        }
+
+        /**
+         * An enum containing [LastMessageDirection]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [LastMessageDirection] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INBOUND,
+            OUTBOUND,
+            /**
+             * An enum member indicating that [LastMessageDirection] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INBOUND -> Value.INBOUND
+                OUTBOUND -> Value.OUTBOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INBOUND -> Known.INBOUND
+                OUTBOUND -> Known.OUTBOUND
+                else -> throw BlooioInvalidDataException("Unknown LastMessageDirection: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): LastMessageDirection = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LastMessageDirection && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is Group &&
+            chatGuid == other.chatGuid &&
+            createdAt == other.createdAt &&
+            groupId == other.groupId &&
+            iconUrl == other.iconUrl &&
+            lastMessageDirection == other.lastMessageDirection &&
+            lastMessageText == other.lastMessageText &&
+            lastMessageTime == other.lastMessageTime &&
+            memberCount == other.memberCount &&
+            messageCount == other.messageCount &&
+            name == other.name &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            chatGuid,
+            createdAt,
+            groupId,
+            iconUrl,
+            lastMessageDirection,
+            lastMessageText,
+            lastMessageTime,
+            memberCount,
+            messageCount,
+            name,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "Group{chatGuid=$chatGuid, createdAt=$createdAt, groupId=$groupId, iconUrl=$iconUrl, lastMessageDirection=$lastMessageDirection, lastMessageText=$lastMessageText, lastMessageTime=$lastMessageTime, memberCount=$memberCount, messageCount=$messageCount, name=$name, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
similarity index 58%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
index abccdd8..17a7c89 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.groups
 
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
@@ -23,77 +23,71 @@ import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
- * Queues an outbound iMessage/SMS to the specified phone number.
+ * Create a new group. There are two modes:
  *
- * Supports optional media attachments via public URLs, and arbitrary metadata for correlation.
+ * **1. Link to existing iMessage chat:** Provide `chat_guid` to join an existing group chat that
+ * was created outside the API. The `members` list records who is in the group but does NOT add them
+ * to the linked iMessage chat. Multiple groups can have the same participants if they have
+ * different `chat_guid`s.
  *
- * For safe retries, provide an `Idempotency-Key` header. If the same key is used twice, the
- * original message will be returned with 200; otherwise a new message is queued with 202.
+ * **2. Create new group:** Omit `chat_guid` to create a new group. When you send the first message,
+ * a new iMessage chat will be created. Note: iMessage only allows one chat per unique participant
+ * set when created via API.
  */
-class MessageSendParams
+class GroupCreateParams
 private constructor(
-    private val idempotencyKey: String?,
     private val body: Body,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    fun idempotencyKey(): Optional<String> = Optional.ofNullable(idempotencyKey)
-
     /**
-     * Recipient phone number in E.164 format (e.g., +15551234567)
+     * Group name (max 255 characters)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
      */
-    fun to(): String = body.to()
+    fun name(): String = body.name()
 
     /**
-     * Array of publicly accessible URLs to media attachments.
+     * BlueBubbles chat GUID to link this group to an existing iMessage chat. Use this to join
+     * groups created elsewhere. You can get this from the BlueBubbles API or from inbound message
+     * webhooks.
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun attachments(): Optional<List<String>> = body.attachments()
-
-    /**
-     * Arbitrary key/value pairs to associate with the message.
-     *
-     * This arbitrary value can be deserialized into a custom type using the `convert` method:
-     * ```java
-     * MyClass myObject = messageSendParams.metadata().convert(MyClass.class);
-     * ```
-     */
-    fun _metadata(): JsonValue = body._metadata()
+    fun chatGuid(): Optional<String> = body.chatGuid()
 
     /**
-     * Text body of the message.
+     * Phone numbers or emails of contacts in the group. When linking via chat_guid, this is for
+     * record-keeping only (members are not added to the linked iMessage chat).
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun text(): Optional<String> = body.text()
+    fun members(): Optional<List<String>> = body.members()
 
     /**
-     * Returns the raw JSON value of [to].
+     * Returns the raw JSON value of [name].
      *
-     * Unlike [to], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
      */
-    fun _to(): JsonField<String> = body._to()
+    fun _name(): JsonField<String> = body._name()
 
     /**
-     * Returns the raw JSON value of [attachments].
+     * Returns the raw JSON value of [chatGuid].
      *
-     * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
      */
-    fun _attachments(): JsonField<List<String>> = body._attachments()
+    fun _chatGuid(): JsonField<String> = body._chatGuid()
 
     /**
-     * Returns the raw JSON value of [text].
+     * Returns the raw JSON value of [members].
      *
-     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [members], this method doesn't throw if the JSON field has an unexpected type.
      */
-    fun _text(): JsonField<String> = body._text()
+    fun _members(): JsonField<List<String>> = body._members()
 
     fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
 
@@ -108,95 +102,88 @@ private constructor(
     companion object {
 
         /**
-         * Returns a mutable builder for constructing an instance of [MessageSendParams].
+         * Returns a mutable builder for constructing an instance of [GroupCreateParams].
          *
          * The following fields are required:
          * ```java
-         * .to()
+         * .name()
          * ```
          */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [MessageSendParams]. */
+    /** A builder for [GroupCreateParams]. */
     class Builder internal constructor() {
 
-        private var idempotencyKey: String? = null
         private var body: Body.Builder = Body.builder()
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
-        internal fun from(messageSendParams: MessageSendParams) = apply {
-            idempotencyKey = messageSendParams.idempotencyKey
-            body = messageSendParams.body.toBuilder()
-            additionalHeaders = messageSendParams.additionalHeaders.toBuilder()
-            additionalQueryParams = messageSendParams.additionalQueryParams.toBuilder()
+        internal fun from(groupCreateParams: GroupCreateParams) = apply {
+            body = groupCreateParams.body.toBuilder()
+            additionalHeaders = groupCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = groupCreateParams.additionalQueryParams.toBuilder()
         }
 
-        fun idempotencyKey(idempotencyKey: String?) = apply { this.idempotencyKey = idempotencyKey }
-
-        /** Alias for calling [Builder.idempotencyKey] with `idempotencyKey.orElse(null)`. */
-        fun idempotencyKey(idempotencyKey: Optional<String>) =
-            idempotencyKey(idempotencyKey.getOrNull())
-
         /**
          * Sets the entire request body.
          *
          * This is generally only useful if you are already constructing the body separately.
          * Otherwise, it's more convenient to use the top-level setters instead:
-         * - [to]
-         * - [attachments]
-         * - [metadata]
-         * - [text]
+         * - [name]
+         * - [chatGuid]
+         * - [members]
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
-        /** Recipient phone number in E.164 format (e.g., +15551234567) */
-        fun to(to: String) = apply { body.to(to) }
+        /** Group name (max 255 characters) */
+        fun name(name: String) = apply { body.name(name) }
 
         /**
-         * Sets [Builder.to] to an arbitrary JSON value.
+         * Sets [Builder.name] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.to] with a well-typed [String] value instead. This
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun to(to: JsonField<String>) = apply { body.to(to) }
-
-        /** Array of publicly accessible URLs to media attachments. */
-        fun attachments(attachments: List<String>) = apply { body.attachments(attachments) }
+        fun name(name: JsonField<String>) = apply { body.name(name) }
 
         /**
-         * Sets [Builder.attachments] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.attachments] with a well-typed `List<String>` value
-         * instead. This method is primarily for setting the field to an undocumented or not yet
-         * supported value.
+         * BlueBubbles chat GUID to link this group to an existing iMessage chat. Use this to join
+         * groups created elsewhere. You can get this from the BlueBubbles API or from inbound
+         * message webhooks.
          */
-        fun attachments(attachments: JsonField<List<String>>) = apply {
-            body.attachments(attachments)
-        }
+        fun chatGuid(chatGuid: String) = apply { body.chatGuid(chatGuid) }
 
         /**
-         * Adds a single [String] to [attachments].
+         * Sets [Builder.chatGuid] to an arbitrary JSON value.
          *
-         * @throws IllegalStateException if the field was previously set to a non-list.
+         * You should usually call [Builder.chatGuid] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun addAttachment(attachment: String) = apply { body.addAttachment(attachment) }
+        fun chatGuid(chatGuid: JsonField<String>) = apply { body.chatGuid(chatGuid) }
 
-        /** Arbitrary key/value pairs to associate with the message. */
-        fun metadata(metadata: JsonValue) = apply { body.metadata(metadata) }
+        /**
+         * Phone numbers or emails of contacts in the group. When linking via chat_guid, this is for
+         * record-keeping only (members are not added to the linked iMessage chat).
+         */
+        fun members(members: List<String>) = apply { body.members(members) }
 
-        /** Text body of the message. */
-        fun text(text: String) = apply { body.text(text) }
+        /**
+         * Sets [Builder.members] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.members] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun members(members: JsonField<List<String>>) = apply { body.members(members) }
 
         /**
-         * Sets [Builder.text] to an arbitrary JSON value.
+         * Adds a single [String] to [members].
          *
-         * You should usually call [Builder.text] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
+         * @throws IllegalStateException if the field was previously set to a non-list.
          */
-        fun text(text: JsonField<String>) = apply { body.text(text) }
+        fun addMember(member: String) = apply { body.addMember(member) }
 
         fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
             body.additionalProperties(additionalBodyProperties)
@@ -316,20 +303,19 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [MessageSendParams].
+         * Returns an immutable instance of [GroupCreateParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          *
          * The following fields are required:
          * ```java
-         * .to()
+         * .name()
          * ```
          *
          * @throws IllegalStateException if any required field is unset.
          */
-        fun build(): MessageSendParams =
-            MessageSendParams(
-                idempotencyKey,
+        fun build(): GroupCreateParams =
+            GroupCreateParams(
                 body.build(),
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
@@ -338,92 +324,77 @@ private constructor(
 
     fun _body(): Body = body
 
-    override fun _headers(): Headers =
-        Headers.builder()
-            .apply {
-                idempotencyKey?.let { put("Idempotency-Key", it) }
-                putAll(additionalHeaders)
-            }
-            .build()
+    override fun _headers(): Headers = additionalHeaders
 
     override fun _queryParams(): QueryParams = additionalQueryParams
 
     class Body
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val to: JsonField<String>,
-        private val attachments: JsonField<List<String>>,
-        private val metadata: JsonValue,
-        private val text: JsonField<String>,
+        private val name: JsonField<String>,
+        private val chatGuid: JsonField<String>,
+        private val members: JsonField<List<String>>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("to") @ExcludeMissing to: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("attachments")
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("chat_guid")
+            @ExcludeMissing
+            chatGuid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("members")
             @ExcludeMissing
-            attachments: JsonField<List<String>> = JsonMissing.of(),
-            @JsonProperty("metadata") @ExcludeMissing metadata: JsonValue = JsonMissing.of(),
-            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
-        ) : this(to, attachments, metadata, text, mutableMapOf())
+            members: JsonField<List<String>> = JsonMissing.of(),
+        ) : this(name, chatGuid, members, mutableMapOf())
 
         /**
-         * Recipient phone number in E.164 format (e.g., +15551234567)
+         * Group name (max 255 characters)
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun to(): String = to.getRequired("to")
+        fun name(): String = name.getRequired("name")
 
         /**
-         * Array of publicly accessible URLs to media attachments.
+         * BlueBubbles chat GUID to link this group to an existing iMessage chat. Use this to join
+         * groups created elsewhere. You can get this from the BlueBubbles API or from inbound
+         * message webhooks.
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun attachments(): Optional<List<String>> = attachments.getOptional("attachments")
-
-        /**
-         * Arbitrary key/value pairs to associate with the message.
-         *
-         * This arbitrary value can be deserialized into a custom type using the `convert` method:
-         * ```java
-         * MyClass myObject = body.metadata().convert(MyClass.class);
-         * ```
-         */
-        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
+        fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
 
         /**
-         * Text body of the message.
+         * Phone numbers or emails of contacts in the group. When linking via chat_guid, this is for
+         * record-keeping only (members are not added to the linked iMessage chat).
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun text(): Optional<String> = text.getOptional("text")
+        fun members(): Optional<List<String>> = members.getOptional("members")
 
         /**
-         * Returns the raw JSON value of [to].
+         * Returns the raw JSON value of [name].
          *
-         * Unlike [to], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("to") @ExcludeMissing fun _to(): JsonField<String> = to
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
 
         /**
-         * Returns the raw JSON value of [attachments].
+         * Returns the raw JSON value of [chatGuid].
          *
-         * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("attachments")
-        @ExcludeMissing
-        fun _attachments(): JsonField<List<String>> = attachments
+        @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
 
         /**
-         * Returns the raw JSON value of [text].
+         * Returns the raw JSON value of [members].
          *
-         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [members], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+        @JsonProperty("members") @ExcludeMissing fun _members(): JsonField<List<String>> = members
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -444,7 +415,7 @@ private constructor(
              *
              * The following fields are required:
              * ```java
-             * .to()
+             * .name()
              * ```
              */
             @JvmStatic fun builder() = Builder()
@@ -453,73 +424,75 @@ private constructor(
         /** A builder for [Body]. */
         class Builder internal constructor() {
 
-            private var to: JsonField<String>? = null
-            private var attachments: JsonField<MutableList<String>>? = null
-            private var metadata: JsonValue = JsonMissing.of()
-            private var text: JsonField<String> = JsonMissing.of()
+            private var name: JsonField<String>? = null
+            private var chatGuid: JsonField<String> = JsonMissing.of()
+            private var members: JsonField<MutableList<String>>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(body: Body) = apply {
-                to = body.to
-                attachments = body.attachments.map { it.toMutableList() }
-                metadata = body.metadata
-                text = body.text
+                name = body.name
+                chatGuid = body.chatGuid
+                members = body.members.map { it.toMutableList() }
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
-            /** Recipient phone number in E.164 format (e.g., +15551234567) */
-            fun to(to: String) = to(JsonField.of(to))
+            /** Group name (max 255 characters) */
+            fun name(name: String) = name(JsonField.of(name))
 
             /**
-             * Sets [Builder.to] to an arbitrary JSON value.
+             * Sets [Builder.name] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.to] with a well-typed [String] value instead. This
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
              * method is primarily for setting the field to an undocumented or not yet supported
              * value.
              */
-            fun to(to: JsonField<String>) = apply { this.to = to }
+            fun name(name: JsonField<String>) = apply { this.name = name }
 
-            /** Array of publicly accessible URLs to media attachments. */
-            fun attachments(attachments: List<String>) = attachments(JsonField.of(attachments))
+            /**
+             * BlueBubbles chat GUID to link this group to an existing iMessage chat. Use this to
+             * join groups created elsewhere. You can get this from the BlueBubbles API or from
+             * inbound message webhooks.
+             */
+            fun chatGuid(chatGuid: String) = chatGuid(JsonField.of(chatGuid))
 
             /**
-             * Sets [Builder.attachments] to an arbitrary JSON value.
+             * Sets [Builder.chatGuid] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.attachments] with a well-typed `List<String>` value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * You should usually call [Builder.chatGuid] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun attachments(attachments: JsonField<List<String>>) = apply {
-                this.attachments = attachments.map { it.toMutableList() }
-            }
+            fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+            /**
+             * Phone numbers or emails of contacts in the group. When linking via chat_guid, this is
+             * for record-keeping only (members are not added to the linked iMessage chat).
+             */
+            fun members(members: List<String>) = members(JsonField.of(members))
 
             /**
-             * Adds a single [String] to [attachments].
+             * Sets [Builder.members] to an arbitrary JSON value.
              *
-             * @throws IllegalStateException if the field was previously set to a non-list.
+             * You should usually call [Builder.members] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun addAttachment(attachment: String) = apply {
-                attachments =
-                    (attachments ?: JsonField.of(mutableListOf())).also {
-                        checkKnown("attachments", it).add(attachment)
-                    }
+            fun members(members: JsonField<List<String>>) = apply {
+                this.members = members.map { it.toMutableList() }
             }
 
-            /** Arbitrary key/value pairs to associate with the message. */
-            fun metadata(metadata: JsonValue) = apply { this.metadata = metadata }
-
-            /** Text body of the message. */
-            fun text(text: String) = text(JsonField.of(text))
-
             /**
-             * Sets [Builder.text] to an arbitrary JSON value.
+             * Adds a single [String] to [members].
              *
-             * You should usually call [Builder.text] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * @throws IllegalStateException if the field was previously set to a non-list.
              */
-            fun text(text: JsonField<String>) = apply { this.text = text }
+            fun addMember(member: String) = apply {
+                members =
+                    (members ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("members", it).add(member)
+                    }
+            }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -547,17 +520,16 @@ private constructor(
              *
              * The following fields are required:
              * ```java
-             * .to()
+             * .name()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Body =
                 Body(
-                    checkRequired("to", to),
-                    (attachments ?: JsonMissing.of()).map { it.toImmutable() },
-                    metadata,
-                    text,
+                    checkRequired("name", name),
+                    chatGuid,
+                    (members ?: JsonMissing.of()).map { it.toImmutable() },
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -569,9 +541,9 @@ private constructor(
                 return@apply
             }
 
-            to()
-            attachments()
-            text()
+            name()
+            chatGuid()
+            members()
             validated = true
         }
 
@@ -591,9 +563,9 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (to.asKnown().isPresent) 1 else 0) +
-                (attachments.asKnown().getOrNull()?.size ?: 0) +
-                (if (text.asKnown().isPresent) 1 else 0)
+            (if (name.asKnown().isPresent) 1 else 0) +
+                (if (chatGuid.asKnown().isPresent) 1 else 0) +
+                (members.asKnown().getOrNull()?.size ?: 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -601,21 +573,20 @@ private constructor(
             }
 
             return other is Body &&
-                to == other.to &&
-                attachments == other.attachments &&
-                metadata == other.metadata &&
-                text == other.text &&
+                name == other.name &&
+                chatGuid == other.chatGuid &&
+                members == other.members &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(to, attachments, metadata, text, additionalProperties)
+            Objects.hash(name, chatGuid, members, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{to=$to, attachments=$attachments, metadata=$metadata, text=$text, additionalProperties=$additionalProperties}"
+            "Body{name=$name, chatGuid=$chatGuid, members=$members, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
@@ -623,16 +594,14 @@ private constructor(
             return true
         }
 
-        return other is MessageSendParams &&
-            idempotencyKey == other.idempotencyKey &&
+        return other is GroupCreateParams &&
             body == other.body &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int =
-        Objects.hash(idempotencyKey, body, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "MessageSendParams{idempotencyKey=$idempotencyKey, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "GroupCreateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
new file mode 100644
index 0000000..4c6ba8a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
@@ -0,0 +1,678 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class GroupCreateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatGuid: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val groupId: JsonField<String>,
+    private val iconUrl: JsonField<String>,
+    private val lastMessageDirection: JsonField<Group.LastMessageDirection>,
+    private val lastMessageText: JsonField<String>,
+    private val lastMessageTime: JsonField<Long>,
+    private val memberCount: JsonField<Long>,
+    private val messageCount: JsonField<Long>,
+    private val name: JsonField<String>,
+    private val addedMembers: JsonField<List<String>>,
+    private val createdContacts: JsonField<List<String>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_guid") @ExcludeMissing chatGuid: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("icon_url") @ExcludeMissing iconUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_direction")
+        @ExcludeMissing
+        lastMessageDirection: JsonField<Group.LastMessageDirection> = JsonMissing.of(),
+        @JsonProperty("last_message_text")
+        @ExcludeMissing
+        lastMessageText: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        lastMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("member_count")
+        @ExcludeMissing
+        memberCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("message_count")
+        @ExcludeMissing
+        messageCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("added_members")
+        @ExcludeMissing
+        addedMembers: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("created_contacts")
+        @ExcludeMissing
+        createdContacts: JsonField<List<String>> = JsonMissing.of(),
+    ) : this(
+        chatGuid,
+        createdAt,
+        groupId,
+        iconUrl,
+        lastMessageDirection,
+        lastMessageText,
+        lastMessageTime,
+        memberCount,
+        messageCount,
+        name,
+        addedMembers,
+        createdContacts,
+        mutableMapOf(),
+    )
+
+    fun toGroup(): Group =
+        Group.builder()
+            .chatGuid(chatGuid)
+            .createdAt(createdAt)
+            .groupId(groupId)
+            .iconUrl(iconUrl)
+            .lastMessageDirection(lastMessageDirection)
+            .lastMessageText(lastMessageText)
+            .lastMessageTime(lastMessageTime)
+            .memberCount(memberCount)
+            .messageCount(messageCount)
+            .name(name)
+            .build()
+
+    /**
+     * BlueBubbles chat GUID if linked to a device group chat
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * URL of the group icon/photo
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun iconUrl(): Optional<String> = iconUrl.getOptional("icon_url")
+
+    /**
+     * Direction of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageDirection(): Optional<Group.LastMessageDirection> =
+        lastMessageDirection.getOptional("last_message_direction")
+
+    /**
+     * Text of the most recent message in the group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageText(): Optional<String> = lastMessageText.getOptional("last_message_text")
+
+    /**
+     * Timestamp of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun memberCount(): Optional<Long> = memberCount.getOptional("member_count")
+
+    /**
+     * Total number of messages in this group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageCount(): Optional<Long> = messageCount.getOptional("message_count")
+
+    /**
+     * Group name. Null for unnamed groups.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * List of member identifiers that were added to the group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun addedMembers(): Optional<List<String>> = addedMembers.getOptional("added_members")
+
+    /**
+     * List of contacts that were auto-created
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdContacts(): Optional<List<String>> = createdContacts.getOptional("created_contacts")
+
+    /**
+     * Returns the raw JSON value of [chatGuid].
+     *
+     * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [iconUrl].
+     *
+     * Unlike [iconUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("icon_url") @ExcludeMissing fun _iconUrl(): JsonField<String> = iconUrl
+
+    /**
+     * Returns the raw JSON value of [lastMessageDirection].
+     *
+     * Unlike [lastMessageDirection], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("last_message_direction")
+    @ExcludeMissing
+    fun _lastMessageDirection(): JsonField<Group.LastMessageDirection> = lastMessageDirection
+
+    /**
+     * Returns the raw JSON value of [lastMessageText].
+     *
+     * Unlike [lastMessageText], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_text")
+    @ExcludeMissing
+    fun _lastMessageText(): JsonField<String> = lastMessageText
+
+    /**
+     * Returns the raw JSON value of [lastMessageTime].
+     *
+     * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_time")
+    @ExcludeMissing
+    fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+    /**
+     * Returns the raw JSON value of [memberCount].
+     *
+     * Unlike [memberCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("member_count") @ExcludeMissing fun _memberCount(): JsonField<Long> = memberCount
+
+    /**
+     * Returns the raw JSON value of [messageCount].
+     *
+     * Unlike [messageCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_count")
+    @ExcludeMissing
+    fun _messageCount(): JsonField<Long> = messageCount
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [addedMembers].
+     *
+     * Unlike [addedMembers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("added_members")
+    @ExcludeMissing
+    fun _addedMembers(): JsonField<List<String>> = addedMembers
+
+    /**
+     * Returns the raw JSON value of [createdContacts].
+     *
+     * Unlike [createdContacts], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_contacts")
+    @ExcludeMissing
+    fun _createdContacts(): JsonField<List<String>> = createdContacts
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupCreateResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupCreateResponse]. */
+    class Builder internal constructor() {
+
+        private var chatGuid: JsonField<String> = JsonMissing.of()
+        private var createdAt: JsonField<Long> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var iconUrl: JsonField<String> = JsonMissing.of()
+        private var lastMessageDirection: JsonField<Group.LastMessageDirection> = JsonMissing.of()
+        private var lastMessageText: JsonField<String> = JsonMissing.of()
+        private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+        private var memberCount: JsonField<Long> = JsonMissing.of()
+        private var messageCount: JsonField<Long> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var addedMembers: JsonField<MutableList<String>>? = null
+        private var createdContacts: JsonField<MutableList<String>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupCreateResponse: GroupCreateResponse) = apply {
+            chatGuid = groupCreateResponse.chatGuid
+            createdAt = groupCreateResponse.createdAt
+            groupId = groupCreateResponse.groupId
+            iconUrl = groupCreateResponse.iconUrl
+            lastMessageDirection = groupCreateResponse.lastMessageDirection
+            lastMessageText = groupCreateResponse.lastMessageText
+            lastMessageTime = groupCreateResponse.lastMessageTime
+            memberCount = groupCreateResponse.memberCount
+            messageCount = groupCreateResponse.messageCount
+            name = groupCreateResponse.name
+            addedMembers = groupCreateResponse.addedMembers.map { it.toMutableList() }
+            createdContacts = groupCreateResponse.createdContacts.map { it.toMutableList() }
+            additionalProperties = groupCreateResponse.additionalProperties.toMutableMap()
+        }
+
+        /** BlueBubbles chat GUID if linked to a device group chat */
+        fun chatGuid(chatGuid: String?) = chatGuid(JsonField.ofNullable(chatGuid))
+
+        /** Alias for calling [Builder.chatGuid] with `chatGuid.orElse(null)`. */
+        fun chatGuid(chatGuid: Optional<String>) = chatGuid(chatGuid.getOrNull())
+
+        /**
+         * Sets [Builder.chatGuid] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatGuid] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** URL of the group icon/photo */
+        fun iconUrl(iconUrl: String?) = iconUrl(JsonField.ofNullable(iconUrl))
+
+        /** Alias for calling [Builder.iconUrl] with `iconUrl.orElse(null)`. */
+        fun iconUrl(iconUrl: Optional<String>) = iconUrl(iconUrl.getOrNull())
+
+        /**
+         * Sets [Builder.iconUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.iconUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun iconUrl(iconUrl: JsonField<String>) = apply { this.iconUrl = iconUrl }
+
+        /** Direction of the most recent message */
+        fun lastMessageDirection(lastMessageDirection: Group.LastMessageDirection?) =
+            lastMessageDirection(JsonField.ofNullable(lastMessageDirection))
+
+        /**
+         * Alias for calling [Builder.lastMessageDirection] with
+         * `lastMessageDirection.orElse(null)`.
+         */
+        fun lastMessageDirection(lastMessageDirection: Optional<Group.LastMessageDirection>) =
+            lastMessageDirection(lastMessageDirection.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageDirection] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageDirection] with a well-typed
+         * [Group.LastMessageDirection] value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun lastMessageDirection(lastMessageDirection: JsonField<Group.LastMessageDirection>) =
+            apply {
+                this.lastMessageDirection = lastMessageDirection
+            }
+
+        /** Text of the most recent message in the group */
+        fun lastMessageText(lastMessageText: String?) =
+            lastMessageText(JsonField.ofNullable(lastMessageText))
+
+        /** Alias for calling [Builder.lastMessageText] with `lastMessageText.orElse(null)`. */
+        fun lastMessageText(lastMessageText: Optional<String>) =
+            lastMessageText(lastMessageText.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageText] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageText] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun lastMessageText(lastMessageText: JsonField<String>) = apply {
+            this.lastMessageText = lastMessageText
+        }
+
+        /** Timestamp of the most recent message */
+        fun lastMessageTime(lastMessageTime: Long?) =
+            lastMessageTime(JsonField.ofNullable(lastMessageTime))
+
+        /**
+         * Alias for [Builder.lastMessageTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastMessageTime(lastMessageTime: Long) = lastMessageTime(lastMessageTime as Long?)
+
+        /** Alias for calling [Builder.lastMessageTime] with `lastMessageTime.orElse(null)`. */
+        fun lastMessageTime(lastMessageTime: Optional<Long>) =
+            lastMessageTime(lastMessageTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+            this.lastMessageTime = lastMessageTime
+        }
+
+        fun memberCount(memberCount: Long) = memberCount(JsonField.of(memberCount))
+
+        /**
+         * Sets [Builder.memberCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.memberCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun memberCount(memberCount: JsonField<Long>) = apply { this.memberCount = memberCount }
+
+        /** Total number of messages in this group */
+        fun messageCount(messageCount: Long) = messageCount(JsonField.of(messageCount))
+
+        /**
+         * Sets [Builder.messageCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageCount(messageCount: JsonField<Long>) = apply { this.messageCount = messageCount }
+
+        /** Group name. Null for unnamed groups. */
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** List of member identifiers that were added to the group */
+        fun addedMembers(addedMembers: List<String>) = addedMembers(JsonField.of(addedMembers))
+
+        /**
+         * Sets [Builder.addedMembers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.addedMembers] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun addedMembers(addedMembers: JsonField<List<String>>) = apply {
+            this.addedMembers = addedMembers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [addedMembers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAddedMember(addedMember: String) = apply {
+            addedMembers =
+                (addedMembers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("addedMembers", it).add(addedMember)
+                }
+        }
+
+        /** List of contacts that were auto-created */
+        fun createdContacts(createdContacts: List<String>) =
+            createdContacts(JsonField.of(createdContacts))
+
+        /**
+         * Sets [Builder.createdContacts] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdContacts] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun createdContacts(createdContacts: JsonField<List<String>>) = apply {
+            this.createdContacts = createdContacts.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [createdContacts].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addCreatedContact(createdContact: String) = apply {
+            createdContacts =
+                (createdContacts ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("createdContacts", it).add(createdContact)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupCreateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupCreateResponse =
+            GroupCreateResponse(
+                chatGuid,
+                createdAt,
+                groupId,
+                iconUrl,
+                lastMessageDirection,
+                lastMessageText,
+                lastMessageTime,
+                memberCount,
+                messageCount,
+                name,
+                (addedMembers ?: JsonMissing.of()).map { it.toImmutable() },
+                (createdContacts ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupCreateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatGuid()
+        createdAt()
+        groupId()
+        iconUrl()
+        lastMessageDirection().ifPresent { it.validate() }
+        lastMessageText()
+        lastMessageTime()
+        memberCount()
+        messageCount()
+        name()
+        addedMembers()
+        createdContacts()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatGuid.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (iconUrl.asKnown().isPresent) 1 else 0) +
+            (lastMessageDirection.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (lastMessageText.asKnown().isPresent) 1 else 0) +
+            (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (memberCount.asKnown().isPresent) 1 else 0) +
+            (if (messageCount.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (addedMembers.asKnown().getOrNull()?.size ?: 0) +
+            (createdContacts.asKnown().getOrNull()?.size ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupCreateResponse &&
+            chatGuid == other.chatGuid &&
+            createdAt == other.createdAt &&
+            groupId == other.groupId &&
+            iconUrl == other.iconUrl &&
+            lastMessageDirection == other.lastMessageDirection &&
+            lastMessageText == other.lastMessageText &&
+            lastMessageTime == other.lastMessageTime &&
+            memberCount == other.memberCount &&
+            messageCount == other.messageCount &&
+            name == other.name &&
+            addedMembers == other.addedMembers &&
+            createdContacts == other.createdContacts &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            chatGuid,
+            createdAt,
+            groupId,
+            iconUrl,
+            lastMessageDirection,
+            lastMessageText,
+            lastMessageTime,
+            memberCount,
+            messageCount,
+            name,
+            addedMembers,
+            createdContacts,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupCreateResponse{chatGuid=$chatGuid, createdAt=$createdAt, groupId=$groupId, iconUrl=$iconUrl, lastMessageDirection=$lastMessageDirection, lastMessageText=$lastMessageText, lastMessageTime=$lastMessageTime, memberCount=$memberCount, messageCount=$messageCount, name=$name, addedMembers=$addedMembers, createdContacts=$createdContacts, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteParams.kt
new file mode 100644
index 0000000..78dd878
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteParams.kt
@@ -0,0 +1,232 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Soft-delete a group. Members are automatically removed. If the group is linked to an existing
+ * iMessage chat, the number also leaves that chat.
+ */
+class GroupDeleteParams
+private constructor(
+    private val groupId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): GroupDeleteParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [GroupDeleteParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupDeleteParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupDeleteParams: GroupDeleteParams) = apply {
+            groupId = groupDeleteParams.groupId
+            additionalHeaders = groupDeleteParams.additionalHeaders.toBuilder()
+            additionalQueryParams = groupDeleteParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = groupDeleteParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupDeleteParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupDeleteParams =
+            GroupDeleteParams(
+                groupId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupDeleteParams &&
+            groupId == other.groupId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "GroupDeleteParams{groupId=$groupId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
new file mode 100644
index 0000000..722dc01
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
@@ -0,0 +1,184 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class GroupDeleteResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val deletedAt: JsonField<Long>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("deleted_at") @ExcludeMissing deletedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(deletedAt, success, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deletedAt(): Optional<Long> = deletedAt.getOptional("deleted_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [deletedAt].
+     *
+     * Unlike [deletedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("deleted_at") @ExcludeMissing fun _deletedAt(): JsonField<Long> = deletedAt
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupDeleteResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupDeleteResponse]. */
+    class Builder internal constructor() {
+
+        private var deletedAt: JsonField<Long> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupDeleteResponse: GroupDeleteResponse) = apply {
+            deletedAt = groupDeleteResponse.deletedAt
+            success = groupDeleteResponse.success
+            additionalProperties = groupDeleteResponse.additionalProperties.toMutableMap()
+        }
+
+        fun deletedAt(deletedAt: Long) = deletedAt(JsonField.of(deletedAt))
+
+        /**
+         * Sets [Builder.deletedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deletedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun deletedAt(deletedAt: JsonField<Long>) = apply { this.deletedAt = deletedAt }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupDeleteResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupDeleteResponse =
+            GroupDeleteResponse(deletedAt, success, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupDeleteResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        deletedAt()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (deletedAt.asKnown().isPresent) 1 else 0) + (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupDeleteResponse &&
+            deletedAt == other.deletedAt &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(deletedAt, success, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupDeleteResponse{deletedAt=$deletedAt, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
new file mode 100644
index 0000000..5e5096c
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
@@ -0,0 +1,397 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonCreator
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all groups for the organization with optional search and pagination. */
+class GroupListParams
+private constructor(
+    private val limit: Long?,
+    private val offset: Long?,
+    private val q: String?,
+    private val sort: Sort?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Search query (matches group name) */
+    fun q(): Optional<String> = Optional.ofNullable(q)
+
+    /** Sort order */
+    fun sort(): Optional<Sort> = Optional.ofNullable(sort)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): GroupListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [GroupListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupListParams]. */
+    class Builder internal constructor() {
+
+        private var limit: Long? = null
+        private var offset: Long? = null
+        private var q: String? = null
+        private var sort: Sort? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(groupListParams: GroupListParams) = apply {
+            limit = groupListParams.limit
+            offset = groupListParams.offset
+            q = groupListParams.q
+            sort = groupListParams.sort
+            additionalHeaders = groupListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = groupListParams.additionalQueryParams.toBuilder()
+        }
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        /** Search query (matches group name) */
+        fun q(q: String?) = apply { this.q = q }
+
+        /** Alias for calling [Builder.q] with `q.orElse(null)`. */
+        fun q(q: Optional<String>) = q(q.getOrNull())
+
+        /** Sort order */
+        fun sort(sort: Sort?) = apply { this.sort = sort }
+
+        /** Alias for calling [Builder.sort] with `sort.orElse(null)`. */
+        fun sort(sort: Optional<Sort>) = sort(sort.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupListParams =
+            GroupListParams(
+                limit,
+                offset,
+                q,
+                sort,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                limit?.let { put("limit", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                q?.let { put("q", it) }
+                sort?.let { put("sort", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    /** Sort order */
+    class Sort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RECENT = of("recent")
+
+            @JvmField val OLDEST = of("oldest")
+
+            @JvmField val NAME_ASC = of("name_asc")
+
+            @JvmField val NAME_DESC = of("name_desc")
+
+            @JvmStatic fun of(value: String) = Sort(JsonField.of(value))
+        }
+
+        /** An enum containing [Sort]'s known values. */
+        enum class Known {
+            RECENT,
+            OLDEST,
+            NAME_ASC,
+            NAME_DESC,
+        }
+
+        /**
+         * An enum containing [Sort]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Sort] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RECENT,
+            OLDEST,
+            NAME_ASC,
+            NAME_DESC,
+            /** An enum member indicating that [Sort] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RECENT -> Value.RECENT
+                OLDEST -> Value.OLDEST
+                NAME_ASC -> Value.NAME_ASC
+                NAME_DESC -> Value.NAME_DESC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RECENT -> Known.RECENT
+                OLDEST -> Known.OLDEST
+                NAME_ASC -> Known.NAME_ASC
+                NAME_DESC -> Known.NAME_DESC
+                else -> throw BlooioInvalidDataException("Unknown Sort: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sort = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sort && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupListParams &&
+            limit == other.limit &&
+            offset == other.offset &&
+            q == other.q &&
+            sort == other.sort &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(limit, offset, q, sort, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "GroupListParams{limit=$limit, offset=$offset, q=$q, sort=$sort, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
new file mode 100644
index 0000000..bebc048
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
@@ -0,0 +1,213 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class GroupListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val groups: JsonField<List<Group>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("groups") @ExcludeMissing groups: JsonField<List<Group>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(groups, pagination, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groups(): Optional<List<Group>> = groups.getOptional("groups")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [groups].
+     *
+     * Unlike [groups], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("groups") @ExcludeMissing fun _groups(): JsonField<List<Group>> = groups
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupListResponse]. */
+    class Builder internal constructor() {
+
+        private var groups: JsonField<MutableList<Group>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupListResponse: GroupListResponse) = apply {
+            groups = groupListResponse.groups.map { it.toMutableList() }
+            pagination = groupListResponse.pagination
+            additionalProperties = groupListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun groups(groups: List<Group>) = groups(JsonField.of(groups))
+
+        /**
+         * Sets [Builder.groups] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groups] with a well-typed `List<Group>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun groups(groups: JsonField<List<Group>>) = apply {
+            this.groups = groups.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Group] to [groups].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addGroup(group: Group) = apply {
+            groups =
+                (groups ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("groups", it).add(group)
+                }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupListResponse =
+            GroupListResponse(
+                (groups ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        groups().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (groups.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupListResponse &&
+            groups == other.groups &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(groups, pagination, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupListResponse{groups=$groups, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupRetrieveParams.kt
similarity index 82%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupRetrieveParams.kt
index 7fe66e8..7a025df 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchRetrieveParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupRetrieveParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.groups
 
 import com.blooio.api.core.Params
 import com.blooio.api.core.http.Headers
@@ -9,15 +9,15 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Get batch details (stub) */
-class BatchRetrieveParams
+/** Get details for a specific group. */
+class GroupRetrieveParams
 private constructor(
-    private val batchId: String?,
+    private val groupId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    fun batchId(): Optional<String> = Optional.ofNullable(batchId)
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
 
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
@@ -29,30 +29,30 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): BatchRetrieveParams = builder().build()
+        @JvmStatic fun none(): GroupRetrieveParams = builder().build()
 
-        /** Returns a mutable builder for constructing an instance of [BatchRetrieveParams]. */
+        /** Returns a mutable builder for constructing an instance of [GroupRetrieveParams]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [BatchRetrieveParams]. */
+    /** A builder for [GroupRetrieveParams]. */
     class Builder internal constructor() {
 
-        private var batchId: String? = null
+        private var groupId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
-        internal fun from(batchRetrieveParams: BatchRetrieveParams) = apply {
-            batchId = batchRetrieveParams.batchId
-            additionalHeaders = batchRetrieveParams.additionalHeaders.toBuilder()
-            additionalQueryParams = batchRetrieveParams.additionalQueryParams.toBuilder()
+        internal fun from(groupRetrieveParams: GroupRetrieveParams) = apply {
+            groupId = groupRetrieveParams.groupId
+            additionalHeaders = groupRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = groupRetrieveParams.additionalQueryParams.toBuilder()
         }
 
-        fun batchId(batchId: String?) = apply { this.batchId = batchId }
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
 
-        /** Alias for calling [Builder.batchId] with `batchId.orElse(null)`. */
-        fun batchId(batchId: Optional<String>) = batchId(batchId.getOrNull())
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
@@ -153,17 +153,17 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [BatchRetrieveParams].
+         * Returns an immutable instance of [GroupRetrieveParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): BatchRetrieveParams =
-            BatchRetrieveParams(batchId, additionalHeaders.build(), additionalQueryParams.build())
+        fun build(): GroupRetrieveParams =
+            GroupRetrieveParams(groupId, additionalHeaders.build(), additionalQueryParams.build())
     }
 
     fun _pathParam(index: Int): String =
         when (index) {
-            0 -> batchId ?: ""
+            0 -> groupId ?: ""
             else -> ""
         }
 
@@ -176,14 +176,14 @@ private constructor(
             return true
         }
 
-        return other is BatchRetrieveParams &&
-            batchId == other.batchId &&
+        return other is GroupRetrieveParams &&
+            groupId == other.groupId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(batchId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(groupId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "BatchRetrieveParams{batchId=$batchId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "GroupRetrieveParams{groupId=$groupId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
new file mode 100644
index 0000000..9529f5c
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
@@ -0,0 +1,411 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Update a group's name. If the group has a linked `chat_guid`, the display name will also be
+ * updated in the linked iMessage chat. Note: iMessage only allows one chat per unique participant
+ * set, so renaming simply changes the display name on the existing chat thread.
+ */
+class GroupUpdateParams
+private constructor(
+    private val groupId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /**
+     * New group name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = body.name()
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _name(): JsonField<String> = body._name()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): GroupUpdateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [GroupUpdateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupUpdateParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(groupUpdateParams: GroupUpdateParams) = apply {
+            groupId = groupUpdateParams.groupId
+            body = groupUpdateParams.body.toBuilder()
+            additionalHeaders = groupUpdateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = groupUpdateParams.additionalQueryParams.toBuilder()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [name]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** New group name */
+        fun name(name: String) = apply { body.name(name) }
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { body.name(name) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupUpdateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupUpdateParams =
+            GroupUpdateParams(
+                groupId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val name: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of()
+        ) : this(name, mutableMapOf())
+
+        /**
+         * New group name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun name(): Optional<String> = name.getOptional("name")
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var name: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                name = body.name
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** New group name */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body = Body(name, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            name()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (name.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                name == other.name &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(name, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Body{name=$name, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupUpdateParams &&
+            groupId == other.groupId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "GroupUpdateParams{groupId=$groupId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
new file mode 100644
index 0000000..8885adf
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
@@ -0,0 +1,997 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class GroupUpdateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatGuid: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val groupId: JsonField<String>,
+    private val iconUrl: JsonField<String>,
+    private val lastMessageDirection: JsonField<Group.LastMessageDirection>,
+    private val lastMessageText: JsonField<String>,
+    private val lastMessageTime: JsonField<Long>,
+    private val memberCount: JsonField<Long>,
+    private val messageCount: JsonField<Long>,
+    private val name: JsonField<String>,
+    private val deviceSync: JsonField<DeviceSync>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_guid") @ExcludeMissing chatGuid: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("icon_url") @ExcludeMissing iconUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_direction")
+        @ExcludeMissing
+        lastMessageDirection: JsonField<Group.LastMessageDirection> = JsonMissing.of(),
+        @JsonProperty("last_message_text")
+        @ExcludeMissing
+        lastMessageText: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_message_time")
+        @ExcludeMissing
+        lastMessageTime: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("member_count")
+        @ExcludeMissing
+        memberCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("message_count")
+        @ExcludeMissing
+        messageCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("device_sync")
+        @ExcludeMissing
+        deviceSync: JsonField<DeviceSync> = JsonMissing.of(),
+    ) : this(
+        chatGuid,
+        createdAt,
+        groupId,
+        iconUrl,
+        lastMessageDirection,
+        lastMessageText,
+        lastMessageTime,
+        memberCount,
+        messageCount,
+        name,
+        deviceSync,
+        mutableMapOf(),
+    )
+
+    fun toGroup(): Group =
+        Group.builder()
+            .chatGuid(chatGuid)
+            .createdAt(createdAt)
+            .groupId(groupId)
+            .iconUrl(iconUrl)
+            .lastMessageDirection(lastMessageDirection)
+            .lastMessageText(lastMessageText)
+            .lastMessageTime(lastMessageTime)
+            .memberCount(memberCount)
+            .messageCount(messageCount)
+            .name(name)
+            .build()
+
+    /**
+     * BlueBubbles chat GUID if linked to a device group chat
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * URL of the group icon/photo
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun iconUrl(): Optional<String> = iconUrl.getOptional("icon_url")
+
+    /**
+     * Direction of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageDirection(): Optional<Group.LastMessageDirection> =
+        lastMessageDirection.getOptional("last_message_direction")
+
+    /**
+     * Text of the most recent message in the group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageText(): Optional<String> = lastMessageText.getOptional("last_message_text")
+
+    /**
+     * Timestamp of the most recent message
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastMessageTime(): Optional<Long> = lastMessageTime.getOptional("last_message_time")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun memberCount(): Optional<Long> = memberCount.getOptional("member_count")
+
+    /**
+     * Total number of messages in this group
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun messageCount(): Optional<Long> = messageCount.getOptional("message_count")
+
+    /**
+     * Group name. Null for unnamed groups.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * Result of syncing the operation to a linked iMessage chat
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deviceSync(): Optional<DeviceSync> = deviceSync.getOptional("device_sync")
+
+    /**
+     * Returns the raw JSON value of [chatGuid].
+     *
+     * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [iconUrl].
+     *
+     * Unlike [iconUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("icon_url") @ExcludeMissing fun _iconUrl(): JsonField<String> = iconUrl
+
+    /**
+     * Returns the raw JSON value of [lastMessageDirection].
+     *
+     * Unlike [lastMessageDirection], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("last_message_direction")
+    @ExcludeMissing
+    fun _lastMessageDirection(): JsonField<Group.LastMessageDirection> = lastMessageDirection
+
+    /**
+     * Returns the raw JSON value of [lastMessageText].
+     *
+     * Unlike [lastMessageText], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_text")
+    @ExcludeMissing
+    fun _lastMessageText(): JsonField<String> = lastMessageText
+
+    /**
+     * Returns the raw JSON value of [lastMessageTime].
+     *
+     * Unlike [lastMessageTime], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_message_time")
+    @ExcludeMissing
+    fun _lastMessageTime(): JsonField<Long> = lastMessageTime
+
+    /**
+     * Returns the raw JSON value of [memberCount].
+     *
+     * Unlike [memberCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("member_count") @ExcludeMissing fun _memberCount(): JsonField<Long> = memberCount
+
+    /**
+     * Returns the raw JSON value of [messageCount].
+     *
+     * Unlike [messageCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message_count")
+    @ExcludeMissing
+    fun _messageCount(): JsonField<Long> = messageCount
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [deviceSync].
+     *
+     * Unlike [deviceSync], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("device_sync")
+    @ExcludeMissing
+    fun _deviceSync(): JsonField<DeviceSync> = deviceSync
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupUpdateResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupUpdateResponse]. */
+    class Builder internal constructor() {
+
+        private var chatGuid: JsonField<String> = JsonMissing.of()
+        private var createdAt: JsonField<Long> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var iconUrl: JsonField<String> = JsonMissing.of()
+        private var lastMessageDirection: JsonField<Group.LastMessageDirection> = JsonMissing.of()
+        private var lastMessageText: JsonField<String> = JsonMissing.of()
+        private var lastMessageTime: JsonField<Long> = JsonMissing.of()
+        private var memberCount: JsonField<Long> = JsonMissing.of()
+        private var messageCount: JsonField<Long> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var deviceSync: JsonField<DeviceSync> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupUpdateResponse: GroupUpdateResponse) = apply {
+            chatGuid = groupUpdateResponse.chatGuid
+            createdAt = groupUpdateResponse.createdAt
+            groupId = groupUpdateResponse.groupId
+            iconUrl = groupUpdateResponse.iconUrl
+            lastMessageDirection = groupUpdateResponse.lastMessageDirection
+            lastMessageText = groupUpdateResponse.lastMessageText
+            lastMessageTime = groupUpdateResponse.lastMessageTime
+            memberCount = groupUpdateResponse.memberCount
+            messageCount = groupUpdateResponse.messageCount
+            name = groupUpdateResponse.name
+            deviceSync = groupUpdateResponse.deviceSync
+            additionalProperties = groupUpdateResponse.additionalProperties.toMutableMap()
+        }
+
+        /** BlueBubbles chat GUID if linked to a device group chat */
+        fun chatGuid(chatGuid: String?) = chatGuid(JsonField.ofNullable(chatGuid))
+
+        /** Alias for calling [Builder.chatGuid] with `chatGuid.orElse(null)`. */
+        fun chatGuid(chatGuid: Optional<String>) = chatGuid(chatGuid.getOrNull())
+
+        /**
+         * Sets [Builder.chatGuid] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatGuid] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** URL of the group icon/photo */
+        fun iconUrl(iconUrl: String?) = iconUrl(JsonField.ofNullable(iconUrl))
+
+        /** Alias for calling [Builder.iconUrl] with `iconUrl.orElse(null)`. */
+        fun iconUrl(iconUrl: Optional<String>) = iconUrl(iconUrl.getOrNull())
+
+        /**
+         * Sets [Builder.iconUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.iconUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun iconUrl(iconUrl: JsonField<String>) = apply { this.iconUrl = iconUrl }
+
+        /** Direction of the most recent message */
+        fun lastMessageDirection(lastMessageDirection: Group.LastMessageDirection?) =
+            lastMessageDirection(JsonField.ofNullable(lastMessageDirection))
+
+        /**
+         * Alias for calling [Builder.lastMessageDirection] with
+         * `lastMessageDirection.orElse(null)`.
+         */
+        fun lastMessageDirection(lastMessageDirection: Optional<Group.LastMessageDirection>) =
+            lastMessageDirection(lastMessageDirection.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageDirection] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageDirection] with a well-typed
+         * [Group.LastMessageDirection] value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun lastMessageDirection(lastMessageDirection: JsonField<Group.LastMessageDirection>) =
+            apply {
+                this.lastMessageDirection = lastMessageDirection
+            }
+
+        /** Text of the most recent message in the group */
+        fun lastMessageText(lastMessageText: String?) =
+            lastMessageText(JsonField.ofNullable(lastMessageText))
+
+        /** Alias for calling [Builder.lastMessageText] with `lastMessageText.orElse(null)`. */
+        fun lastMessageText(lastMessageText: Optional<String>) =
+            lastMessageText(lastMessageText.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageText] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageText] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun lastMessageText(lastMessageText: JsonField<String>) = apply {
+            this.lastMessageText = lastMessageText
+        }
+
+        /** Timestamp of the most recent message */
+        fun lastMessageTime(lastMessageTime: Long?) =
+            lastMessageTime(JsonField.ofNullable(lastMessageTime))
+
+        /**
+         * Alias for [Builder.lastMessageTime].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastMessageTime(lastMessageTime: Long) = lastMessageTime(lastMessageTime as Long?)
+
+        /** Alias for calling [Builder.lastMessageTime] with `lastMessageTime.orElse(null)`. */
+        fun lastMessageTime(lastMessageTime: Optional<Long>) =
+            lastMessageTime(lastMessageTime.getOrNull())
+
+        /**
+         * Sets [Builder.lastMessageTime] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastMessageTime] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastMessageTime(lastMessageTime: JsonField<Long>) = apply {
+            this.lastMessageTime = lastMessageTime
+        }
+
+        fun memberCount(memberCount: Long) = memberCount(JsonField.of(memberCount))
+
+        /**
+         * Sets [Builder.memberCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.memberCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun memberCount(memberCount: JsonField<Long>) = apply { this.memberCount = memberCount }
+
+        /** Total number of messages in this group */
+        fun messageCount(messageCount: Long) = messageCount(JsonField.of(messageCount))
+
+        /**
+         * Sets [Builder.messageCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.messageCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun messageCount(messageCount: JsonField<Long>) = apply { this.messageCount = messageCount }
+
+        /** Group name. Null for unnamed groups. */
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** Result of syncing the operation to a linked iMessage chat */
+        fun deviceSync(deviceSync: DeviceSync) = deviceSync(JsonField.of(deviceSync))
+
+        /**
+         * Sets [Builder.deviceSync] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deviceSync] with a well-typed [DeviceSync] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun deviceSync(deviceSync: JsonField<DeviceSync>) = apply { this.deviceSync = deviceSync }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupUpdateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupUpdateResponse =
+            GroupUpdateResponse(
+                chatGuid,
+                createdAt,
+                groupId,
+                iconUrl,
+                lastMessageDirection,
+                lastMessageText,
+                lastMessageTime,
+                memberCount,
+                messageCount,
+                name,
+                deviceSync,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupUpdateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatGuid()
+        createdAt()
+        groupId()
+        iconUrl()
+        lastMessageDirection().ifPresent { it.validate() }
+        lastMessageText()
+        lastMessageTime()
+        memberCount()
+        messageCount()
+        name()
+        deviceSync().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatGuid.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (iconUrl.asKnown().isPresent) 1 else 0) +
+            (lastMessageDirection.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (lastMessageText.asKnown().isPresent) 1 else 0) +
+            (if (lastMessageTime.asKnown().isPresent) 1 else 0) +
+            (if (memberCount.asKnown().isPresent) 1 else 0) +
+            (if (messageCount.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (deviceSync.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Result of syncing the operation to a linked iMessage chat */
+    class DeviceSync
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val action: JsonField<Action>,
+        private val chatGuid: JsonField<String>,
+        private val error: JsonField<String>,
+        private val synced: JsonField<Boolean>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("chat_guid")
+            @ExcludeMissing
+            chatGuid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("synced") @ExcludeMissing synced: JsonField<Boolean> = JsonMissing.of(),
+        ) : this(action, chatGuid, error, synced, mutableMapOf())
+
+        /**
+         * The action that was performed for the linked chat
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun action(): Optional<Action> = action.getOptional("action")
+
+        /**
+         * The linked iMessage chat GUID
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+        /**
+         * Error message if sync failed
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * Whether the sync was successful
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun synced(): Optional<Boolean> = synced.getOptional("synced")
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [chatGuid].
+         *
+         * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [synced].
+         *
+         * Unlike [synced], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("synced") @ExcludeMissing fun _synced(): JsonField<Boolean> = synced
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [DeviceSync]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [DeviceSync]. */
+        class Builder internal constructor() {
+
+            private var action: JsonField<Action> = JsonMissing.of()
+            private var chatGuid: JsonField<String> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var synced: JsonField<Boolean> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(deviceSync: DeviceSync) = apply {
+                action = deviceSync.action
+                chatGuid = deviceSync.chatGuid
+                error = deviceSync.error
+                synced = deviceSync.synced
+                additionalProperties = deviceSync.additionalProperties.toMutableMap()
+            }
+
+            /** The action that was performed for the linked chat */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The linked iMessage chat GUID */
+            fun chatGuid(chatGuid: String) = chatGuid(JsonField.of(chatGuid))
+
+            /**
+             * Sets [Builder.chatGuid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.chatGuid] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+            /** Error message if sync failed */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            /** Whether the sync was successful */
+            fun synced(synced: Boolean) = synced(JsonField.of(synced))
+
+            /**
+             * Sets [Builder.synced] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.synced] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun synced(synced: JsonField<Boolean>) = apply { this.synced = synced }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [DeviceSync].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): DeviceSync =
+                DeviceSync(action, chatGuid, error, synced, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): DeviceSync = apply {
+            if (validated) {
+                return@apply
+            }
+
+            action().ifPresent { it.validate() }
+            chatGuid()
+            error()
+            synced()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (chatGuid.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (synced.asKnown().isPresent) 1 else 0)
+
+        /** The action that was performed for the linked chat */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val ADD_PARTICIPANT = of("add_participant")
+
+                @JvmField val REMOVE_PARTICIPANT = of("remove_participant")
+
+                @JvmField val LEAVE = of("leave")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                ADD_PARTICIPANT,
+                REMOVE_PARTICIPANT,
+                LEAVE,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                ADD_PARTICIPANT,
+                REMOVE_PARTICIPANT,
+                LEAVE,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    ADD_PARTICIPANT -> Value.ADD_PARTICIPANT
+                    REMOVE_PARTICIPANT -> Value.REMOVE_PARTICIPANT
+                    LEAVE -> Value.LEAVE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    ADD_PARTICIPANT -> Known.ADD_PARTICIPANT
+                    REMOVE_PARTICIPANT -> Known.REMOVE_PARTICIPANT
+                    LEAVE -> Known.LEAVE
+                    else -> throw BlooioInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is DeviceSync &&
+                action == other.action &&
+                chatGuid == other.chatGuid &&
+                error == other.error &&
+                synced == other.synced &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(action, chatGuid, error, synced, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "DeviceSync{action=$action, chatGuid=$chatGuid, error=$error, synced=$synced, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupUpdateResponse &&
+            chatGuid == other.chatGuid &&
+            createdAt == other.createdAt &&
+            groupId == other.groupId &&
+            iconUrl == other.iconUrl &&
+            lastMessageDirection == other.lastMessageDirection &&
+            lastMessageText == other.lastMessageText &&
+            lastMessageTime == other.lastMessageTime &&
+            memberCount == other.memberCount &&
+            messageCount == other.messageCount &&
+            name == other.name &&
+            deviceSync == other.deviceSync &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            chatGuid,
+            createdAt,
+            groupId,
+            iconUrl,
+            lastMessageDirection,
+            lastMessageText,
+            lastMessageTime,
+            memberCount,
+            messageCount,
+            name,
+            deviceSync,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupUpdateResponse{chatGuid=$chatGuid, createdAt=$createdAt, groupId=$groupId, iconUrl=$iconUrl, lastMessageDirection=$lastMessageDirection, lastMessageText=$lastMessageText, lastMessageTime=$lastMessageTime, memberCount=$memberCount, messageCount=$messageCount, name=$name, deviceSync=$deviceSync, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
new file mode 100644
index 0000000..7afcfc0
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
@@ -0,0 +1,549 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.icon
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Response for group icon operations */
+class GroupIcon
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val chatGuid: JsonField<String>,
+    private val deviceSync: JsonField<DeviceSync>,
+    private val groupId: JsonField<String>,
+    private val iconUrl: JsonField<String>,
+    private val message: JsonField<String>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("chat_guid") @ExcludeMissing chatGuid: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("device_sync")
+        @ExcludeMissing
+        deviceSync: JsonField<DeviceSync> = JsonMissing.of(),
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("icon_url") @ExcludeMissing iconUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(chatGuid, deviceSync, groupId, iconUrl, message, success, mutableMapOf())
+
+    /**
+     * The BlueBubbles chat GUID
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+    /**
+     * Linked chat sync status
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deviceSync(): Optional<DeviceSync> = deviceSync.getOptional("device_sync")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * URL of the uploaded icon (only present on set)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun iconUrl(): Optional<String> = iconUrl.getOptional("icon_url")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun message(): Optional<String> = message.getOptional("message")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [chatGuid].
+     *
+     * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+    /**
+     * Returns the raw JSON value of [deviceSync].
+     *
+     * Unlike [deviceSync], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("device_sync")
+    @ExcludeMissing
+    fun _deviceSync(): JsonField<DeviceSync> = deviceSync
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [iconUrl].
+     *
+     * Unlike [iconUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("icon_url") @ExcludeMissing fun _iconUrl(): JsonField<String> = iconUrl
+
+    /**
+     * Returns the raw JSON value of [message].
+     *
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupIcon]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupIcon]. */
+    class Builder internal constructor() {
+
+        private var chatGuid: JsonField<String> = JsonMissing.of()
+        private var deviceSync: JsonField<DeviceSync> = JsonMissing.of()
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var iconUrl: JsonField<String> = JsonMissing.of()
+        private var message: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupIcon: GroupIcon) = apply {
+            chatGuid = groupIcon.chatGuid
+            deviceSync = groupIcon.deviceSync
+            groupId = groupIcon.groupId
+            iconUrl = groupIcon.iconUrl
+            message = groupIcon.message
+            success = groupIcon.success
+            additionalProperties = groupIcon.additionalProperties.toMutableMap()
+        }
+
+        /** The BlueBubbles chat GUID */
+        fun chatGuid(chatGuid: String) = chatGuid(JsonField.of(chatGuid))
+
+        /**
+         * Sets [Builder.chatGuid] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.chatGuid] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+        /** Linked chat sync status */
+        fun deviceSync(deviceSync: DeviceSync) = deviceSync(JsonField.of(deviceSync))
+
+        /**
+         * Sets [Builder.deviceSync] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deviceSync] with a well-typed [DeviceSync] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun deviceSync(deviceSync: JsonField<DeviceSync>) = apply { this.deviceSync = deviceSync }
+
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** URL of the uploaded icon (only present on set) */
+        fun iconUrl(iconUrl: String) = iconUrl(JsonField.of(iconUrl))
+
+        /**
+         * Sets [Builder.iconUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.iconUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun iconUrl(iconUrl: JsonField<String>) = apply { this.iconUrl = iconUrl }
+
+        fun message(message: String) = message(JsonField.of(message))
+
+        /**
+         * Sets [Builder.message] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun message(message: JsonField<String>) = apply { this.message = message }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupIcon].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupIcon =
+            GroupIcon(
+                chatGuid,
+                deviceSync,
+                groupId,
+                iconUrl,
+                message,
+                success,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupIcon = apply {
+        if (validated) {
+            return@apply
+        }
+
+        chatGuid()
+        deviceSync().ifPresent { it.validate() }
+        groupId()
+        iconUrl()
+        message()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (chatGuid.asKnown().isPresent) 1 else 0) +
+            (deviceSync.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (iconUrl.asKnown().isPresent) 1 else 0) +
+            (if (message.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    /** Linked chat sync status */
+    class DeviceSync
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val chatGuid: JsonField<String>,
+        private val message: JsonField<String>,
+        private val synced: JsonField<Boolean>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("chat_guid")
+            @ExcludeMissing
+            chatGuid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("synced") @ExcludeMissing synced: JsonField<Boolean> = JsonMissing.of(),
+        ) : this(chatGuid, message, synced, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun chatGuid(): Optional<String> = chatGuid.getOptional("chat_guid")
+
+        /**
+         * Status message about linked chat sync
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun message(): Optional<String> = message.getOptional("message")
+
+        /**
+         * Whether the icon change was synced to the linked iMessage chat. This will be true on
+         * successful set/remove operations.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun synced(): Optional<Boolean> = synced.getOptional("synced")
+
+        /**
+         * Returns the raw JSON value of [chatGuid].
+         *
+         * Unlike [chatGuid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("chat_guid") @ExcludeMissing fun _chatGuid(): JsonField<String> = chatGuid
+
+        /**
+         * Returns the raw JSON value of [message].
+         *
+         * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+        /**
+         * Returns the raw JSON value of [synced].
+         *
+         * Unlike [synced], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("synced") @ExcludeMissing fun _synced(): JsonField<Boolean> = synced
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [DeviceSync]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [DeviceSync]. */
+        class Builder internal constructor() {
+
+            private var chatGuid: JsonField<String> = JsonMissing.of()
+            private var message: JsonField<String> = JsonMissing.of()
+            private var synced: JsonField<Boolean> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(deviceSync: DeviceSync) = apply {
+                chatGuid = deviceSync.chatGuid
+                message = deviceSync.message
+                synced = deviceSync.synced
+                additionalProperties = deviceSync.additionalProperties.toMutableMap()
+            }
+
+            fun chatGuid(chatGuid: String) = chatGuid(JsonField.of(chatGuid))
+
+            /**
+             * Sets [Builder.chatGuid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.chatGuid] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun chatGuid(chatGuid: JsonField<String>) = apply { this.chatGuid = chatGuid }
+
+            /** Status message about linked chat sync */
+            fun message(message: String) = message(JsonField.of(message))
+
+            /**
+             * Sets [Builder.message] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.message] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun message(message: JsonField<String>) = apply { this.message = message }
+
+            /**
+             * Whether the icon change was synced to the linked iMessage chat. This will be true on
+             * successful set/remove operations.
+             */
+            fun synced(synced: Boolean) = synced(JsonField.of(synced))
+
+            /**
+             * Sets [Builder.synced] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.synced] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun synced(synced: JsonField<Boolean>) = apply { this.synced = synced }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [DeviceSync].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): DeviceSync =
+                DeviceSync(chatGuid, message, synced, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): DeviceSync = apply {
+            if (validated) {
+                return@apply
+            }
+
+            chatGuid()
+            message()
+            synced()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (chatGuid.asKnown().isPresent) 1 else 0) +
+                (if (message.asKnown().isPresent) 1 else 0) +
+                (if (synced.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is DeviceSync &&
+                chatGuid == other.chatGuid &&
+                message == other.message &&
+                synced == other.synced &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(chatGuid, message, synced, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "DeviceSync{chatGuid=$chatGuid, message=$message, synced=$synced, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupIcon &&
+            chatGuid == other.chatGuid &&
+            deviceSync == other.deviceSync &&
+            groupId == other.groupId &&
+            iconUrl == other.iconUrl &&
+            message == other.message &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(chatGuid, deviceSync, groupId, iconUrl, message, success, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupIcon{chatGuid=$chatGuid, deviceSync=$deviceSync, groupId=$groupId, iconUrl=$iconUrl, message=$message, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconRemoveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconRemoveParams.kt
new file mode 100644
index 0000000..cb40116
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconRemoveParams.kt
@@ -0,0 +1,234 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.icon
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Remove the group icon/photo. Requires the group to have a linked chat_guid.
+ *
+ * The icon is removed from both Blooio storage and the linked iMessage chat before the request
+ * returns.
+ */
+class IconRemoveParams
+private constructor(
+    private val groupId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): IconRemoveParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [IconRemoveParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [IconRemoveParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(iconRemoveParams: IconRemoveParams) = apply {
+            groupId = iconRemoveParams.groupId
+            additionalHeaders = iconRemoveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = iconRemoveParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = iconRemoveParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [IconRemoveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): IconRemoveParams =
+            IconRemoveParams(
+                groupId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is IconRemoveParams &&
+            groupId == other.groupId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "IconRemoveParams{groupId=$groupId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
new file mode 100644
index 0000000..0c6da27
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
@@ -0,0 +1,452 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.icon
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.MultipartField
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.io.InputStream
+import java.nio.file.Path
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.io.path.inputStream
+import kotlin.io.path.name
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Set the group icon/photo. Requires the group to have a linked chat_guid. Uses
+ * multipart/form-data.
+ *
+ * The uploaded image is stored in Blooio storage and synced to the linked iMessage chat before the
+ * request returns.
+ */
+class IconSetParams
+private constructor(
+    private val groupId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /**
+     * The icon image file to set as the group photo
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun icon(): InputStream = body.icon()
+
+    /**
+     * Returns the raw multipart value of [icon].
+     *
+     * Unlike [icon], this method doesn't throw if the multipart field has an unexpected type.
+     */
+    fun _icon(): MultipartField<InputStream> = body._icon()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [IconSetParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .icon()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [IconSetParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(iconSetParams: IconSetParams) = apply {
+            groupId = iconSetParams.groupId
+            body = iconSetParams.body.toBuilder()
+            additionalHeaders = iconSetParams.additionalHeaders.toBuilder()
+            additionalQueryParams = iconSetParams.additionalQueryParams.toBuilder()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [icon]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** The icon image file to set as the group photo */
+        fun icon(icon: InputStream) = apply { body.icon(icon) }
+
+        /**
+         * Sets [Builder.icon] to an arbitrary multipart value.
+         *
+         * You should usually call [Builder.icon] with a well-typed [InputStream] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun icon(icon: MultipartField<InputStream>) = apply { body.icon(icon) }
+
+        /** The icon image file to set as the group photo */
+        fun icon(icon: ByteArray) = apply { body.icon(icon) }
+
+        /** The icon image file to set as the group photo */
+        fun icon(path: Path) = apply { body.icon(path) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [IconSetParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .icon()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): IconSetParams =
+            IconSetParams(
+                groupId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Map<String, MultipartField<*>> =
+        (mapOf("icon" to _icon()) +
+                _additionalBodyProperties().mapValues { (_, value) -> MultipartField.of(value) })
+            .toImmutable()
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    private constructor(
+        private val icon: MultipartField<InputStream>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        /**
+         * The icon image file to set as the group photo
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun icon(): InputStream = icon.value.getRequired("icon")
+
+        /**
+         * Returns the raw multipart value of [icon].
+         *
+         * Unlike [icon], this method doesn't throw if the multipart field has an unexpected type.
+         */
+        @JsonProperty("icon") @ExcludeMissing fun _icon(): MultipartField<InputStream> = icon
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .icon()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var icon: MultipartField<InputStream>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                icon = body.icon
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** The icon image file to set as the group photo */
+            fun icon(icon: InputStream) = icon(MultipartField.of(icon))
+
+            /**
+             * Sets [Builder.icon] to an arbitrary multipart value.
+             *
+             * You should usually call [Builder.icon] with a well-typed [InputStream] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun icon(icon: MultipartField<InputStream>) = apply { this.icon = icon }
+
+            /** The icon image file to set as the group photo */
+            fun icon(icon: ByteArray) = icon(icon.inputStream())
+
+            /** The icon image file to set as the group photo */
+            fun icon(path: Path) =
+                icon(
+                    MultipartField.builder<InputStream>()
+                        .value(path.inputStream())
+                        .filename(path.name)
+                        .build()
+                )
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .icon()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(checkRequired("icon", icon), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            icon()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                icon == other.icon &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(icon, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Body{icon=$icon, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is IconSetParams &&
+            groupId == other.groupId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "IconSetParams{groupId=$groupId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
new file mode 100644
index 0000000..ea64df7
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
@@ -0,0 +1,295 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class GroupMember
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val addedAt: JsonField<Long>,
+    private val contactId: JsonField<String>,
+    private val identifier: JsonField<String>,
+    private val name: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("added_at") @ExcludeMissing addedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("contact_id") @ExcludeMissing contactId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("identifier")
+        @ExcludeMissing
+        identifier: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+    ) : this(id, addedAt, contactId, identifier, name, mutableMapOf())
+
+    /**
+     * Contact identifier (phone or email)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun addedAt(): Optional<Long> = addedAt.getOptional("added_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [addedAt].
+     *
+     * Unlike [addedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("added_at") @ExcludeMissing fun _addedAt(): JsonField<Long> = addedAt
+
+    /**
+     * Returns the raw JSON value of [contactId].
+     *
+     * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("contact_id") @ExcludeMissing fun _contactId(): JsonField<String> = contactId
+
+    /**
+     * Returns the raw JSON value of [identifier].
+     *
+     * Unlike [identifier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("identifier") @ExcludeMissing fun _identifier(): JsonField<String> = identifier
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [GroupMember]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [GroupMember]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String> = JsonMissing.of()
+        private var addedAt: JsonField<Long> = JsonMissing.of()
+        private var contactId: JsonField<String> = JsonMissing.of()
+        private var identifier: JsonField<String> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(groupMember: GroupMember) = apply {
+            id = groupMember.id
+            addedAt = groupMember.addedAt
+            contactId = groupMember.contactId
+            identifier = groupMember.identifier
+            name = groupMember.name
+            additionalProperties = groupMember.additionalProperties.toMutableMap()
+        }
+
+        /** Contact identifier (phone or email) */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        fun addedAt(addedAt: Long) = addedAt(JsonField.of(addedAt))
+
+        /**
+         * Sets [Builder.addedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.addedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun addedAt(addedAt: JsonField<Long>) = apply { this.addedAt = addedAt }
+
+        fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+        /**
+         * Sets [Builder.contactId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+        fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+        /**
+         * Sets [Builder.identifier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.identifier] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun identifier(identifier: JsonField<String>) = apply { this.identifier = identifier }
+
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [GroupMember].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): GroupMember =
+            GroupMember(
+                id,
+                addedAt,
+                contactId,
+                identifier,
+                name,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): GroupMember = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        addedAt()
+        contactId()
+        identifier()
+        name()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (addedAt.asKnown().isPresent) 1 else 0) +
+            (if (contactId.asKnown().isPresent) 1 else 0) +
+            (if (identifier.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is GroupMember &&
+            id == other.id &&
+            addedAt == other.addedAt &&
+            contactId == other.contactId &&
+            identifier == other.identifier &&
+            name == other.name &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, addedAt, contactId, identifier, name, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "GroupMember{id=$id, addedAt=$addedAt, contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
new file mode 100644
index 0000000..e2e1b1e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
@@ -0,0 +1,444 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+ *
+ * Add an existing contact to a group. If the group is linked to an existing iMessage chat, also
+ * adds the participant to that chat.
+ */
+class MemberAddParams
+private constructor(
+    private val groupId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /**
+     * Contact identifier (phone number or email)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contactId(): String = body.contactId()
+
+    /**
+     * Returns the raw JSON value of [contactId].
+     *
+     * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _contactId(): JsonField<String> = body._contactId()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [MemberAddParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .contactId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MemberAddParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(memberAddParams: MemberAddParams) = apply {
+            groupId = memberAddParams.groupId
+            body = memberAddParams.body.toBuilder()
+            additionalHeaders = memberAddParams.additionalHeaders.toBuilder()
+            additionalQueryParams = memberAddParams.additionalQueryParams.toBuilder()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [contactId]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Contact identifier (phone number or email) */
+        fun contactId(contactId: String) = apply { body.contactId(contactId) }
+
+        /**
+         * Sets [Builder.contactId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contactId(contactId: JsonField<String>) = apply { body.contactId(contactId) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [MemberAddParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contactId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): MemberAddParams =
+            MemberAddParams(
+                groupId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val contactId: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("contact_id")
+            @ExcludeMissing
+            contactId: JsonField<String> = JsonMissing.of()
+        ) : this(contactId, mutableMapOf())
+
+        /**
+         * Contact identifier (phone number or email)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun contactId(): String = contactId.getRequired("contact_id")
+
+        /**
+         * Returns the raw JSON value of [contactId].
+         *
+         * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("contact_id") @ExcludeMissing fun _contactId(): JsonField<String> = contactId
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .contactId()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var contactId: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                contactId = body.contactId
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Contact identifier (phone number or email) */
+            fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+            /**
+             * Sets [Builder.contactId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contactId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun contactId(contactId: JsonField<String>) = apply { this.contactId = contactId }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .contactId()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(checkRequired("contactId", contactId), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            contactId()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (contactId.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                contactId == other.contactId &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(contactId, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{contactId=$contactId, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MemberAddParams &&
+            groupId == other.groupId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "MemberAddParams{groupId=$groupId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
similarity index 56%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendResponse.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
index 5c8a7a5..5f93257 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.groups.members
 
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
@@ -14,46 +14,47 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
-class MessageSendResponse
+class MemberAddResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
-    private val messageId: JsonField<String>,
-    private val status: JsonField<String>,
+    private val member: JsonField<GroupMember>,
+    private val message: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("status") @ExcludeMissing status: JsonField<String> = JsonMissing.of(),
-    ) : this(messageId, status, mutableMapOf())
+        @JsonProperty("member") @ExcludeMissing member: JsonField<GroupMember> = JsonMissing.of(),
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+    ) : this(member, message, mutableMapOf())
 
     /**
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun messageId(): Optional<String> = messageId.getOptional("message_id")
+    fun member(): Optional<GroupMember> = member.getOptional("member")
 
     /**
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun status(): Optional<String> = status.getOptional("status")
+    fun message(): Optional<String> = message.getOptional("message")
 
     /**
-     * Returns the raw JSON value of [messageId].
+     * Returns the raw JSON value of [member].
      *
-     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [member], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+    @JsonProperty("member") @ExcludeMissing fun _member(): JsonField<GroupMember> = member
 
     /**
-     * Returns the raw JSON value of [status].
+     * Returns the raw JSON value of [message].
      *
-     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<String> = status
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
 
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -69,44 +70,44 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [MessageSendResponse]. */
+        /** Returns a mutable builder for constructing an instance of [MemberAddResponse]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [MessageSendResponse]. */
+    /** A builder for [MemberAddResponse]. */
     class Builder internal constructor() {
 
-        private var messageId: JsonField<String> = JsonMissing.of()
-        private var status: JsonField<String> = JsonMissing.of()
+        private var member: JsonField<GroupMember> = JsonMissing.of()
+        private var message: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(messageSendResponse: MessageSendResponse) = apply {
-            messageId = messageSendResponse.messageId
-            status = messageSendResponse.status
-            additionalProperties = messageSendResponse.additionalProperties.toMutableMap()
+        internal fun from(memberAddResponse: MemberAddResponse) = apply {
+            member = memberAddResponse.member
+            message = memberAddResponse.message
+            additionalProperties = memberAddResponse.additionalProperties.toMutableMap()
         }
 
-        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+        fun member(member: GroupMember) = member(JsonField.of(member))
 
         /**
-         * Sets [Builder.messageId] to an arbitrary JSON value.
+         * Sets [Builder.member] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+         * You should usually call [Builder.member] with a well-typed [GroupMember] value instead.
          * This method is primarily for setting the field to an undocumented or not yet supported
          * value.
          */
-        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+        fun member(member: JsonField<GroupMember>) = apply { this.member = member }
 
-        fun status(status: String) = status(JsonField.of(status))
+        fun message(message: String) = message(JsonField.of(message))
 
         /**
-         * Sets [Builder.status] to an arbitrary JSON value.
+         * Sets [Builder.message] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.status] with a well-typed [String] value instead. This
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun status(status: JsonField<String>) = apply { this.status = status }
+        fun message(message: JsonField<String>) = apply { this.message = message }
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -128,23 +129,23 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [MessageSendResponse].
+         * Returns an immutable instance of [MemberAddResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): MessageSendResponse =
-            MessageSendResponse(messageId, status, additionalProperties.toMutableMap())
+        fun build(): MemberAddResponse =
+            MemberAddResponse(member, message, additionalProperties.toMutableMap())
     }
 
     private var validated: Boolean = false
 
-    fun validate(): MessageSendResponse = apply {
+    fun validate(): MemberAddResponse = apply {
         if (validated) {
             return@apply
         }
 
-        messageId()
-        status()
+        member().ifPresent { it.validate() }
+        message()
         validated = true
     }
 
@@ -163,23 +164,24 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (if (messageId.asKnown().isPresent) 1 else 0) + (if (status.asKnown().isPresent) 1 else 0)
+        (member.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (message.asKnown().isPresent) 1 else 0)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
         }
 
-        return other is MessageSendResponse &&
-            messageId == other.messageId &&
-            status == other.status &&
+        return other is MemberAddResponse &&
+            member == other.member &&
+            message == other.message &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(messageId, status, additionalProperties) }
+    private val hashCode: Int by lazy { Objects.hash(member, message, additionalProperties) }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageSendResponse{messageId=$messageId, status=$status, additionalProperties=$additionalProperties}"
+        "MemberAddResponse{member=$member, message=$message, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
new file mode 100644
index 0000000..7bf365a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
@@ -0,0 +1,243 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List all members of a group. */
+class MemberListParams
+private constructor(
+    private val groupId: String?,
+    private val limit: Long?,
+    private val offset: Long?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun groupId(): Optional<String> = Optional.ofNullable(groupId)
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): MemberListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [MemberListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MemberListParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var limit: Long? = null
+        private var offset: Long? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(memberListParams: MemberListParams) = apply {
+            groupId = memberListParams.groupId
+            limit = memberListParams.limit
+            offset = memberListParams.offset
+            additionalHeaders = memberListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = memberListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun groupId(groupId: String?) = apply { this.groupId = groupId }
+
+        /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+        fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [MemberListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MemberListParams =
+            MemberListParams(
+                groupId,
+                limit,
+                offset,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                limit?.let { put("limit", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MemberListParams &&
+            groupId == other.groupId &&
+            limit == other.limit &&
+            offset == other.offset &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(groupId, limit, offset, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "MemberListParams{groupId=$groupId, limit=$limit, offset=$offset, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
new file mode 100644
index 0000000..2afb88b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
@@ -0,0 +1,326 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class MemberListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val groupId: JsonField<String>,
+    private val groupName: JsonField<String>,
+    private val iconUrl: JsonField<String>,
+    private val members: JsonField<List<GroupMember>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("group_name") @ExcludeMissing groupName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("icon_url") @ExcludeMissing iconUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("members")
+        @ExcludeMissing
+        members: JsonField<List<GroupMember>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(groupId, groupName, iconUrl, members, pagination, mutableMapOf())
+
+    /**
+     * The group ID
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+    /**
+     * The group name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun groupName(): Optional<String> = groupName.getOptional("group_name")
+
+    /**
+     * URL of the group icon/photo
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun iconUrl(): Optional<String> = iconUrl.getOptional("icon_url")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun members(): Optional<List<GroupMember>> = members.getOptional("members")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [groupId].
+     *
+     * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+    /**
+     * Returns the raw JSON value of [groupName].
+     *
+     * Unlike [groupName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("group_name") @ExcludeMissing fun _groupName(): JsonField<String> = groupName
+
+    /**
+     * Returns the raw JSON value of [iconUrl].
+     *
+     * Unlike [iconUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("icon_url") @ExcludeMissing fun _iconUrl(): JsonField<String> = iconUrl
+
+    /**
+     * Returns the raw JSON value of [members].
+     *
+     * Unlike [members], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("members") @ExcludeMissing fun _members(): JsonField<List<GroupMember>> = members
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MemberListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MemberListResponse]. */
+    class Builder internal constructor() {
+
+        private var groupId: JsonField<String> = JsonMissing.of()
+        private var groupName: JsonField<String> = JsonMissing.of()
+        private var iconUrl: JsonField<String> = JsonMissing.of()
+        private var members: JsonField<MutableList<GroupMember>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(memberListResponse: MemberListResponse) = apply {
+            groupId = memberListResponse.groupId
+            groupName = memberListResponse.groupName
+            iconUrl = memberListResponse.iconUrl
+            members = memberListResponse.members.map { it.toMutableList() }
+            pagination = memberListResponse.pagination
+            additionalProperties = memberListResponse.additionalProperties.toMutableMap()
+        }
+
+        /** The group ID */
+        fun groupId(groupId: String) = groupId(JsonField.of(groupId))
+
+        /**
+         * Sets [Builder.groupId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+        /** The group name */
+        fun groupName(groupName: String?) = groupName(JsonField.ofNullable(groupName))
+
+        /** Alias for calling [Builder.groupName] with `groupName.orElse(null)`. */
+        fun groupName(groupName: Optional<String>) = groupName(groupName.getOrNull())
+
+        /**
+         * Sets [Builder.groupName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.groupName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun groupName(groupName: JsonField<String>) = apply { this.groupName = groupName }
+
+        /** URL of the group icon/photo */
+        fun iconUrl(iconUrl: String?) = iconUrl(JsonField.ofNullable(iconUrl))
+
+        /** Alias for calling [Builder.iconUrl] with `iconUrl.orElse(null)`. */
+        fun iconUrl(iconUrl: Optional<String>) = iconUrl(iconUrl.getOrNull())
+
+        /**
+         * Sets [Builder.iconUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.iconUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun iconUrl(iconUrl: JsonField<String>) = apply { this.iconUrl = iconUrl }
+
+        fun members(members: List<GroupMember>) = members(JsonField.of(members))
+
+        /**
+         * Sets [Builder.members] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.members] with a well-typed `List<GroupMember>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun members(members: JsonField<List<GroupMember>>) = apply {
+            this.members = members.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [GroupMember] to [members].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addMember(member: GroupMember) = apply {
+            members =
+                (members ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("members", it).add(member)
+                }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MemberListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MemberListResponse =
+            MemberListResponse(
+                groupId,
+                groupName,
+                iconUrl,
+                (members ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MemberListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        groupId()
+        groupName()
+        iconUrl()
+        members().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (groupId.asKnown().isPresent) 1 else 0) +
+            (if (groupName.asKnown().isPresent) 1 else 0) +
+            (if (iconUrl.asKnown().isPresent) 1 else 0) +
+            (members.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MemberListResponse &&
+            groupId == other.groupId &&
+            groupName == other.groupName &&
+            iconUrl == other.iconUrl &&
+            members == other.members &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(groupId, groupName, iconUrl, members, pagination, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MemberListResponse{groupId=$groupId, groupName=$groupName, iconUrl=$iconUrl, members=$members, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveParams.kt
new file mode 100644
index 0000000..7f449f6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveParams.kt
@@ -0,0 +1,264 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+ *
+ * Remove a contact from a group. If the group is linked to an existing iMessage chat, also removes
+ * the participant from that chat. If the contact being removed is the organization's own phone
+ * number, leaves the group chat instead.
+ */
+class MemberRemoveParams
+private constructor(
+    private val groupId: String,
+    private val contactId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun groupId(): String = groupId
+
+    fun contactId(): Optional<String> = Optional.ofNullable(contactId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [MemberRemoveParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .groupId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MemberRemoveParams]. */
+    class Builder internal constructor() {
+
+        private var groupId: String? = null
+        private var contactId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(memberRemoveParams: MemberRemoveParams) = apply {
+            groupId = memberRemoveParams.groupId
+            contactId = memberRemoveParams.contactId
+            additionalHeaders = memberRemoveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = memberRemoveParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = memberRemoveParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun groupId(groupId: String) = apply { this.groupId = groupId }
+
+        fun contactId(contactId: String?) = apply { this.contactId = contactId }
+
+        /** Alias for calling [Builder.contactId] with `contactId.orElse(null)`. */
+        fun contactId(contactId: Optional<String>) = contactId(contactId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MemberRemoveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .groupId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): MemberRemoveParams =
+            MemberRemoveParams(
+                checkRequired("groupId", groupId),
+                contactId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> groupId
+            1 -> contactId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MemberRemoveParams &&
+            groupId == other.groupId &&
+            contactId == other.contactId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            groupId,
+            contactId,
+            additionalHeaders,
+            additionalQueryParams,
+            additionalBodyProperties,
+        )
+
+    override fun toString() =
+        "MemberRemoveParams{groupId=$groupId, contactId=$contactId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
new file mode 100644
index 0000000..660e0ec
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
@@ -0,0 +1,184 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class MemberRemoveResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val removedAt: JsonField<Long>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("removed_at") @ExcludeMissing removedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(removedAt, success, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun removedAt(): Optional<Long> = removedAt.getOptional("removed_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [removedAt].
+     *
+     * Unlike [removedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("removed_at") @ExcludeMissing fun _removedAt(): JsonField<Long> = removedAt
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [MemberRemoveResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [MemberRemoveResponse]. */
+    class Builder internal constructor() {
+
+        private var removedAt: JsonField<Long> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(memberRemoveResponse: MemberRemoveResponse) = apply {
+            removedAt = memberRemoveResponse.removedAt
+            success = memberRemoveResponse.success
+            additionalProperties = memberRemoveResponse.additionalProperties.toMutableMap()
+        }
+
+        fun removedAt(removedAt: Long) = removedAt(JsonField.of(removedAt))
+
+        /**
+         * Sets [Builder.removedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.removedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun removedAt(removedAt: JsonField<Long>) = apply { this.removedAt = removedAt }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [MemberRemoveResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): MemberRemoveResponse =
+            MemberRemoveResponse(removedAt, success, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): MemberRemoveResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        removedAt()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (removedAt.asKnown().isPresent) 1 else 0) + (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is MemberRemoveResponse &&
+            removedAt == other.removedAt &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(removedAt, success, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "MemberRemoveResponse{removedAt=$removedAt, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListParams.kt
new file mode 100644
index 0000000..82005e7
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListParams.kt
@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+
+/**
+ * Returns cached FindMy contact locations available through your blooio account. Each entry
+ * includes the contact's handle (phone/email), coordinates, and last update time.
+ */
+class ContactListParams
+private constructor(
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ContactListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactListParams]. */
+    class Builder internal constructor() {
+
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactListParams: ContactListParams) = apply {
+            additionalHeaders = contactListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactListParams =
+            ContactListParams(additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactListParams &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactListParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
new file mode 100644
index 0000000..3b50b28
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
@@ -0,0 +1,180 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val friends: JsonField<List<ContactLocation>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("friends")
+        @ExcludeMissing
+        friends: JsonField<List<ContactLocation>> = JsonMissing.of()
+    ) : this(friends, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun friends(): Optional<List<ContactLocation>> = friends.getOptional("friends")
+
+    /**
+     * Returns the raw JSON value of [friends].
+     *
+     * Unlike [friends], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("friends")
+    @ExcludeMissing
+    fun _friends(): JsonField<List<ContactLocation>> = friends
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ContactListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactListResponse]. */
+    class Builder internal constructor() {
+
+        private var friends: JsonField<MutableList<ContactLocation>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactListResponse: ContactListResponse) = apply {
+            friends = contactListResponse.friends.map { it.toMutableList() }
+            additionalProperties = contactListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun friends(friends: List<ContactLocation>) = friends(JsonField.of(friends))
+
+        /**
+         * Sets [Builder.friends] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.friends] with a well-typed `List<ContactLocation>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun friends(friends: JsonField<List<ContactLocation>>) = apply {
+            this.friends = friends.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [ContactLocation] to [friends].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addFriend(friend: ContactLocation) = apply {
+            friends =
+                (friends ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("friends", it).add(friend)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactListResponse =
+            ContactListResponse(
+                (friends ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        friends().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (friends.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactListResponse &&
+            friends == other.friends &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(friends, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactListResponse{friends=$friends, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
new file mode 100644
index 0000000..b237893
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
@@ -0,0 +1,290 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactLocation
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val coordinates: JsonField<List<Double>>,
+    private val handle: JsonField<String>,
+    private val lastUpdated: JsonField<Long>,
+    private val status: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("coordinates")
+        @ExcludeMissing
+        coordinates: JsonField<List<Double>> = JsonMissing.of(),
+        @JsonProperty("handle") @ExcludeMissing handle: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_updated")
+        @ExcludeMissing
+        lastUpdated: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<String> = JsonMissing.of(),
+    ) : this(coordinates, handle, lastUpdated, status, mutableMapOf())
+
+    /**
+     * GPS coordinates [latitude, longitude]
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun coordinates(): Optional<List<Double>> = coordinates.getOptional("coordinates")
+
+    /**
+     * Contact's phone number or email
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun handle(): Optional<String> = handle.getOptional("handle")
+
+    /**
+     * Timestamp of last location update (epoch ms)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastUpdated(): Optional<Long> = lastUpdated.getOptional("last_updated")
+
+    /**
+     * Location status (e.g., 'live', 'shallow', 'legacy')
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<String> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [coordinates].
+     *
+     * Unlike [coordinates], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("coordinates")
+    @ExcludeMissing
+    fun _coordinates(): JsonField<List<Double>> = coordinates
+
+    /**
+     * Returns the raw JSON value of [handle].
+     *
+     * Unlike [handle], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("handle") @ExcludeMissing fun _handle(): JsonField<String> = handle
+
+    /**
+     * Returns the raw JSON value of [lastUpdated].
+     *
+     * Unlike [lastUpdated], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_updated") @ExcludeMissing fun _lastUpdated(): JsonField<Long> = lastUpdated
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<String> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ContactLocation]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactLocation]. */
+    class Builder internal constructor() {
+
+        private var coordinates: JsonField<MutableList<Double>>? = null
+        private var handle: JsonField<String> = JsonMissing.of()
+        private var lastUpdated: JsonField<Long> = JsonMissing.of()
+        private var status: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactLocation: ContactLocation) = apply {
+            coordinates = contactLocation.coordinates.map { it.toMutableList() }
+            handle = contactLocation.handle
+            lastUpdated = contactLocation.lastUpdated
+            status = contactLocation.status
+            additionalProperties = contactLocation.additionalProperties.toMutableMap()
+        }
+
+        /** GPS coordinates [latitude, longitude] */
+        fun coordinates(coordinates: List<Double>) = coordinates(JsonField.of(coordinates))
+
+        /**
+         * Sets [Builder.coordinates] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.coordinates] with a well-typed `List<Double>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun coordinates(coordinates: JsonField<List<Double>>) = apply {
+            this.coordinates = coordinates.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Double] to [coordinates].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addCoordinate(coordinate: Double) = apply {
+            coordinates =
+                (coordinates ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("coordinates", it).add(coordinate)
+                }
+        }
+
+        /** Contact's phone number or email */
+        fun handle(handle: String) = handle(JsonField.of(handle))
+
+        /**
+         * Sets [Builder.handle] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.handle] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun handle(handle: JsonField<String>) = apply { this.handle = handle }
+
+        /** Timestamp of last location update (epoch ms) */
+        fun lastUpdated(lastUpdated: Long) = lastUpdated(JsonField.of(lastUpdated))
+
+        /**
+         * Sets [Builder.lastUpdated] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastUpdated] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastUpdated(lastUpdated: JsonField<Long>) = apply { this.lastUpdated = lastUpdated }
+
+        /** Location status (e.g., 'live', 'shallow', 'legacy') */
+        fun status(status: String) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<String>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactLocation].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactLocation =
+            ContactLocation(
+                (coordinates ?: JsonMissing.of()).map { it.toImmutable() },
+                handle,
+                lastUpdated,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactLocation = apply {
+        if (validated) {
+            return@apply
+        }
+
+        coordinates()
+        handle()
+        lastUpdated()
+        status()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (coordinates.asKnown().getOrNull()?.size ?: 0) +
+            (if (handle.asKnown().isPresent) 1 else 0) +
+            (if (lastUpdated.asKnown().isPresent) 1 else 0) +
+            (if (status.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactLocation &&
+            coordinates == other.coordinates &&
+            handle == other.handle &&
+            lastUpdated == other.lastUpdated &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(coordinates, handle, lastUpdated, status, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactLocation{coordinates=$coordinates, handle=$handle, lastUpdated=$lastUpdated, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParams.kt
similarity index 86%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchCreateParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParams.kt
index 18b2d3e..2c45401 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/batches/BatchCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParams.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.location.contacts
 
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.Params
@@ -10,8 +10,11 @@ import com.blooio.api.core.toImmutable
 import java.util.Objects
 import java.util.Optional
 
-/** Create a batch of messages (stub) */
-class BatchCreateParams
+/**
+ * Triggers a refresh of cached FindMy contact locations. Updated results may take 15-20 seconds to
+ * appear.
+ */
+class ContactRefreshParams
 private constructor(
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
@@ -31,13 +34,13 @@ private constructor(
 
     companion object {
 
-        @JvmStatic fun none(): BatchCreateParams = builder().build()
+        @JvmStatic fun none(): ContactRefreshParams = builder().build()
 
-        /** Returns a mutable builder for constructing an instance of [BatchCreateParams]. */
+        /** Returns a mutable builder for constructing an instance of [ContactRefreshParams]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [BatchCreateParams]. */
+    /** A builder for [ContactRefreshParams]. */
     class Builder internal constructor() {
 
         private var additionalHeaders: Headers.Builder = Headers.builder()
@@ -45,10 +48,10 @@ private constructor(
         private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(batchCreateParams: BatchCreateParams) = apply {
-            additionalHeaders = batchCreateParams.additionalHeaders.toBuilder()
-            additionalQueryParams = batchCreateParams.additionalQueryParams.toBuilder()
-            additionalBodyProperties = batchCreateParams.additionalBodyProperties.toMutableMap()
+        internal fun from(contactRefreshParams: ContactRefreshParams) = apply {
+            additionalHeaders = contactRefreshParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactRefreshParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = contactRefreshParams.additionalBodyProperties.toMutableMap()
         }
 
         fun additionalHeaders(additionalHeaders: Headers) = apply {
@@ -172,12 +175,12 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [BatchCreateParams].
+         * Returns an immutable instance of [ContactRefreshParams].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): BatchCreateParams =
-            BatchCreateParams(
+        fun build(): ContactRefreshParams =
+            ContactRefreshParams(
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
                 additionalBodyProperties.toImmutable(),
@@ -196,7 +199,7 @@ private constructor(
             return true
         }
 
-        return other is BatchCreateParams &&
+        return other is ContactRefreshParams &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams &&
             additionalBodyProperties == other.additionalBodyProperties
@@ -206,5 +209,5 @@ private constructor(
         Objects.hash(additionalHeaders, additionalQueryParams, additionalBodyProperties)
 
     override fun toString() =
-        "BatchCreateParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+        "ContactRefreshParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
new file mode 100644
index 0000000..a81e437
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
@@ -0,0 +1,211 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactRefreshResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val friends: JsonField<List<ContactLocation>>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("friends")
+        @ExcludeMissing
+        friends: JsonField<List<ContactLocation>> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(friends, success, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun friends(): Optional<List<ContactLocation>> = friends.getOptional("friends")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [friends].
+     *
+     * Unlike [friends], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("friends")
+    @ExcludeMissing
+    fun _friends(): JsonField<List<ContactLocation>> = friends
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [ContactRefreshResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactRefreshResponse]. */
+    class Builder internal constructor() {
+
+        private var friends: JsonField<MutableList<ContactLocation>>? = null
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactRefreshResponse: ContactRefreshResponse) = apply {
+            friends = contactRefreshResponse.friends.map { it.toMutableList() }
+            success = contactRefreshResponse.success
+            additionalProperties = contactRefreshResponse.additionalProperties.toMutableMap()
+        }
+
+        fun friends(friends: List<ContactLocation>) = friends(JsonField.of(friends))
+
+        /**
+         * Sets [Builder.friends] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.friends] with a well-typed `List<ContactLocation>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun friends(friends: JsonField<List<ContactLocation>>) = apply {
+            this.friends = friends.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [ContactLocation] to [friends].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addFriend(friend: ContactLocation) = apply {
+            friends =
+                (friends ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("friends", it).add(friend)
+                }
+        }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactRefreshResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactRefreshResponse =
+            ContactRefreshResponse(
+                (friends ?: JsonMissing.of()).map { it.toImmutable() },
+                success,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactRefreshResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        friends().ifPresent { it.forEach { it.validate() } }
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (friends.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactRefreshResponse &&
+            friends == other.friends &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(friends, success, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactRefreshResponse{friends=$friends, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParams.kt
new file mode 100644
index 0000000..0a09f18
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParams.kt
@@ -0,0 +1,189 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Returns the cached location for a specific contact identified by phone number or email. */
+class ContactRetrieveParams
+private constructor(
+    private val handle: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun handle(): Optional<String> = Optional.ofNullable(handle)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactRetrieveParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ContactRetrieveParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactRetrieveParams]. */
+    class Builder internal constructor() {
+
+        private var handle: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactRetrieveParams: ContactRetrieveParams) = apply {
+            handle = contactRetrieveParams.handle
+            additionalHeaders = contactRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactRetrieveParams.additionalQueryParams.toBuilder()
+        }
+
+        fun handle(handle: String?) = apply { this.handle = handle }
+
+        /** Alias for calling [Builder.handle] with `handle.orElse(null)`. */
+        fun handle(handle: Optional<String>) = handle(handle.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactRetrieveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactRetrieveParams =
+            ContactRetrieveParams(handle, additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> handle ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactRetrieveParams &&
+            handle == other.handle &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(handle, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactRetrieveParams{handle=$handle, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveParams.kt
index eddc208..6933e94 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveParams.kt
@@ -8,8 +8,8 @@ import com.blooio.api.core.http.QueryParams
 import java.util.Objects
 
 /**
- * Returns information about the authenticated API key including plan, devices, usage statistics,
- * and integration details.
+ * Returns details about the authenticated API key or dashboard user, including organization info,
+ * devices, and usage statistics.
  */
 class MeRetrieveParams
 private constructor(
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
index fb7c24c..4529a59 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
@@ -2,6 +2,7 @@
 
 package com.blooio.api.models.me
 
+import com.blooio.api.core.Enum
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
@@ -18,15 +19,22 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
+/**
+ * Response depends on auth_type. For 'api_key': includes full API key details. For 'dashboard':
+ * includes user_id and organization info only.
+ */
 class MeRetrieveResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val apiKey: JsonField<String>,
+    private val authType: JsonField<AuthType>,
     private val devices: JsonField<List<Device>>,
-    private val integrationDetails: JsonField<IntegrationDetails>,
+    private val integrationDetails: JsonValue,
     private val metadata: JsonValue,
-    private val plan: JsonField<String>,
+    private val organization: JsonField<Organization>,
+    private val organizationId: JsonField<String>,
     private val usage: JsonField<Usage>,
+    private val userId: JsonField<String>,
     private val valid: JsonField<Boolean>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -34,20 +42,39 @@ private constructor(
     @JsonCreator
     private constructor(
         @JsonProperty("api_key") @ExcludeMissing apiKey: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("auth_type") @ExcludeMissing authType: JsonField<AuthType> = JsonMissing.of(),
         @JsonProperty("devices")
         @ExcludeMissing
         devices: JsonField<List<Device>> = JsonMissing.of(),
         @JsonProperty("integration_details")
         @ExcludeMissing
-        integrationDetails: JsonField<IntegrationDetails> = JsonMissing.of(),
+        integrationDetails: JsonValue = JsonMissing.of(),
         @JsonProperty("metadata") @ExcludeMissing metadata: JsonValue = JsonMissing.of(),
-        @JsonProperty("plan") @ExcludeMissing plan: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("organization")
+        @ExcludeMissing
+        organization: JsonField<Organization> = JsonMissing.of(),
+        @JsonProperty("organization_id")
+        @ExcludeMissing
+        organizationId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("usage") @ExcludeMissing usage: JsonField<Usage> = JsonMissing.of(),
+        @JsonProperty("user_id") @ExcludeMissing userId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("valid") @ExcludeMissing valid: JsonField<Boolean> = JsonMissing.of(),
-    ) : this(apiKey, devices, integrationDetails, metadata, plan, usage, valid, mutableMapOf())
+    ) : this(
+        apiKey,
+        authType,
+        devices,
+        integrationDetails,
+        metadata,
+        organization,
+        organizationId,
+        usage,
+        userId,
+        valid,
+        mutableMapOf(),
+    )
 
     /**
-     * The API key used for authentication.
+     * The API key (only for api_key auth)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -55,24 +82,35 @@ private constructor(
     fun apiKey(): Optional<String> = apiKey.getOptional("api_key")
 
     /**
-     * List of devices associated with this API key.
+     * Type of authentication used
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun devices(): Optional<List<Device>> = devices.getOptional("devices")
+    fun authType(): Optional<AuthType> = authType.getOptional("auth_type")
 
     /**
-     * Integration-specific details (GHL or API integration).
+     * List of devices associated with this API key (only for api_key auth)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun integrationDetails(): Optional<IntegrationDetails> =
-        integrationDetails.getOptional("integration_details")
+    fun devices(): Optional<List<Device>> = devices.getOptional("devices")
+
+    /**
+     * Integration details if the API key is associated with an integration (only for api_key auth)
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = meRetrieveResponse.integrationDetails().convert(MyClass.class);
+     * ```
+     */
+    @JsonProperty("integration_details")
+    @ExcludeMissing
+    fun _integrationDetails(): JsonValue = integrationDetails
 
     /**
-     * Custom metadata associated with the API key.
+     * API key metadata (only for api_key auth)
      *
      * This arbitrary value can be deserialized into a custom type using the `convert` method:
      * ```java
@@ -82,15 +120,21 @@ private constructor(
     @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
 
     /**
-     * The plan associated with this API key.
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun organization(): Optional<Organization> = organization.getOptional("organization")
+
+    /**
+     * Organization ID (only for api_key auth)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun plan(): Optional<String> = plan.getOptional("plan")
+    fun organizationId(): Optional<String> = organizationId.getOptional("organization_id")
 
     /**
-     * Usage statistics for this API key.
+     * Usage statistics (only for api_key auth)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -98,7 +142,15 @@ private constructor(
     fun usage(): Optional<Usage> = usage.getOptional("usage")
 
     /**
-     * Whether the API key is valid.
+     * User ID (only for dashboard auth)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun userId(): Optional<String> = userId.getOptional("user_id")
+
+    /**
+     * Whether the API key is valid (only for api_key auth)
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -112,6 +164,13 @@ private constructor(
      */
     @JsonProperty("api_key") @ExcludeMissing fun _apiKey(): JsonField<String> = apiKey
 
+    /**
+     * Returns the raw JSON value of [authType].
+     *
+     * Unlike [authType], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("auth_type") @ExcludeMissing fun _authType(): JsonField<AuthType> = authType
+
     /**
      * Returns the raw JSON value of [devices].
      *
@@ -120,21 +179,22 @@ private constructor(
     @JsonProperty("devices") @ExcludeMissing fun _devices(): JsonField<List<Device>> = devices
 
     /**
-     * Returns the raw JSON value of [integrationDetails].
+     * Returns the raw JSON value of [organization].
      *
-     * Unlike [integrationDetails], this method doesn't throw if the JSON field has an unexpected
-     * type.
+     * Unlike [organization], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("integration_details")
+    @JsonProperty("organization")
     @ExcludeMissing
-    fun _integrationDetails(): JsonField<IntegrationDetails> = integrationDetails
+    fun _organization(): JsonField<Organization> = organization
 
     /**
-     * Returns the raw JSON value of [plan].
+     * Returns the raw JSON value of [organizationId].
      *
-     * Unlike [plan], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [organizationId], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("plan") @ExcludeMissing fun _plan(): JsonField<String> = plan
+    @JsonProperty("organization_id")
+    @ExcludeMissing
+    fun _organizationId(): JsonField<String> = organizationId
 
     /**
      * Returns the raw JSON value of [usage].
@@ -143,6 +203,13 @@ private constructor(
      */
     @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<Usage> = usage
 
+    /**
+     * Returns the raw JSON value of [userId].
+     *
+     * Unlike [userId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("user_id") @ExcludeMissing fun _userId(): JsonField<String> = userId
+
     /**
      * Returns the raw JSON value of [valid].
      *
@@ -172,27 +239,33 @@ private constructor(
     class Builder internal constructor() {
 
         private var apiKey: JsonField<String> = JsonMissing.of()
+        private var authType: JsonField<AuthType> = JsonMissing.of()
         private var devices: JsonField<MutableList<Device>>? = null
-        private var integrationDetails: JsonField<IntegrationDetails> = JsonMissing.of()
+        private var integrationDetails: JsonValue = JsonMissing.of()
         private var metadata: JsonValue = JsonMissing.of()
-        private var plan: JsonField<String> = JsonMissing.of()
+        private var organization: JsonField<Organization> = JsonMissing.of()
+        private var organizationId: JsonField<String> = JsonMissing.of()
         private var usage: JsonField<Usage> = JsonMissing.of()
+        private var userId: JsonField<String> = JsonMissing.of()
         private var valid: JsonField<Boolean> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(meRetrieveResponse: MeRetrieveResponse) = apply {
             apiKey = meRetrieveResponse.apiKey
+            authType = meRetrieveResponse.authType
             devices = meRetrieveResponse.devices.map { it.toMutableList() }
             integrationDetails = meRetrieveResponse.integrationDetails
             metadata = meRetrieveResponse.metadata
-            plan = meRetrieveResponse.plan
+            organization = meRetrieveResponse.organization
+            organizationId = meRetrieveResponse.organizationId
             usage = meRetrieveResponse.usage
+            userId = meRetrieveResponse.userId
             valid = meRetrieveResponse.valid
             additionalProperties = meRetrieveResponse.additionalProperties.toMutableMap()
         }
 
-        /** The API key used for authentication. */
+        /** The API key (only for api_key auth) */
         fun apiKey(apiKey: String) = apiKey(JsonField.of(apiKey))
 
         /**
@@ -203,7 +276,19 @@ private constructor(
          */
         fun apiKey(apiKey: JsonField<String>) = apply { this.apiKey = apiKey }
 
-        /** List of devices associated with this API key. */
+        /** Type of authentication used */
+        fun authType(authType: AuthType) = authType(JsonField.of(authType))
+
+        /**
+         * Sets [Builder.authType] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.authType] with a well-typed [AuthType] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun authType(authType: JsonField<AuthType>) = apply { this.authType = authType }
+
+        /** List of devices associated with this API key (only for api_key auth) */
         fun devices(devices: List<Device>) = devices(JsonField.of(devices))
 
         /**
@@ -229,42 +314,45 @@ private constructor(
                 }
         }
 
-        /** Integration-specific details (GHL or API integration). */
-        fun integrationDetails(integrationDetails: IntegrationDetails?) =
-            integrationDetails(JsonField.ofNullable(integrationDetails))
-
         /**
-         * Alias for calling [Builder.integrationDetails] with `integrationDetails.orElse(null)`.
+         * Integration details if the API key is associated with an integration (only for api_key
+         * auth)
          */
-        fun integrationDetails(integrationDetails: Optional<IntegrationDetails>) =
-            integrationDetails(integrationDetails.getOrNull())
+        fun integrationDetails(integrationDetails: JsonValue) = apply {
+            this.integrationDetails = integrationDetails
+        }
+
+        /** API key metadata (only for api_key auth) */
+        fun metadata(metadata: JsonValue) = apply { this.metadata = metadata }
+
+        fun organization(organization: Organization) = organization(JsonField.of(organization))
 
         /**
-         * Sets [Builder.integrationDetails] to an arbitrary JSON value.
+         * Sets [Builder.organization] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.integrationDetails] with a well-typed
-         * [IntegrationDetails] value instead. This method is primarily for setting the field to an
-         * undocumented or not yet supported value.
+         * You should usually call [Builder.organization] with a well-typed [Organization] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
          */
-        fun integrationDetails(integrationDetails: JsonField<IntegrationDetails>) = apply {
-            this.integrationDetails = integrationDetails
+        fun organization(organization: JsonField<Organization>) = apply {
+            this.organization = organization
         }
 
-        /** Custom metadata associated with the API key. */
-        fun metadata(metadata: JsonValue) = apply { this.metadata = metadata }
-
-        /** The plan associated with this API key. */
-        fun plan(plan: String) = plan(JsonField.of(plan))
+        /** Organization ID (only for api_key auth) */
+        fun organizationId(organizationId: String) = organizationId(JsonField.of(organizationId))
 
         /**
-         * Sets [Builder.plan] to an arbitrary JSON value.
+         * Sets [Builder.organizationId] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.plan] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
+         * You should usually call [Builder.organizationId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
          */
-        fun plan(plan: JsonField<String>) = apply { this.plan = plan }
+        fun organizationId(organizationId: JsonField<String>) = apply {
+            this.organizationId = organizationId
+        }
 
-        /** Usage statistics for this API key. */
+        /** Usage statistics (only for api_key auth) */
         fun usage(usage: Usage) = usage(JsonField.of(usage))
 
         /**
@@ -275,7 +363,21 @@ private constructor(
          */
         fun usage(usage: JsonField<Usage>) = apply { this.usage = usage }
 
-        /** Whether the API key is valid. */
+        /** User ID (only for dashboard auth) */
+        fun userId(userId: String?) = userId(JsonField.ofNullable(userId))
+
+        /** Alias for calling [Builder.userId] with `userId.orElse(null)`. */
+        fun userId(userId: Optional<String>) = userId(userId.getOrNull())
+
+        /**
+         * Sets [Builder.userId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.userId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun userId(userId: JsonField<String>) = apply { this.userId = userId }
+
+        /** Whether the API key is valid (only for api_key auth) */
         fun valid(valid: Boolean) = valid(JsonField.of(valid))
 
         /**
@@ -313,11 +415,14 @@ private constructor(
         fun build(): MeRetrieveResponse =
             MeRetrieveResponse(
                 apiKey,
+                authType,
                 (devices ?: JsonMissing.of()).map { it.toImmutable() },
                 integrationDetails,
                 metadata,
-                plan,
+                organization,
+                organizationId,
                 usage,
+                userId,
                 valid,
                 additionalProperties.toMutableMap(),
             )
@@ -331,10 +436,12 @@ private constructor(
         }
 
         apiKey()
+        authType().ifPresent { it.validate() }
         devices().ifPresent { it.forEach { it.validate() } }
-        integrationDetails().ifPresent { it.validate() }
-        plan()
+        organization().ifPresent { it.validate() }
+        organizationId()
         usage().ifPresent { it.validate() }
+        userId()
         valid()
         validated = true
     }
@@ -355,66 +462,181 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (apiKey.asKnown().isPresent) 1 else 0) +
+            (authType.asKnown().getOrNull()?.validity() ?: 0) +
             (devices.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-            (integrationDetails.asKnown().getOrNull()?.validity() ?: 0) +
-            (if (plan.asKnown().isPresent) 1 else 0) +
+            (organization.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (organizationId.asKnown().isPresent) 1 else 0) +
             (usage.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (userId.asKnown().isPresent) 1 else 0) +
             (if (valid.asKnown().isPresent) 1 else 0)
 
+    /** Type of authentication used */
+    class AuthType @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val API_KEY = of("api_key")
+
+            @JvmField val DASHBOARD = of("dashboard")
+
+            @JvmStatic fun of(value: String) = AuthType(JsonField.of(value))
+        }
+
+        /** An enum containing [AuthType]'s known values. */
+        enum class Known {
+            API_KEY,
+            DASHBOARD,
+        }
+
+        /**
+         * An enum containing [AuthType]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AuthType] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            API_KEY,
+            DASHBOARD,
+            /** An enum member indicating that [AuthType] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                API_KEY -> Value.API_KEY
+                DASHBOARD -> Value.DASHBOARD
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                API_KEY -> Known.API_KEY
+                DASHBOARD -> Known.DASHBOARD
+                else -> throw BlooioInvalidDataException("Unknown AuthType: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): AuthType = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AuthType && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     class Device
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val deviceHash: JsonField<String>,
         private val isActive: JsonField<Boolean>,
         private val lastActive: JsonField<Long>,
+        private val phoneNumber: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("device_hash")
-            @ExcludeMissing
-            deviceHash: JsonField<String> = JsonMissing.of(),
             @JsonProperty("is_active")
             @ExcludeMissing
             isActive: JsonField<Boolean> = JsonMissing.of(),
             @JsonProperty("last_active")
             @ExcludeMissing
             lastActive: JsonField<Long> = JsonMissing.of(),
-        ) : this(deviceHash, isActive, lastActive, mutableMapOf())
+            @JsonProperty("phone_number")
+            @ExcludeMissing
+            phoneNumber: JsonField<String> = JsonMissing.of(),
+        ) : this(isActive, lastActive, phoneNumber, mutableMapOf())
 
         /**
-         * Hashed device identifier.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun deviceHash(): Optional<String> = deviceHash.getOptional("device_hash")
+        fun isActive(): Optional<Boolean> = isActive.getOptional("is_active")
 
         /**
-         * Whether the device is currently active.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun isActive(): Optional<Boolean> = isActive.getOptional("is_active")
+        fun lastActive(): Optional<Long> = lastActive.getOptional("last_active")
 
         /**
-         * Unix timestamp (ms) of last device activity.
+         * Phone number assigned to this device (E.164 format)
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun lastActive(): Optional<Long> = lastActive.getOptional("last_active")
-
-        /**
-         * Returns the raw JSON value of [deviceHash].
-         *
-         * Unlike [deviceHash], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("device_hash")
-        @ExcludeMissing
-        fun _deviceHash(): JsonField<String> = deviceHash
+        fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
 
         /**
          * Returns the raw JSON value of [isActive].
@@ -430,6 +652,15 @@ private constructor(
          */
         @JsonProperty("last_active") @ExcludeMissing fun _lastActive(): JsonField<Long> = lastActive
 
+        /**
+         * Returns the raw JSON value of [phoneNumber].
+         *
+         * Unlike [phoneNumber], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("phone_number")
+        @ExcludeMissing
+        fun _phoneNumber(): JsonField<String> = phoneNumber
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -451,32 +682,19 @@ private constructor(
         /** A builder for [Device]. */
         class Builder internal constructor() {
 
-            private var deviceHash: JsonField<String> = JsonMissing.of()
             private var isActive: JsonField<Boolean> = JsonMissing.of()
             private var lastActive: JsonField<Long> = JsonMissing.of()
+            private var phoneNumber: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(device: Device) = apply {
-                deviceHash = device.deviceHash
                 isActive = device.isActive
                 lastActive = device.lastActive
+                phoneNumber = device.phoneNumber
                 additionalProperties = device.additionalProperties.toMutableMap()
             }
 
-            /** Hashed device identifier. */
-            fun deviceHash(deviceHash: String) = deviceHash(JsonField.of(deviceHash))
-
-            /**
-             * Sets [Builder.deviceHash] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.deviceHash] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun deviceHash(deviceHash: JsonField<String>) = apply { this.deviceHash = deviceHash }
-
-            /** Whether the device is currently active. */
             fun isActive(isActive: Boolean) = isActive(JsonField.of(isActive))
 
             /**
@@ -488,7 +706,6 @@ private constructor(
              */
             fun isActive(isActive: JsonField<Boolean>) = apply { this.isActive = isActive }
 
-            /** Unix timestamp (ms) of last device activity. */
             fun lastActive(lastActive: Long?) = lastActive(JsonField.ofNullable(lastActive))
 
             /**
@@ -510,6 +727,23 @@ private constructor(
              */
             fun lastActive(lastActive: JsonField<Long>) = apply { this.lastActive = lastActive }
 
+            /** Phone number assigned to this device (E.164 format) */
+            fun phoneNumber(phoneNumber: String?) = phoneNumber(JsonField.ofNullable(phoneNumber))
+
+            /** Alias for calling [Builder.phoneNumber] with `phoneNumber.orElse(null)`. */
+            fun phoneNumber(phoneNumber: Optional<String>) = phoneNumber(phoneNumber.getOrNull())
+
+            /**
+             * Sets [Builder.phoneNumber] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.phoneNumber] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun phoneNumber(phoneNumber: JsonField<String>) = apply {
+                this.phoneNumber = phoneNumber
+            }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -535,7 +769,7 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): Device =
-                Device(deviceHash, isActive, lastActive, additionalProperties.toMutableMap())
+                Device(isActive, lastActive, phoneNumber, additionalProperties.toMutableMap())
         }
 
         private var validated: Boolean = false
@@ -545,9 +779,9 @@ private constructor(
                 return@apply
             }
 
-            deviceHash()
             isActive()
             lastActive()
+            phoneNumber()
             validated = true
         }
 
@@ -567,9 +801,9 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (deviceHash.asKnown().isPresent) 1 else 0) +
-                (if (isActive.asKnown().isPresent) 1 else 0) +
-                (if (lastActive.asKnown().isPresent) 1 else 0)
+            (if (isActive.asKnown().isPresent) 1 else 0) +
+                (if (lastActive.asKnown().isPresent) 1 else 0) +
+                (if (phoneNumber.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -577,77 +811,85 @@ private constructor(
             }
 
             return other is Device &&
-                deviceHash == other.deviceHash &&
                 isActive == other.isActive &&
                 lastActive == other.lastActive &&
+                phoneNumber == other.phoneNumber &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(deviceHash, isActive, lastActive, additionalProperties)
+            Objects.hash(isActive, lastActive, phoneNumber, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Device{deviceHash=$deviceHash, isActive=$isActive, lastActive=$lastActive, additionalProperties=$additionalProperties}"
+            "Device{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, additionalProperties=$additionalProperties}"
     }
 
-    /** Integration-specific details (GHL or API integration). */
-    class IntegrationDetails
+    class Organization
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val customerWebhookUrl: JsonField<String>,
-        private val metadata: JsonValue,
+        private val countryCode: JsonField<String>,
+        private val createdAt: JsonField<Long>,
         private val name: JsonField<String>,
+        private val organizationId: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("customer_webhook_url")
+            @JsonProperty("country_code")
             @ExcludeMissing
-            customerWebhookUrl: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("metadata") @ExcludeMissing metadata: JsonValue = JsonMissing.of(),
+            countryCode: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("created_at")
+            @ExcludeMissing
+            createdAt: JsonField<Long> = JsonMissing.of(),
             @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
-        ) : this(customerWebhookUrl, metadata, name, mutableMapOf())
+            @JsonProperty("organization_id")
+            @ExcludeMissing
+            organizationId: JsonField<String> = JsonMissing.of(),
+        ) : this(countryCode, createdAt, name, organizationId, mutableMapOf())
 
         /**
-         * Webhook URL for API integrations.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun customerWebhookUrl(): Optional<String> =
-            customerWebhookUrl.getOptional("customer_webhook_url")
+        fun countryCode(): Optional<String> = countryCode.getOptional("country_code")
 
         /**
-         * Integration-specific metadata.
-         *
-         * This arbitrary value can be deserialized into a custom type using the `convert` method:
-         * ```java
-         * MyClass myObject = integrationDetails.metadata().convert(MyClass.class);
-         * ```
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonValue = metadata
+        fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
 
         /**
-         * Name of the integration (GHL only).
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
         fun name(): Optional<String> = name.getOptional("name")
 
         /**
-         * Returns the raw JSON value of [customerWebhookUrl].
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun organizationId(): Optional<String> = organizationId.getOptional("organization_id")
+
+        /**
+         * Returns the raw JSON value of [countryCode].
          *
-         * Unlike [customerWebhookUrl], this method doesn't throw if the JSON field has an
-         * unexpected type.
+         * Unlike [countryCode], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("customer_webhook_url")
+        @JsonProperty("country_code")
         @ExcludeMissing
-        fun _customerWebhookUrl(): JsonField<String> = customerWebhookUrl
+        fun _countryCode(): JsonField<String> = countryCode
+
+        /**
+         * Returns the raw JSON value of [createdAt].
+         *
+         * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
 
         /**
          * Returns the raw JSON value of [name].
@@ -656,6 +898,16 @@ private constructor(
          */
         @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
 
+        /**
+         * Returns the raw JSON value of [organizationId].
+         *
+         * Unlike [organizationId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("organization_id")
+        @ExcludeMissing
+        fun _organizationId(): JsonField<String> = organizationId
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -670,45 +922,55 @@ private constructor(
 
         companion object {
 
-            /** Returns a mutable builder for constructing an instance of [IntegrationDetails]. */
+            /** Returns a mutable builder for constructing an instance of [Organization]. */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [IntegrationDetails]. */
+        /** A builder for [Organization]. */
         class Builder internal constructor() {
 
-            private var customerWebhookUrl: JsonField<String> = JsonMissing.of()
-            private var metadata: JsonValue = JsonMissing.of()
+            private var countryCode: JsonField<String> = JsonMissing.of()
+            private var createdAt: JsonField<Long> = JsonMissing.of()
             private var name: JsonField<String> = JsonMissing.of()
+            private var organizationId: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(integrationDetails: IntegrationDetails) = apply {
-                customerWebhookUrl = integrationDetails.customerWebhookUrl
-                metadata = integrationDetails.metadata
-                name = integrationDetails.name
-                additionalProperties = integrationDetails.additionalProperties.toMutableMap()
+            internal fun from(organization: Organization) = apply {
+                countryCode = organization.countryCode
+                createdAt = organization.createdAt
+                name = organization.name
+                organizationId = organization.organizationId
+                additionalProperties = organization.additionalProperties.toMutableMap()
             }
 
-            /** Webhook URL for API integrations. */
-            fun customerWebhookUrl(customerWebhookUrl: String) =
-                customerWebhookUrl(JsonField.of(customerWebhookUrl))
+            fun countryCode(countryCode: String?) = countryCode(JsonField.ofNullable(countryCode))
+
+            /** Alias for calling [Builder.countryCode] with `countryCode.orElse(null)`. */
+            fun countryCode(countryCode: Optional<String>) = countryCode(countryCode.getOrNull())
 
             /**
-             * Sets [Builder.customerWebhookUrl] to an arbitrary JSON value.
+             * Sets [Builder.countryCode] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.customerWebhookUrl] with a well-typed [String] value
+             * You should usually call [Builder.countryCode] with a well-typed [String] value
              * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun customerWebhookUrl(customerWebhookUrl: JsonField<String>) = apply {
-                this.customerWebhookUrl = customerWebhookUrl
+            fun countryCode(countryCode: JsonField<String>) = apply {
+                this.countryCode = countryCode
             }
 
-            /** Integration-specific metadata. */
-            fun metadata(metadata: JsonValue) = apply { this.metadata = metadata }
+            fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+            /**
+             * Sets [Builder.createdAt] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.createdAt] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
 
-            /** Name of the integration (GHL only). */
             fun name(name: String) = name(JsonField.of(name))
 
             /**
@@ -720,6 +982,20 @@ private constructor(
              */
             fun name(name: JsonField<String>) = apply { this.name = name }
 
+            fun organizationId(organizationId: String) =
+                organizationId(JsonField.of(organizationId))
+
+            /**
+             * Sets [Builder.organizationId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.organizationId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun organizationId(organizationId: JsonField<String>) = apply {
+                this.organizationId = organizationId
+            }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -740,28 +1016,31 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [IntegrationDetails].
+             * Returns an immutable instance of [Organization].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              */
-            fun build(): IntegrationDetails =
-                IntegrationDetails(
-                    customerWebhookUrl,
-                    metadata,
+            fun build(): Organization =
+                Organization(
+                    countryCode,
+                    createdAt,
                     name,
+                    organizationId,
                     additionalProperties.toMutableMap(),
                 )
         }
 
         private var validated: Boolean = false
 
-        fun validate(): IntegrationDetails = apply {
+        fun validate(): Organization = apply {
             if (validated) {
                 return@apply
             }
 
-            customerWebhookUrl()
+            countryCode()
+            createdAt()
             name()
+            organizationId()
             validated = true
         }
 
@@ -781,32 +1060,35 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (customerWebhookUrl.asKnown().isPresent) 1 else 0) +
-                (if (name.asKnown().isPresent) 1 else 0)
+            (if (countryCode.asKnown().isPresent) 1 else 0) +
+                (if (createdAt.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (organizationId.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
-            return other is IntegrationDetails &&
-                customerWebhookUrl == other.customerWebhookUrl &&
-                metadata == other.metadata &&
+            return other is Organization &&
+                countryCode == other.countryCode &&
+                createdAt == other.createdAt &&
                 name == other.name &&
+                organizationId == other.organizationId &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(customerWebhookUrl, metadata, name, additionalProperties)
+            Objects.hash(countryCode, createdAt, name, organizationId, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "IntegrationDetails{customerWebhookUrl=$customerWebhookUrl, metadata=$metadata, name=$name, additionalProperties=$additionalProperties}"
+            "Organization{countryCode=$countryCode, createdAt=$createdAt, name=$name, organizationId=$organizationId, additionalProperties=$additionalProperties}"
     }
 
-    /** Usage statistics for this API key. */
+    /** Usage statistics (only for api_key auth) */
     class Usage
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
@@ -830,24 +1112,18 @@ private constructor(
         ) : this(inboundMessages, lastMessageSent, outboundMessages, mutableMapOf())
 
         /**
-         * Total number of inbound messages.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
         fun inboundMessages(): Optional<Long> = inboundMessages.getOptional("inbound_messages")
 
         /**
-         * Unix timestamp (ms) of the last message sent.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
         fun lastMessageSent(): Optional<Long> = lastMessageSent.getOptional("last_message_sent")
 
         /**
-         * Total number of outbound messages.
-         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
@@ -917,7 +1193,6 @@ private constructor(
                 additionalProperties = usage.additionalProperties.toMutableMap()
             }
 
-            /** Total number of inbound messages. */
             fun inboundMessages(inboundMessages: Long) =
                 inboundMessages(JsonField.of(inboundMessages))
 
@@ -932,7 +1207,6 @@ private constructor(
                 this.inboundMessages = inboundMessages
             }
 
-            /** Unix timestamp (ms) of the last message sent. */
             fun lastMessageSent(lastMessageSent: Long?) =
                 lastMessageSent(JsonField.ofNullable(lastMessageSent))
 
@@ -958,7 +1232,6 @@ private constructor(
                 this.lastMessageSent = lastMessageSent
             }
 
-            /** Total number of outbound messages. */
             fun outboundMessages(outboundMessages: Long) =
                 outboundMessages(JsonField.of(outboundMessages))
 
@@ -1068,11 +1341,14 @@ private constructor(
 
         return other is MeRetrieveResponse &&
             apiKey == other.apiKey &&
+            authType == other.authType &&
             devices == other.devices &&
             integrationDetails == other.integrationDetails &&
             metadata == other.metadata &&
-            plan == other.plan &&
+            organization == other.organization &&
+            organizationId == other.organizationId &&
             usage == other.usage &&
+            userId == other.userId &&
             valid == other.valid &&
             additionalProperties == other.additionalProperties
     }
@@ -1080,11 +1356,14 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             apiKey,
+            authType,
             devices,
             integrationDetails,
             metadata,
-            plan,
+            organization,
+            organizationId,
             usage,
+            userId,
             valid,
             additionalProperties,
         )
@@ -1093,5 +1372,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MeRetrieveResponse{apiKey=$apiKey, devices=$devices, integrationDetails=$integrationDetails, metadata=$metadata, plan=$plan, usage=$usage, valid=$valid, additionalProperties=$additionalProperties}"
+        "MeRetrieveResponse{apiKey=$apiKey, authType=$authType, devices=$devices, integrationDetails=$integrationDetails, metadata=$metadata, organization=$organization, organizationId=$organizationId, usage=$usage, userId=$userId, valid=$valid, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListParams.kt
new file mode 100644
index 0000000..660066e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListParams.kt
@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+
+/**
+ * List all phone numbers bound to this API key with their availability status. Use the returned
+ * phone numbers as the `:number` path parameter for other `/me/numbers/` endpoints.
+ */
+class NumberListParams
+private constructor(
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): NumberListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [NumberListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [NumberListParams]. */
+    class Builder internal constructor() {
+
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(numberListParams: NumberListParams) = apply {
+            additionalHeaders = numberListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = numberListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [NumberListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): NumberListParams =
+            NumberListParams(additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is NumberListParams &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "NumberListParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
new file mode 100644
index 0000000..0717517
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
@@ -0,0 +1,401 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.time.OffsetDateTime
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class NumberListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val numbers: JsonField<List<Number>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("numbers") @ExcludeMissing numbers: JsonField<List<Number>> = JsonMissing.of()
+    ) : this(numbers, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun numbers(): Optional<List<Number>> = numbers.getOptional("numbers")
+
+    /**
+     * Returns the raw JSON value of [numbers].
+     *
+     * Unlike [numbers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("numbers") @ExcludeMissing fun _numbers(): JsonField<List<Number>> = numbers
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [NumberListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [NumberListResponse]. */
+    class Builder internal constructor() {
+
+        private var numbers: JsonField<MutableList<Number>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(numberListResponse: NumberListResponse) = apply {
+            numbers = numberListResponse.numbers.map { it.toMutableList() }
+            additionalProperties = numberListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun numbers(numbers: List<Number>) = numbers(JsonField.of(numbers))
+
+        /**
+         * Sets [Builder.numbers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.numbers] with a well-typed `List<Number>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun numbers(numbers: JsonField<List<Number>>) = apply {
+            this.numbers = numbers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Number] to [numbers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addNumber(number: Number) = apply {
+            numbers =
+                (numbers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("numbers", it).add(number)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [NumberListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): NumberListResponse =
+            NumberListResponse(
+                (numbers ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): NumberListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        numbers().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (numbers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    class Number
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val isActive: JsonField<Boolean>,
+        private val lastActive: JsonField<OffsetDateTime>,
+        private val phoneNumber: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("is_active")
+            @ExcludeMissing
+            isActive: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("last_active")
+            @ExcludeMissing
+            lastActive: JsonField<OffsetDateTime> = JsonMissing.of(),
+            @JsonProperty("phone_number")
+            @ExcludeMissing
+            phoneNumber: JsonField<String> = JsonMissing.of(),
+        ) : this(isActive, lastActive, phoneNumber, mutableMapOf())
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun isActive(): Optional<Boolean> = isActive.getOptional("is_active")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastActive(): Optional<OffsetDateTime> = lastActive.getOptional("last_active")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
+
+        /**
+         * Returns the raw JSON value of [isActive].
+         *
+         * Unlike [isActive], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("is_active") @ExcludeMissing fun _isActive(): JsonField<Boolean> = isActive
+
+        /**
+         * Returns the raw JSON value of [lastActive].
+         *
+         * Unlike [lastActive], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("last_active")
+        @ExcludeMissing
+        fun _lastActive(): JsonField<OffsetDateTime> = lastActive
+
+        /**
+         * Returns the raw JSON value of [phoneNumber].
+         *
+         * Unlike [phoneNumber], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("phone_number")
+        @ExcludeMissing
+        fun _phoneNumber(): JsonField<String> = phoneNumber
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Number]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Number]. */
+        class Builder internal constructor() {
+
+            private var isActive: JsonField<Boolean> = JsonMissing.of()
+            private var lastActive: JsonField<OffsetDateTime> = JsonMissing.of()
+            private var phoneNumber: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(number: Number) = apply {
+                isActive = number.isActive
+                lastActive = number.lastActive
+                phoneNumber = number.phoneNumber
+                additionalProperties = number.additionalProperties.toMutableMap()
+            }
+
+            fun isActive(isActive: Boolean) = isActive(JsonField.of(isActive))
+
+            /**
+             * Sets [Builder.isActive] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.isActive] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun isActive(isActive: JsonField<Boolean>) = apply { this.isActive = isActive }
+
+            fun lastActive(lastActive: OffsetDateTime?) =
+                lastActive(JsonField.ofNullable(lastActive))
+
+            /** Alias for calling [Builder.lastActive] with `lastActive.orElse(null)`. */
+            fun lastActive(lastActive: Optional<OffsetDateTime>) =
+                lastActive(lastActive.getOrNull())
+
+            /**
+             * Sets [Builder.lastActive] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastActive] with a well-typed [OffsetDateTime] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastActive(lastActive: JsonField<OffsetDateTime>) = apply {
+                this.lastActive = lastActive
+            }
+
+            fun phoneNumber(phoneNumber: String) = phoneNumber(JsonField.of(phoneNumber))
+
+            /**
+             * Sets [Builder.phoneNumber] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.phoneNumber] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun phoneNumber(phoneNumber: JsonField<String>) = apply {
+                this.phoneNumber = phoneNumber
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Number].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Number =
+                Number(isActive, lastActive, phoneNumber, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Number = apply {
+            if (validated) {
+                return@apply
+            }
+
+            isActive()
+            lastActive()
+            phoneNumber()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (isActive.asKnown().isPresent) 1 else 0) +
+                (if (lastActive.asKnown().isPresent) 1 else 0) +
+                (if (phoneNumber.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Number &&
+                isActive == other.isActive &&
+                lastActive == other.lastActive &&
+                phoneNumber == other.phoneNumber &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(isActive, lastActive, phoneNumber, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Number{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is NumberListResponse &&
+            numbers == other.numbers &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(numbers, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "NumberListResponse{numbers=$numbers, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParams.kt
new file mode 100644
index 0000000..77982e4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParams.kt
@@ -0,0 +1,200 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+ *
+ * Get the personal contact card (Name & Photo) for the specified phone number. This is the identity
+ * that gets shared with contacts in iMessage.
+ */
+class ContactCardRetrieveParams
+private constructor(
+    private val number: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun number(): Optional<String> = Optional.ofNullable(number)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactCardRetrieveParams = builder().build()
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ContactCardRetrieveParams].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactCardRetrieveParams]. */
+    class Builder internal constructor() {
+
+        private var number: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactCardRetrieveParams: ContactCardRetrieveParams) = apply {
+            number = contactCardRetrieveParams.number
+            additionalHeaders = contactCardRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactCardRetrieveParams.additionalQueryParams.toBuilder()
+        }
+
+        fun number(number: String?) = apply { this.number = number }
+
+        /** Alias for calling [Builder.number] with `number.orElse(null)`. */
+        fun number(number: Optional<String>) = number(number.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactCardRetrieveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactCardRetrieveParams =
+            ContactCardRetrieveParams(
+                number,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> number ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactCardRetrieveParams &&
+            number == other.number &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(number, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactCardRetrieveParams{number=$number, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
new file mode 100644
index 0000000..6719141
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
@@ -0,0 +1,605 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactCardRetrieveResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val avatar: JsonField<String>,
+    private val firstName: JsonField<String>,
+    private val hasWallpaper: JsonField<Boolean>,
+    private val lastName: JsonField<String>,
+    private val name: JsonField<String>,
+    private val phoneNumber: JsonField<String>,
+    private val sharing: JsonField<Sharing>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("avatar") @ExcludeMissing avatar: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("first_name") @ExcludeMissing firstName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("has_wallpaper")
+        @ExcludeMissing
+        hasWallpaper: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("last_name") @ExcludeMissing lastName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("phone_number")
+        @ExcludeMissing
+        phoneNumber: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sharing") @ExcludeMissing sharing: JsonField<Sharing> = JsonMissing.of(),
+    ) : this(avatar, firstName, hasWallpaper, lastName, name, phoneNumber, sharing, mutableMapOf())
+
+    /**
+     * Base64-encoded JPEG/PNG image
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun avatar(): Optional<String> = avatar.getOptional("avatar")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun firstName(): Optional<String> = firstName.getOptional("first_name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun hasWallpaper(): Optional<Boolean> = hasWallpaper.getOptional("has_wallpaper")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastName(): Optional<String> = lastName.getOptional("last_name")
+
+    /**
+     * Display name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun sharing(): Optional<Sharing> = sharing.getOptional("sharing")
+
+    /**
+     * Returns the raw JSON value of [avatar].
+     *
+     * Unlike [avatar], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("avatar") @ExcludeMissing fun _avatar(): JsonField<String> = avatar
+
+    /**
+     * Returns the raw JSON value of [firstName].
+     *
+     * Unlike [firstName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("first_name") @ExcludeMissing fun _firstName(): JsonField<String> = firstName
+
+    /**
+     * Returns the raw JSON value of [hasWallpaper].
+     *
+     * Unlike [hasWallpaper], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("has_wallpaper")
+    @ExcludeMissing
+    fun _hasWallpaper(): JsonField<Boolean> = hasWallpaper
+
+    /**
+     * Returns the raw JSON value of [lastName].
+     *
+     * Unlike [lastName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_name") @ExcludeMissing fun _lastName(): JsonField<String> = lastName
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [phoneNumber].
+     *
+     * Unlike [phoneNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("phone_number")
+    @ExcludeMissing
+    fun _phoneNumber(): JsonField<String> = phoneNumber
+
+    /**
+     * Returns the raw JSON value of [sharing].
+     *
+     * Unlike [sharing], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sharing") @ExcludeMissing fun _sharing(): JsonField<Sharing> = sharing
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ContactCardRetrieveResponse].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactCardRetrieveResponse]. */
+    class Builder internal constructor() {
+
+        private var avatar: JsonField<String> = JsonMissing.of()
+        private var firstName: JsonField<String> = JsonMissing.of()
+        private var hasWallpaper: JsonField<Boolean> = JsonMissing.of()
+        private var lastName: JsonField<String> = JsonMissing.of()
+        private var name: JsonField<String> = JsonMissing.of()
+        private var phoneNumber: JsonField<String> = JsonMissing.of()
+        private var sharing: JsonField<Sharing> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactCardRetrieveResponse: ContactCardRetrieveResponse) = apply {
+            avatar = contactCardRetrieveResponse.avatar
+            firstName = contactCardRetrieveResponse.firstName
+            hasWallpaper = contactCardRetrieveResponse.hasWallpaper
+            lastName = contactCardRetrieveResponse.lastName
+            name = contactCardRetrieveResponse.name
+            phoneNumber = contactCardRetrieveResponse.phoneNumber
+            sharing = contactCardRetrieveResponse.sharing
+            additionalProperties = contactCardRetrieveResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Base64-encoded JPEG/PNG image */
+        fun avatar(avatar: String?) = avatar(JsonField.ofNullable(avatar))
+
+        /** Alias for calling [Builder.avatar] with `avatar.orElse(null)`. */
+        fun avatar(avatar: Optional<String>) = avatar(avatar.getOrNull())
+
+        /**
+         * Sets [Builder.avatar] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.avatar] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun avatar(avatar: JsonField<String>) = apply { this.avatar = avatar }
+
+        fun firstName(firstName: String?) = firstName(JsonField.ofNullable(firstName))
+
+        /** Alias for calling [Builder.firstName] with `firstName.orElse(null)`. */
+        fun firstName(firstName: Optional<String>) = firstName(firstName.getOrNull())
+
+        /**
+         * Sets [Builder.firstName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.firstName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun firstName(firstName: JsonField<String>) = apply { this.firstName = firstName }
+
+        fun hasWallpaper(hasWallpaper: Boolean) = hasWallpaper(JsonField.of(hasWallpaper))
+
+        /**
+         * Sets [Builder.hasWallpaper] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.hasWallpaper] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun hasWallpaper(hasWallpaper: JsonField<Boolean>) = apply {
+            this.hasWallpaper = hasWallpaper
+        }
+
+        fun lastName(lastName: String?) = lastName(JsonField.ofNullable(lastName))
+
+        /** Alias for calling [Builder.lastName] with `lastName.orElse(null)`. */
+        fun lastName(lastName: Optional<String>) = lastName(lastName.getOrNull())
+
+        /**
+         * Sets [Builder.lastName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastName] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun lastName(lastName: JsonField<String>) = apply { this.lastName = lastName }
+
+        /** Display name */
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        fun phoneNumber(phoneNumber: String) = phoneNumber(JsonField.of(phoneNumber))
+
+        /**
+         * Sets [Builder.phoneNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.phoneNumber] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun phoneNumber(phoneNumber: JsonField<String>) = apply { this.phoneNumber = phoneNumber }
+
+        fun sharing(sharing: Sharing) = sharing(JsonField.of(sharing))
+
+        /**
+         * Sets [Builder.sharing] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sharing] with a well-typed [Sharing] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun sharing(sharing: JsonField<Sharing>) = apply { this.sharing = sharing }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactCardRetrieveResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactCardRetrieveResponse =
+            ContactCardRetrieveResponse(
+                avatar,
+                firstName,
+                hasWallpaper,
+                lastName,
+                name,
+                phoneNumber,
+                sharing,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactCardRetrieveResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        avatar()
+        firstName()
+        hasWallpaper()
+        lastName()
+        name()
+        phoneNumber()
+        sharing().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (avatar.asKnown().isPresent) 1 else 0) +
+            (if (firstName.asKnown().isPresent) 1 else 0) +
+            (if (hasWallpaper.asKnown().isPresent) 1 else 0) +
+            (if (lastName.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (if (phoneNumber.asKnown().isPresent) 1 else 0) +
+            (sharing.asKnown().getOrNull()?.validity() ?: 0)
+
+    class Sharing
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val audience: JsonField<Long>,
+        private val enabled: JsonField<Boolean>,
+        private val nameFormat: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("audience") @ExcludeMissing audience: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("enabled") @ExcludeMissing enabled: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("name_format")
+            @ExcludeMissing
+            nameFormat: JsonField<Long> = JsonMissing.of(),
+        ) : this(audience, enabled, nameFormat, mutableMapOf())
+
+        /**
+         * 0 = Contacts Only, 1 = Always Ask
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun audience(): Optional<Long> = audience.getOptional("audience")
+
+        /**
+         * Whether Name & Photo sharing is enabled
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun enabled(): Optional<Boolean> = enabled.getOptional("enabled")
+
+        /**
+         * 0 = First & Last, 1 = First Only
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun nameFormat(): Optional<Long> = nameFormat.getOptional("name_format")
+
+        /**
+         * Returns the raw JSON value of [audience].
+         *
+         * Unlike [audience], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("audience") @ExcludeMissing fun _audience(): JsonField<Long> = audience
+
+        /**
+         * Returns the raw JSON value of [enabled].
+         *
+         * Unlike [enabled], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("enabled") @ExcludeMissing fun _enabled(): JsonField<Boolean> = enabled
+
+        /**
+         * Returns the raw JSON value of [nameFormat].
+         *
+         * Unlike [nameFormat], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name_format") @ExcludeMissing fun _nameFormat(): JsonField<Long> = nameFormat
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Sharing]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Sharing]. */
+        class Builder internal constructor() {
+
+            private var audience: JsonField<Long> = JsonMissing.of()
+            private var enabled: JsonField<Boolean> = JsonMissing.of()
+            private var nameFormat: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(sharing: Sharing) = apply {
+                audience = sharing.audience
+                enabled = sharing.enabled
+                nameFormat = sharing.nameFormat
+                additionalProperties = sharing.additionalProperties.toMutableMap()
+            }
+
+            /** 0 = Contacts Only, 1 = Always Ask */
+            fun audience(audience: Long) = audience(JsonField.of(audience))
+
+            /**
+             * Sets [Builder.audience] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.audience] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun audience(audience: JsonField<Long>) = apply { this.audience = audience }
+
+            /** Whether Name & Photo sharing is enabled */
+            fun enabled(enabled: Boolean) = enabled(JsonField.of(enabled))
+
+            /**
+             * Sets [Builder.enabled] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.enabled] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun enabled(enabled: JsonField<Boolean>) = apply { this.enabled = enabled }
+
+            /** 0 = First & Last, 1 = First Only */
+            fun nameFormat(nameFormat: Long) = nameFormat(JsonField.of(nameFormat))
+
+            /**
+             * Sets [Builder.nameFormat] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.nameFormat] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun nameFormat(nameFormat: JsonField<Long>) = apply { this.nameFormat = nameFormat }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Sharing].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Sharing =
+                Sharing(audience, enabled, nameFormat, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sharing = apply {
+            if (validated) {
+                return@apply
+            }
+
+            audience()
+            enabled()
+            nameFormat()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (audience.asKnown().isPresent) 1 else 0) +
+                (if (enabled.asKnown().isPresent) 1 else 0) +
+                (if (nameFormat.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sharing &&
+                audience == other.audience &&
+                enabled == other.enabled &&
+                nameFormat == other.nameFormat &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(audience, enabled, nameFormat, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Sharing{audience=$audience, enabled=$enabled, nameFormat=$nameFormat, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactCardRetrieveResponse &&
+            avatar == other.avatar &&
+            firstName == other.firstName &&
+            hasWallpaper == other.hasWallpaper &&
+            lastName == other.lastName &&
+            name == other.name &&
+            phoneNumber == other.phoneNumber &&
+            sharing == other.sharing &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            avatar,
+            firstName,
+            hasWallpaper,
+            lastName,
+            name,
+            phoneNumber,
+            sharing,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactCardRetrieveResponse{avatar=$avatar, firstName=$firstName, hasWallpaper=$hasWallpaper, lastName=$lastName, name=$name, phoneNumber=$phoneNumber, sharing=$sharing, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
new file mode 100644
index 0000000..9780ac2
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
@@ -0,0 +1,814 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Update the personal contact card (Name & Photo) for the specified phone number. All fields are
+ * optional — only provided fields are updated.
+ */
+class ContactCardUpdateParams
+private constructor(
+    private val number: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun number(): Optional<String> = Optional.ofNullable(number)
+
+    /**
+     * Profile photo as base64-encoded JPEG/PNG
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun avatar(): Optional<String> = body.avatar()
+
+    /**
+     * First name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun firstName(): Optional<String> = body.firstName()
+
+    /**
+     * Last name
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastName(): Optional<String> = body.lastName()
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun sharing(): Optional<Sharing> = body.sharing()
+
+    /**
+     * Returns the raw JSON value of [avatar].
+     *
+     * Unlike [avatar], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _avatar(): JsonField<String> = body._avatar()
+
+    /**
+     * Returns the raw JSON value of [firstName].
+     *
+     * Unlike [firstName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _firstName(): JsonField<String> = body._firstName()
+
+    /**
+     * Returns the raw JSON value of [lastName].
+     *
+     * Unlike [lastName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _lastName(): JsonField<String> = body._lastName()
+
+    /**
+     * Returns the raw JSON value of [sharing].
+     *
+     * Unlike [sharing], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _sharing(): JsonField<Sharing> = body._sharing()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ContactCardUpdateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ContactCardUpdateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactCardUpdateParams]. */
+    class Builder internal constructor() {
+
+        private var number: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(contactCardUpdateParams: ContactCardUpdateParams) = apply {
+            number = contactCardUpdateParams.number
+            body = contactCardUpdateParams.body.toBuilder()
+            additionalHeaders = contactCardUpdateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = contactCardUpdateParams.additionalQueryParams.toBuilder()
+        }
+
+        fun number(number: String?) = apply { this.number = number }
+
+        /** Alias for calling [Builder.number] with `number.orElse(null)`. */
+        fun number(number: Optional<String>) = number(number.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [avatar]
+         * - [firstName]
+         * - [lastName]
+         * - [sharing]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Profile photo as base64-encoded JPEG/PNG */
+        fun avatar(avatar: String) = apply { body.avatar(avatar) }
+
+        /**
+         * Sets [Builder.avatar] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.avatar] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun avatar(avatar: JsonField<String>) = apply { body.avatar(avatar) }
+
+        /** First name */
+        fun firstName(firstName: String) = apply { body.firstName(firstName) }
+
+        /**
+         * Sets [Builder.firstName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.firstName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun firstName(firstName: JsonField<String>) = apply { body.firstName(firstName) }
+
+        /** Last name */
+        fun lastName(lastName: String) = apply { body.lastName(lastName) }
+
+        /**
+         * Sets [Builder.lastName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastName] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun lastName(lastName: JsonField<String>) = apply { body.lastName(lastName) }
+
+        fun sharing(sharing: Sharing) = apply { body.sharing(sharing) }
+
+        /**
+         * Sets [Builder.sharing] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sharing] with a well-typed [Sharing] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun sharing(sharing: JsonField<Sharing>) = apply { body.sharing(sharing) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactCardUpdateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactCardUpdateParams =
+            ContactCardUpdateParams(
+                number,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> number ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val avatar: JsonField<String>,
+        private val firstName: JsonField<String>,
+        private val lastName: JsonField<String>,
+        private val sharing: JsonField<Sharing>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("avatar") @ExcludeMissing avatar: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("first_name")
+            @ExcludeMissing
+            firstName: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("last_name")
+            @ExcludeMissing
+            lastName: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("sharing") @ExcludeMissing sharing: JsonField<Sharing> = JsonMissing.of(),
+        ) : this(avatar, firstName, lastName, sharing, mutableMapOf())
+
+        /**
+         * Profile photo as base64-encoded JPEG/PNG
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun avatar(): Optional<String> = avatar.getOptional("avatar")
+
+        /**
+         * First name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun firstName(): Optional<String> = firstName.getOptional("first_name")
+
+        /**
+         * Last name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun lastName(): Optional<String> = lastName.getOptional("last_name")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun sharing(): Optional<Sharing> = sharing.getOptional("sharing")
+
+        /**
+         * Returns the raw JSON value of [avatar].
+         *
+         * Unlike [avatar], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("avatar") @ExcludeMissing fun _avatar(): JsonField<String> = avatar
+
+        /**
+         * Returns the raw JSON value of [firstName].
+         *
+         * Unlike [firstName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("first_name") @ExcludeMissing fun _firstName(): JsonField<String> = firstName
+
+        /**
+         * Returns the raw JSON value of [lastName].
+         *
+         * Unlike [lastName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("last_name") @ExcludeMissing fun _lastName(): JsonField<String> = lastName
+
+        /**
+         * Returns the raw JSON value of [sharing].
+         *
+         * Unlike [sharing], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("sharing") @ExcludeMissing fun _sharing(): JsonField<Sharing> = sharing
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var avatar: JsonField<String> = JsonMissing.of()
+            private var firstName: JsonField<String> = JsonMissing.of()
+            private var lastName: JsonField<String> = JsonMissing.of()
+            private var sharing: JsonField<Sharing> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                avatar = body.avatar
+                firstName = body.firstName
+                lastName = body.lastName
+                sharing = body.sharing
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Profile photo as base64-encoded JPEG/PNG */
+            fun avatar(avatar: String) = avatar(JsonField.of(avatar))
+
+            /**
+             * Sets [Builder.avatar] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.avatar] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun avatar(avatar: JsonField<String>) = apply { this.avatar = avatar }
+
+            /** First name */
+            fun firstName(firstName: String) = firstName(JsonField.of(firstName))
+
+            /**
+             * Sets [Builder.firstName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.firstName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun firstName(firstName: JsonField<String>) = apply { this.firstName = firstName }
+
+            /** Last name */
+            fun lastName(lastName: String) = lastName(JsonField.of(lastName))
+
+            /**
+             * Sets [Builder.lastName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.lastName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun lastName(lastName: JsonField<String>) = apply { this.lastName = lastName }
+
+            fun sharing(sharing: Sharing) = sharing(JsonField.of(sharing))
+
+            /**
+             * Sets [Builder.sharing] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.sharing] with a well-typed [Sharing] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun sharing(sharing: JsonField<Sharing>) = apply { this.sharing = sharing }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body =
+                Body(avatar, firstName, lastName, sharing, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            avatar()
+            firstName()
+            lastName()
+            sharing().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (avatar.asKnown().isPresent) 1 else 0) +
+                (if (firstName.asKnown().isPresent) 1 else 0) +
+                (if (lastName.asKnown().isPresent) 1 else 0) +
+                (sharing.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                avatar == other.avatar &&
+                firstName == other.firstName &&
+                lastName == other.lastName &&
+                sharing == other.sharing &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(avatar, firstName, lastName, sharing, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{avatar=$avatar, firstName=$firstName, lastName=$lastName, sharing=$sharing, additionalProperties=$additionalProperties}"
+    }
+
+    class Sharing
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val audience: JsonField<Long>,
+        private val enabled: JsonField<Boolean>,
+        private val nameFormat: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("audience") @ExcludeMissing audience: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("enabled") @ExcludeMissing enabled: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("name_format")
+            @ExcludeMissing
+            nameFormat: JsonField<Long> = JsonMissing.of(),
+        ) : this(audience, enabled, nameFormat, mutableMapOf())
+
+        /**
+         * 0 = Contacts Only, 1 = Always Ask
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun audience(): Optional<Long> = audience.getOptional("audience")
+
+        /**
+         * Enable/disable Name & Photo sharing
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun enabled(): Optional<Boolean> = enabled.getOptional("enabled")
+
+        /**
+         * 0 = First & Last, 1 = First Only
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun nameFormat(): Optional<Long> = nameFormat.getOptional("name_format")
+
+        /**
+         * Returns the raw JSON value of [audience].
+         *
+         * Unlike [audience], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("audience") @ExcludeMissing fun _audience(): JsonField<Long> = audience
+
+        /**
+         * Returns the raw JSON value of [enabled].
+         *
+         * Unlike [enabled], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("enabled") @ExcludeMissing fun _enabled(): JsonField<Boolean> = enabled
+
+        /**
+         * Returns the raw JSON value of [nameFormat].
+         *
+         * Unlike [nameFormat], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name_format") @ExcludeMissing fun _nameFormat(): JsonField<Long> = nameFormat
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Sharing]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Sharing]. */
+        class Builder internal constructor() {
+
+            private var audience: JsonField<Long> = JsonMissing.of()
+            private var enabled: JsonField<Boolean> = JsonMissing.of()
+            private var nameFormat: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(sharing: Sharing) = apply {
+                audience = sharing.audience
+                enabled = sharing.enabled
+                nameFormat = sharing.nameFormat
+                additionalProperties = sharing.additionalProperties.toMutableMap()
+            }
+
+            /** 0 = Contacts Only, 1 = Always Ask */
+            fun audience(audience: Long) = audience(JsonField.of(audience))
+
+            /**
+             * Sets [Builder.audience] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.audience] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun audience(audience: JsonField<Long>) = apply { this.audience = audience }
+
+            /** Enable/disable Name & Photo sharing */
+            fun enabled(enabled: Boolean) = enabled(JsonField.of(enabled))
+
+            /**
+             * Sets [Builder.enabled] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.enabled] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun enabled(enabled: JsonField<Boolean>) = apply { this.enabled = enabled }
+
+            /** 0 = First & Last, 1 = First Only */
+            fun nameFormat(nameFormat: Long) = nameFormat(JsonField.of(nameFormat))
+
+            /**
+             * Sets [Builder.nameFormat] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.nameFormat] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun nameFormat(nameFormat: JsonField<Long>) = apply { this.nameFormat = nameFormat }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Sharing].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Sharing =
+                Sharing(audience, enabled, nameFormat, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sharing = apply {
+            if (validated) {
+                return@apply
+            }
+
+            audience()
+            enabled()
+            nameFormat()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (audience.asKnown().isPresent) 1 else 0) +
+                (if (enabled.asKnown().isPresent) 1 else 0) +
+                (if (nameFormat.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sharing &&
+                audience == other.audience &&
+                enabled == other.enabled &&
+                nameFormat == other.nameFormat &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(audience, enabled, nameFormat, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Sharing{audience=$audience, enabled=$enabled, nameFormat=$nameFormat, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactCardUpdateParams &&
+            number == other.number &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(number, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ContactCardUpdateParams{number=$number, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
new file mode 100644
index 0000000..d4658b1
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
@@ -0,0 +1,268 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class ContactCardUpdateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val firstName: JsonField<String>,
+    private val lastName: JsonField<String>,
+    private val phoneNumber: JsonField<String>,
+    private val success: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("first_name") @ExcludeMissing firstName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("last_name") @ExcludeMissing lastName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("phone_number")
+        @ExcludeMissing
+        phoneNumber: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(firstName, lastName, phoneNumber, success, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun firstName(): Optional<String> = firstName.getOptional("first_name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastName(): Optional<String> = lastName.getOptional("last_name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * Returns the raw JSON value of [firstName].
+     *
+     * Unlike [firstName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("first_name") @ExcludeMissing fun _firstName(): JsonField<String> = firstName
+
+    /**
+     * Returns the raw JSON value of [lastName].
+     *
+     * Unlike [lastName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_name") @ExcludeMissing fun _lastName(): JsonField<String> = lastName
+
+    /**
+     * Returns the raw JSON value of [phoneNumber].
+     *
+     * Unlike [phoneNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("phone_number")
+    @ExcludeMissing
+    fun _phoneNumber(): JsonField<String> = phoneNumber
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ContactCardUpdateResponse].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ContactCardUpdateResponse]. */
+    class Builder internal constructor() {
+
+        private var firstName: JsonField<String> = JsonMissing.of()
+        private var lastName: JsonField<String> = JsonMissing.of()
+        private var phoneNumber: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(contactCardUpdateResponse: ContactCardUpdateResponse) = apply {
+            firstName = contactCardUpdateResponse.firstName
+            lastName = contactCardUpdateResponse.lastName
+            phoneNumber = contactCardUpdateResponse.phoneNumber
+            success = contactCardUpdateResponse.success
+            additionalProperties = contactCardUpdateResponse.additionalProperties.toMutableMap()
+        }
+
+        fun firstName(firstName: String?) = firstName(JsonField.ofNullable(firstName))
+
+        /** Alias for calling [Builder.firstName] with `firstName.orElse(null)`. */
+        fun firstName(firstName: Optional<String>) = firstName(firstName.getOrNull())
+
+        /**
+         * Sets [Builder.firstName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.firstName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun firstName(firstName: JsonField<String>) = apply { this.firstName = firstName }
+
+        fun lastName(lastName: String?) = lastName(JsonField.ofNullable(lastName))
+
+        /** Alias for calling [Builder.lastName] with `lastName.orElse(null)`. */
+        fun lastName(lastName: Optional<String>) = lastName(lastName.getOrNull())
+
+        /**
+         * Sets [Builder.lastName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastName] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun lastName(lastName: JsonField<String>) = apply { this.lastName = lastName }
+
+        fun phoneNumber(phoneNumber: String) = phoneNumber(JsonField.of(phoneNumber))
+
+        /**
+         * Sets [Builder.phoneNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.phoneNumber] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun phoneNumber(phoneNumber: JsonField<String>) = apply { this.phoneNumber = phoneNumber }
+
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ContactCardUpdateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ContactCardUpdateResponse =
+            ContactCardUpdateResponse(
+                firstName,
+                lastName,
+                phoneNumber,
+                success,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): ContactCardUpdateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        firstName()
+        lastName()
+        phoneNumber()
+        success()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (firstName.asKnown().isPresent) 1 else 0) +
+            (if (lastName.asKnown().isPresent) 1 else 0) +
+            (if (phoneNumber.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ContactCardUpdateResponse &&
+            firstName == other.firstName &&
+            lastName == other.lastName &&
+            phoneNumber == other.phoneNumber &&
+            success == other.success &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(firstName, lastName, phoneNumber, success, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "ContactCardUpdateResponse{firstName=$firstName, lastName=$lastName, phoneNumber=$phoneNumber, success=$success, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelResponse.kt
deleted file mode 100644
index 31bfce9..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/messages/MessageCancelResponse.kt
+++ /dev/null
@@ -1,311 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.messages
-
-import com.blooio.api.core.ExcludeMissing
-import com.blooio.api.core.JsonField
-import com.blooio.api.core.JsonMissing
-import com.blooio.api.core.JsonValue
-import com.blooio.api.errors.BlooioInvalidDataException
-import com.fasterxml.jackson.annotation.JsonAnyGetter
-import com.fasterxml.jackson.annotation.JsonAnySetter
-import com.fasterxml.jackson.annotation.JsonCreator
-import com.fasterxml.jackson.annotation.JsonProperty
-import java.util.Collections
-import java.util.Objects
-import java.util.Optional
-import kotlin.jvm.optionals.getOrNull
-
-class MessageCancelResponse
-@JsonCreator(mode = JsonCreator.Mode.DISABLED)
-private constructor(
-    private val cancelled: JsonField<Boolean>,
-    private val currentStatus: JsonField<String>,
-    private val message: JsonField<String>,
-    private val messageId: JsonField<String>,
-    private val status: JsonField<String>,
-    private val additionalProperties: MutableMap<String, JsonValue>,
-) {
-
-    @JsonCreator
-    private constructor(
-        @JsonProperty("cancelled") @ExcludeMissing cancelled: JsonField<Boolean> = JsonMissing.of(),
-        @JsonProperty("current_status")
-        @ExcludeMissing
-        currentStatus: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("message_id") @ExcludeMissing messageId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("status") @ExcludeMissing status: JsonField<String> = JsonMissing.of(),
-    ) : this(cancelled, currentStatus, message, messageId, status, mutableMapOf())
-
-    /**
-     * True if cancellation was successful, false otherwise.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun cancelled(): Optional<Boolean> = cancelled.getOptional("cancelled")
-
-    /**
-     * The current status if cancellation failed (deprecated, use 'status' instead).
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun currentStatus(): Optional<String> = currentStatus.getOptional("current_status")
-
-    /**
-     * Human-readable message about the cancellation result.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun message(): Optional<String> = message.getOptional("message")
-
-    /**
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun messageId(): Optional<String> = messageId.getOptional("message_id")
-
-    /**
-     * The current status of the message.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun status(): Optional<String> = status.getOptional("status")
-
-    /**
-     * Returns the raw JSON value of [cancelled].
-     *
-     * Unlike [cancelled], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("cancelled") @ExcludeMissing fun _cancelled(): JsonField<Boolean> = cancelled
-
-    /**
-     * Returns the raw JSON value of [currentStatus].
-     *
-     * Unlike [currentStatus], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("current_status")
-    @ExcludeMissing
-    fun _currentStatus(): JsonField<String> = currentStatus
-
-    /**
-     * Returns the raw JSON value of [message].
-     *
-     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
-
-    /**
-     * Returns the raw JSON value of [messageId].
-     *
-     * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
-
-    /**
-     * Returns the raw JSON value of [status].
-     *
-     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<String> = status
-
-    @JsonAnySetter
-    private fun putAdditionalProperty(key: String, value: JsonValue) {
-        additionalProperties.put(key, value)
-    }
-
-    @JsonAnyGetter
-    @ExcludeMissing
-    fun _additionalProperties(): Map<String, JsonValue> =
-        Collections.unmodifiableMap(additionalProperties)
-
-    fun toBuilder() = Builder().from(this)
-
-    companion object {
-
-        /** Returns a mutable builder for constructing an instance of [MessageCancelResponse]. */
-        @JvmStatic fun builder() = Builder()
-    }
-
-    /** A builder for [MessageCancelResponse]. */
-    class Builder internal constructor() {
-
-        private var cancelled: JsonField<Boolean> = JsonMissing.of()
-        private var currentStatus: JsonField<String> = JsonMissing.of()
-        private var message: JsonField<String> = JsonMissing.of()
-        private var messageId: JsonField<String> = JsonMissing.of()
-        private var status: JsonField<String> = JsonMissing.of()
-        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-        @JvmSynthetic
-        internal fun from(messageCancelResponse: MessageCancelResponse) = apply {
-            cancelled = messageCancelResponse.cancelled
-            currentStatus = messageCancelResponse.currentStatus
-            message = messageCancelResponse.message
-            messageId = messageCancelResponse.messageId
-            status = messageCancelResponse.status
-            additionalProperties = messageCancelResponse.additionalProperties.toMutableMap()
-        }
-
-        /** True if cancellation was successful, false otherwise. */
-        fun cancelled(cancelled: Boolean) = cancelled(JsonField.of(cancelled))
-
-        /**
-         * Sets [Builder.cancelled] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.cancelled] with a well-typed [Boolean] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun cancelled(cancelled: JsonField<Boolean>) = apply { this.cancelled = cancelled }
-
-        /** The current status if cancellation failed (deprecated, use 'status' instead). */
-        fun currentStatus(currentStatus: String?) =
-            currentStatus(JsonField.ofNullable(currentStatus))
-
-        /** Alias for calling [Builder.currentStatus] with `currentStatus.orElse(null)`. */
-        fun currentStatus(currentStatus: Optional<String>) =
-            currentStatus(currentStatus.getOrNull())
-
-        /**
-         * Sets [Builder.currentStatus] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.currentStatus] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun currentStatus(currentStatus: JsonField<String>) = apply {
-            this.currentStatus = currentStatus
-        }
-
-        /** Human-readable message about the cancellation result. */
-        fun message(message: String) = message(JsonField.of(message))
-
-        /**
-         * Sets [Builder.message] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.message] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
-         */
-        fun message(message: JsonField<String>) = apply { this.message = message }
-
-        fun messageId(messageId: String) = messageId(JsonField.of(messageId))
-
-        /**
-         * Sets [Builder.messageId] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.messageId] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
-
-        /** The current status of the message. */
-        fun status(status: String) = status(JsonField.of(status))
-
-        /**
-         * Sets [Builder.status] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.status] with a well-typed [String] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
-         */
-        fun status(status: JsonField<String>) = apply { this.status = status }
-
-        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-            this.additionalProperties.clear()
-            putAllAdditionalProperties(additionalProperties)
-        }
-
-        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-            additionalProperties.put(key, value)
-        }
-
-        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-            this.additionalProperties.putAll(additionalProperties)
-        }
-
-        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-            keys.forEach(::removeAdditionalProperty)
-        }
-
-        /**
-         * Returns an immutable instance of [MessageCancelResponse].
-         *
-         * Further updates to this [Builder] will not mutate the returned instance.
-         */
-        fun build(): MessageCancelResponse =
-            MessageCancelResponse(
-                cancelled,
-                currentStatus,
-                message,
-                messageId,
-                status,
-                additionalProperties.toMutableMap(),
-            )
-    }
-
-    private var validated: Boolean = false
-
-    fun validate(): MessageCancelResponse = apply {
-        if (validated) {
-            return@apply
-        }
-
-        cancelled()
-        currentStatus()
-        message()
-        messageId()
-        status()
-        validated = true
-    }
-
-    fun isValid(): Boolean =
-        try {
-            validate()
-            true
-        } catch (e: BlooioInvalidDataException) {
-            false
-        }
-
-    /**
-     * Returns a score indicating how many valid values are contained in this object recursively.
-     *
-     * Used for best match union deserialization.
-     */
-    @JvmSynthetic
-    internal fun validity(): Int =
-        (if (cancelled.asKnown().isPresent) 1 else 0) +
-            (if (currentStatus.asKnown().isPresent) 1 else 0) +
-            (if (message.asKnown().isPresent) 1 else 0) +
-            (if (messageId.asKnown().isPresent) 1 else 0) +
-            (if (status.asKnown().isPresent) 1 else 0)
-
-    override fun equals(other: Any?): Boolean {
-        if (this === other) {
-            return true
-        }
-
-        return other is MessageCancelResponse &&
-            cancelled == other.cancelled &&
-            currentStatus == other.currentStatus &&
-            message == other.message &&
-            messageId == other.messageId &&
-            status == other.status &&
-            additionalProperties == other.additionalProperties
-    }
-
-    private val hashCode: Int by lazy {
-        Objects.hash(cancelled, currentStatus, message, messageId, status, additionalProperties)
-    }
-
-    override fun hashCode(): Int = hashCode
-
-    override fun toString() =
-        "MessageCancelResponse{cancelled=$cancelled, currentStatus=$currentStatus, message=$message, messageId=$messageId, status=$status, additionalProperties=$additionalProperties}"
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
new file mode 100644
index 0000000..5215301
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
@@ -0,0 +1,450 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Look up multiple phone numbers in a single request. Returns the same detailed information as the
+ * single lookup endpoint for each number. Maximum 100 numbers per request.
+ *
+ * **Requires an Enterprise plan** (Dedicated Enterprise).
+ */
+class PhoneNumberBatchCreateParams
+private constructor(
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /**
+     * Array of phone numbers to look up
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun numbers(): List<String> = body.numbers()
+
+    /**
+     * Returns the raw JSON value of [numbers].
+     *
+     * Unlike [numbers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _numbers(): JsonField<List<String>> = body._numbers()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [PhoneNumberBatchCreateParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .numbers()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PhoneNumberBatchCreateParams]. */
+    class Builder internal constructor() {
+
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(phoneNumberBatchCreateParams: PhoneNumberBatchCreateParams) = apply {
+            body = phoneNumberBatchCreateParams.body.toBuilder()
+            additionalHeaders = phoneNumberBatchCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = phoneNumberBatchCreateParams.additionalQueryParams.toBuilder()
+        }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [numbers]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Array of phone numbers to look up */
+        fun numbers(numbers: List<String>) = apply { body.numbers(numbers) }
+
+        /**
+         * Sets [Builder.numbers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.numbers] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun numbers(numbers: JsonField<List<String>>) = apply { body.numbers(numbers) }
+
+        /**
+         * Adds a single [String] to [numbers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addNumber(number: String) = apply { body.addNumber(number) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [PhoneNumberBatchCreateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .numbers()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): PhoneNumberBatchCreateParams =
+            PhoneNumberBatchCreateParams(
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val numbers: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("numbers")
+            @ExcludeMissing
+            numbers: JsonField<List<String>> = JsonMissing.of()
+        ) : this(numbers, mutableMapOf())
+
+        /**
+         * Array of phone numbers to look up
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun numbers(): List<String> = numbers.getRequired("numbers")
+
+        /**
+         * Returns the raw JSON value of [numbers].
+         *
+         * Unlike [numbers], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("numbers") @ExcludeMissing fun _numbers(): JsonField<List<String>> = numbers
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .numbers()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var numbers: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                numbers = body.numbers.map { it.toMutableList() }
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Array of phone numbers to look up */
+            fun numbers(numbers: List<String>) = numbers(JsonField.of(numbers))
+
+            /**
+             * Sets [Builder.numbers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.numbers] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun numbers(numbers: JsonField<List<String>>) = apply {
+                this.numbers = numbers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [numbers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addNumber(number: String) = apply {
+                numbers =
+                    (numbers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("numbers", it).add(number)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .numbers()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("numbers", numbers).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            numbers()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (numbers.asKnown().getOrNull()?.size ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                numbers == other.numbers &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(numbers, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{numbers=$numbers, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PhoneNumberBatchCreateParams &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "PhoneNumberBatchCreateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
new file mode 100644
index 0000000..a907de4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
@@ -0,0 +1,185 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class PhoneNumberBatchCreateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val results: JsonField<List<PhoneNumberLookupResult>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("results")
+        @ExcludeMissing
+        results: JsonField<List<PhoneNumberLookupResult>> = JsonMissing.of()
+    ) : this(results, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun results(): Optional<List<PhoneNumberLookupResult>> = results.getOptional("results")
+
+    /**
+     * Returns the raw JSON value of [results].
+     *
+     * Unlike [results], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("results")
+    @ExcludeMissing
+    fun _results(): JsonField<List<PhoneNumberLookupResult>> = results
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [PhoneNumberBatchCreateResponse].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PhoneNumberBatchCreateResponse]. */
+    class Builder internal constructor() {
+
+        private var results: JsonField<MutableList<PhoneNumberLookupResult>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(phoneNumberBatchCreateResponse: PhoneNumberBatchCreateResponse) = apply {
+            results = phoneNumberBatchCreateResponse.results.map { it.toMutableList() }
+            additionalProperties =
+                phoneNumberBatchCreateResponse.additionalProperties.toMutableMap()
+        }
+
+        fun results(results: List<PhoneNumberLookupResult>) = results(JsonField.of(results))
+
+        /**
+         * Sets [Builder.results] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.results] with a well-typed
+         * `List<PhoneNumberLookupResult>` value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun results(results: JsonField<List<PhoneNumberLookupResult>>) = apply {
+            this.results = results.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [PhoneNumberLookupResult] to [results].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addResult(result: PhoneNumberLookupResult) = apply {
+            results =
+                (results ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("results", it).add(result)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [PhoneNumberBatchCreateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): PhoneNumberBatchCreateResponse =
+            PhoneNumberBatchCreateResponse(
+                (results ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): PhoneNumberBatchCreateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        results().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (results.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PhoneNumberBatchCreateResponse &&
+            results == other.results &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(results, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "PhoneNumberBatchCreateResponse{results=$results, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
new file mode 100644
index 0000000..d307837
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
@@ -0,0 +1,419 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+
+/**
+ * Same as the GET endpoint, but accepts the phone number in the request body. Useful when the
+ * number contains characters that are difficult to URL-encode.
+ *
+ * **Requires an Enterprise plan** (Dedicated Enterprise).
+ */
+class LookupCreateParams
+private constructor(
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /**
+     * Phone number to look up
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun number(): String = body.number()
+
+    /**
+     * Returns the raw JSON value of [number].
+     *
+     * Unlike [number], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _number(): JsonField<String> = body._number()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [LookupCreateParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .number()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LookupCreateParams]. */
+    class Builder internal constructor() {
+
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(lookupCreateParams: LookupCreateParams) = apply {
+            body = lookupCreateParams.body.toBuilder()
+            additionalHeaders = lookupCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = lookupCreateParams.additionalQueryParams.toBuilder()
+        }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [number]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Phone number to look up */
+        fun number(number: String) = apply { body.number(number) }
+
+        /**
+         * Sets [Builder.number] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.number] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun number(number: JsonField<String>) = apply { body.number(number) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [LookupCreateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .number()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): LookupCreateParams =
+            LookupCreateParams(
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val number: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("number") @ExcludeMissing number: JsonField<String> = JsonMissing.of()
+        ) : this(number, mutableMapOf())
+
+        /**
+         * Phone number to look up
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun number(): String = number.getRequired("number")
+
+        /**
+         * Returns the raw JSON value of [number].
+         *
+         * Unlike [number], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("number") @ExcludeMissing fun _number(): JsonField<String> = number
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .number()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var number: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                number = body.number
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Phone number to look up */
+            fun number(number: String) = number(JsonField.of(number))
+
+            /**
+             * Sets [Builder.number] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.number] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun number(number: JsonField<String>) = apply { this.number = number }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .number()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(checkRequired("number", number), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            number()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (number.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                number == other.number &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(number, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Body{number=$number, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LookupCreateParams &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "LookupCreateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParams.kt
new file mode 100644
index 0000000..9c2c94d
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParams.kt
@@ -0,0 +1,217 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+
+/**
+ * Returns detailed information about a phone number including validation, formatting (E.164,
+ * national, international), number type, and NANPA geocoding (city, state/province) for North
+ * American numbers. The geocoding data is sourced from different database with 240,000+ NPA-NXX
+ * entries.
+ *
+ * **Requires an Enterprise plan** (Dedicated Enterprise). Returns 403 if your organization does not
+ * have an active enterprise subscription.
+ */
+class LookupRetrieveParams
+private constructor(
+    private val number: String,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /**
+     * Phone number to look up. Can be E.164 format (+12125551234), national format (2125551234), or
+     * with formatting ((212) 555-1234).
+     */
+    fun number(): String = number
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [LookupRetrieveParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .number()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LookupRetrieveParams]. */
+    class Builder internal constructor() {
+
+        private var number: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(lookupRetrieveParams: LookupRetrieveParams) = apply {
+            number = lookupRetrieveParams.number
+            additionalHeaders = lookupRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = lookupRetrieveParams.additionalQueryParams.toBuilder()
+        }
+
+        /**
+         * Phone number to look up. Can be E.164 format (+12125551234), national format
+         * (2125551234), or with formatting ((212) 555-1234).
+         */
+        fun number(number: String) = apply { this.number = number }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [LookupRetrieveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .number()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): LookupRetrieveParams =
+            LookupRetrieveParams(
+                checkRequired("number", number),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                put("number", number)
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LookupRetrieveParams &&
+            number == other.number &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(number, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "LookupRetrieveParams{number=$number, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
new file mode 100644
index 0000000..ce97483
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
@@ -0,0 +1,1089 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class PhoneNumberLookupResult
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val areaCode: JsonField<String>,
+    private val areaCodeRegion: JsonField<String>,
+    private val country: JsonField<String>,
+    private val countryCallingCode: JsonField<String>,
+    private val e164: JsonField<String>,
+    private val exchange: JsonField<String>,
+    private val input: JsonField<String>,
+    private val international: JsonField<String>,
+    private val location: JsonField<Location>,
+    private val national: JsonField<String>,
+    private val nationalNumber: JsonField<String>,
+    private val possible: JsonField<Boolean>,
+    private val type: JsonField<Type>,
+    private val valid: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("area_code") @ExcludeMissing areaCode: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("area_code_region")
+        @ExcludeMissing
+        areaCodeRegion: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("country") @ExcludeMissing country: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("country_calling_code")
+        @ExcludeMissing
+        countryCallingCode: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("e164") @ExcludeMissing e164: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("exchange") @ExcludeMissing exchange: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("input") @ExcludeMissing input: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("international")
+        @ExcludeMissing
+        international: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("location") @ExcludeMissing location: JsonField<Location> = JsonMissing.of(),
+        @JsonProperty("national") @ExcludeMissing national: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("national_number")
+        @ExcludeMissing
+        nationalNumber: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("possible") @ExcludeMissing possible: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        @JsonProperty("valid") @ExcludeMissing valid: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(
+        areaCode,
+        areaCodeRegion,
+        country,
+        countryCallingCode,
+        e164,
+        exchange,
+        input,
+        international,
+        location,
+        national,
+        nationalNumber,
+        possible,
+        type,
+        valid,
+        mutableMapOf(),
+    )
+
+    /**
+     * NPA area code (first 3 digits of national number, only for NANP numbers)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun areaCode(): Optional<String> = areaCode.getOptional("area_code")
+
+    /**
+     * General region for the area code (most common city, only for NANP numbers)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun areaCodeRegion(): Optional<String> = areaCodeRegion.getOptional("area_code_region")
+
+    /**
+     * ISO 3166-1 alpha-2 country code
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun country(): Optional<String> = country.getOptional("country")
+
+    /**
+     * Country calling code without +
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun countryCallingCode(): Optional<String> =
+        countryCallingCode.getOptional("country_calling_code")
+
+    /**
+     * E.164 formatted number
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun e164(): Optional<String> = e164.getOptional("e164")
+
+    /**
+     * NXX exchange code (digits 4-6 of national number, only for NANP numbers)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun exchange(): Optional<String> = exchange.getOptional("exchange")
+
+    /**
+     * The original input string
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun input(): Optional<String> = input.getOptional("input")
+
+    /**
+     * International formatted number
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun international(): Optional<String> = international.getOptional("international")
+
+    /**
+     * NANPA geocoding location (only for North American numbers with country code 1)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun location(): Optional<Location> = location.getOptional("location")
+
+    /**
+     * National formatted number
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun national(): Optional<String> = national.getOptional("national")
+
+    /**
+     * National number without country code
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun nationalNumber(): Optional<String> = nationalNumber.getOptional("national_number")
+
+    /**
+     * Whether the phone number is a possible number (less strict than valid)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun possible(): Optional<Boolean> = possible.getOptional("possible")
+
+    /**
+     * Number type detected by libphonenumber
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun type(): Optional<Type> = type.getOptional("type")
+
+    /**
+     * Whether the phone number is valid
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun valid(): Optional<Boolean> = valid.getOptional("valid")
+
+    /**
+     * Returns the raw JSON value of [areaCode].
+     *
+     * Unlike [areaCode], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("area_code") @ExcludeMissing fun _areaCode(): JsonField<String> = areaCode
+
+    /**
+     * Returns the raw JSON value of [areaCodeRegion].
+     *
+     * Unlike [areaCodeRegion], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("area_code_region")
+    @ExcludeMissing
+    fun _areaCodeRegion(): JsonField<String> = areaCodeRegion
+
+    /**
+     * Returns the raw JSON value of [country].
+     *
+     * Unlike [country], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("country") @ExcludeMissing fun _country(): JsonField<String> = country
+
+    /**
+     * Returns the raw JSON value of [countryCallingCode].
+     *
+     * Unlike [countryCallingCode], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("country_calling_code")
+    @ExcludeMissing
+    fun _countryCallingCode(): JsonField<String> = countryCallingCode
+
+    /**
+     * Returns the raw JSON value of [e164].
+     *
+     * Unlike [e164], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("e164") @ExcludeMissing fun _e164(): JsonField<String> = e164
+
+    /**
+     * Returns the raw JSON value of [exchange].
+     *
+     * Unlike [exchange], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("exchange") @ExcludeMissing fun _exchange(): JsonField<String> = exchange
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<String> = input
+
+    /**
+     * Returns the raw JSON value of [international].
+     *
+     * Unlike [international], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("international")
+    @ExcludeMissing
+    fun _international(): JsonField<String> = international
+
+    /**
+     * Returns the raw JSON value of [location].
+     *
+     * Unlike [location], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("location") @ExcludeMissing fun _location(): JsonField<Location> = location
+
+    /**
+     * Returns the raw JSON value of [national].
+     *
+     * Unlike [national], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("national") @ExcludeMissing fun _national(): JsonField<String> = national
+
+    /**
+     * Returns the raw JSON value of [nationalNumber].
+     *
+     * Unlike [nationalNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("national_number")
+    @ExcludeMissing
+    fun _nationalNumber(): JsonField<String> = nationalNumber
+
+    /**
+     * Returns the raw JSON value of [possible].
+     *
+     * Unlike [possible], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("possible") @ExcludeMissing fun _possible(): JsonField<Boolean> = possible
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    /**
+     * Returns the raw JSON value of [valid].
+     *
+     * Unlike [valid], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("valid") @ExcludeMissing fun _valid(): JsonField<Boolean> = valid
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [PhoneNumberLookupResult]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [PhoneNumberLookupResult]. */
+    class Builder internal constructor() {
+
+        private var areaCode: JsonField<String> = JsonMissing.of()
+        private var areaCodeRegion: JsonField<String> = JsonMissing.of()
+        private var country: JsonField<String> = JsonMissing.of()
+        private var countryCallingCode: JsonField<String> = JsonMissing.of()
+        private var e164: JsonField<String> = JsonMissing.of()
+        private var exchange: JsonField<String> = JsonMissing.of()
+        private var input: JsonField<String> = JsonMissing.of()
+        private var international: JsonField<String> = JsonMissing.of()
+        private var location: JsonField<Location> = JsonMissing.of()
+        private var national: JsonField<String> = JsonMissing.of()
+        private var nationalNumber: JsonField<String> = JsonMissing.of()
+        private var possible: JsonField<Boolean> = JsonMissing.of()
+        private var type: JsonField<Type> = JsonMissing.of()
+        private var valid: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(phoneNumberLookupResult: PhoneNumberLookupResult) = apply {
+            areaCode = phoneNumberLookupResult.areaCode
+            areaCodeRegion = phoneNumberLookupResult.areaCodeRegion
+            country = phoneNumberLookupResult.country
+            countryCallingCode = phoneNumberLookupResult.countryCallingCode
+            e164 = phoneNumberLookupResult.e164
+            exchange = phoneNumberLookupResult.exchange
+            input = phoneNumberLookupResult.input
+            international = phoneNumberLookupResult.international
+            location = phoneNumberLookupResult.location
+            national = phoneNumberLookupResult.national
+            nationalNumber = phoneNumberLookupResult.nationalNumber
+            possible = phoneNumberLookupResult.possible
+            type = phoneNumberLookupResult.type
+            valid = phoneNumberLookupResult.valid
+            additionalProperties = phoneNumberLookupResult.additionalProperties.toMutableMap()
+        }
+
+        /** NPA area code (first 3 digits of national number, only for NANP numbers) */
+        fun areaCode(areaCode: String) = areaCode(JsonField.of(areaCode))
+
+        /**
+         * Sets [Builder.areaCode] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.areaCode] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun areaCode(areaCode: JsonField<String>) = apply { this.areaCode = areaCode }
+
+        /** General region for the area code (most common city, only for NANP numbers) */
+        fun areaCodeRegion(areaCodeRegion: String) = areaCodeRegion(JsonField.of(areaCodeRegion))
+
+        /**
+         * Sets [Builder.areaCodeRegion] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.areaCodeRegion] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun areaCodeRegion(areaCodeRegion: JsonField<String>) = apply {
+            this.areaCodeRegion = areaCodeRegion
+        }
+
+        /** ISO 3166-1 alpha-2 country code */
+        fun country(country: String?) = country(JsonField.ofNullable(country))
+
+        /** Alias for calling [Builder.country] with `country.orElse(null)`. */
+        fun country(country: Optional<String>) = country(country.getOrNull())
+
+        /**
+         * Sets [Builder.country] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.country] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun country(country: JsonField<String>) = apply { this.country = country }
+
+        /** Country calling code without + */
+        fun countryCallingCode(countryCallingCode: String) =
+            countryCallingCode(JsonField.of(countryCallingCode))
+
+        /**
+         * Sets [Builder.countryCallingCode] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.countryCallingCode] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun countryCallingCode(countryCallingCode: JsonField<String>) = apply {
+            this.countryCallingCode = countryCallingCode
+        }
+
+        /** E.164 formatted number */
+        fun e164(e164: String) = e164(JsonField.of(e164))
+
+        /**
+         * Sets [Builder.e164] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.e164] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun e164(e164: JsonField<String>) = apply { this.e164 = e164 }
+
+        /** NXX exchange code (digits 4-6 of national number, only for NANP numbers) */
+        fun exchange(exchange: String) = exchange(JsonField.of(exchange))
+
+        /**
+         * Sets [Builder.exchange] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.exchange] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun exchange(exchange: JsonField<String>) = apply { this.exchange = exchange }
+
+        /** The original input string */
+        fun input(input: String) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<String>) = apply { this.input = input }
+
+        /** International formatted number */
+        fun international(international: String) = international(JsonField.of(international))
+
+        /**
+         * Sets [Builder.international] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.international] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun international(international: JsonField<String>) = apply {
+            this.international = international
+        }
+
+        /** NANPA geocoding location (only for North American numbers with country code 1) */
+        fun location(location: Location?) = location(JsonField.ofNullable(location))
+
+        /** Alias for calling [Builder.location] with `location.orElse(null)`. */
+        fun location(location: Optional<Location>) = location(location.getOrNull())
+
+        /**
+         * Sets [Builder.location] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.location] with a well-typed [Location] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun location(location: JsonField<Location>) = apply { this.location = location }
+
+        /** National formatted number */
+        fun national(national: String) = national(JsonField.of(national))
+
+        /**
+         * Sets [Builder.national] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.national] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun national(national: JsonField<String>) = apply { this.national = national }
+
+        /** National number without country code */
+        fun nationalNumber(nationalNumber: String) = nationalNumber(JsonField.of(nationalNumber))
+
+        /**
+         * Sets [Builder.nationalNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.nationalNumber] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun nationalNumber(nationalNumber: JsonField<String>) = apply {
+            this.nationalNumber = nationalNumber
+        }
+
+        /** Whether the phone number is a possible number (less strict than valid) */
+        fun possible(possible: Boolean) = possible(JsonField.of(possible))
+
+        /**
+         * Sets [Builder.possible] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.possible] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun possible(possible: JsonField<Boolean>) = apply { this.possible = possible }
+
+        /** Number type detected by libphonenumber */
+        fun type(type: Type?) = type(JsonField.ofNullable(type))
+
+        /** Alias for calling [Builder.type] with `type.orElse(null)`. */
+        fun type(type: Optional<Type>) = type(type.getOrNull())
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        /** Whether the phone number is valid */
+        fun valid(valid: Boolean) = valid(JsonField.of(valid))
+
+        /**
+         * Sets [Builder.valid] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.valid] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun valid(valid: JsonField<Boolean>) = apply { this.valid = valid }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [PhoneNumberLookupResult].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): PhoneNumberLookupResult =
+            PhoneNumberLookupResult(
+                areaCode,
+                areaCodeRegion,
+                country,
+                countryCallingCode,
+                e164,
+                exchange,
+                input,
+                international,
+                location,
+                national,
+                nationalNumber,
+                possible,
+                type,
+                valid,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): PhoneNumberLookupResult = apply {
+        if (validated) {
+            return@apply
+        }
+
+        areaCode()
+        areaCodeRegion()
+        country()
+        countryCallingCode()
+        e164()
+        exchange()
+        input()
+        international()
+        location().ifPresent { it.validate() }
+        national()
+        nationalNumber()
+        possible()
+        type().ifPresent { it.validate() }
+        valid()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (areaCode.asKnown().isPresent) 1 else 0) +
+            (if (areaCodeRegion.asKnown().isPresent) 1 else 0) +
+            (if (country.asKnown().isPresent) 1 else 0) +
+            (if (countryCallingCode.asKnown().isPresent) 1 else 0) +
+            (if (e164.asKnown().isPresent) 1 else 0) +
+            (if (exchange.asKnown().isPresent) 1 else 0) +
+            (if (input.asKnown().isPresent) 1 else 0) +
+            (if (international.asKnown().isPresent) 1 else 0) +
+            (location.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (national.asKnown().isPresent) 1 else 0) +
+            (if (nationalNumber.asKnown().isPresent) 1 else 0) +
+            (if (possible.asKnown().isPresent) 1 else 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (valid.asKnown().isPresent) 1 else 0)
+
+    /** NANPA geocoding location (only for North American numbers with country code 1) */
+    class Location
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val city: JsonField<String>,
+        private val region: JsonField<String>,
+        private val regionName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("city") @ExcludeMissing city: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("region") @ExcludeMissing region: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("region_name")
+            @ExcludeMissing
+            regionName: JsonField<String> = JsonMissing.of(),
+        ) : this(city, region, regionName, mutableMapOf())
+
+        /**
+         * City name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun city(): Optional<String> = city.getOptional("city")
+
+        /**
+         * State/province abbreviation
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun region(): Optional<String> = region.getOptional("region")
+
+        /**
+         * Full state/province name
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun regionName(): Optional<String> = regionName.getOptional("region_name")
+
+        /**
+         * Returns the raw JSON value of [city].
+         *
+         * Unlike [city], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("city") @ExcludeMissing fun _city(): JsonField<String> = city
+
+        /**
+         * Returns the raw JSON value of [region].
+         *
+         * Unlike [region], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("region") @ExcludeMissing fun _region(): JsonField<String> = region
+
+        /**
+         * Returns the raw JSON value of [regionName].
+         *
+         * Unlike [regionName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("region_name")
+        @ExcludeMissing
+        fun _regionName(): JsonField<String> = regionName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Location]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Location]. */
+        class Builder internal constructor() {
+
+            private var city: JsonField<String> = JsonMissing.of()
+            private var region: JsonField<String> = JsonMissing.of()
+            private var regionName: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(location: Location) = apply {
+                city = location.city
+                region = location.region
+                regionName = location.regionName
+                additionalProperties = location.additionalProperties.toMutableMap()
+            }
+
+            /** City name */
+            fun city(city: String?) = city(JsonField.ofNullable(city))
+
+            /** Alias for calling [Builder.city] with `city.orElse(null)`. */
+            fun city(city: Optional<String>) = city(city.getOrNull())
+
+            /**
+             * Sets [Builder.city] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.city] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun city(city: JsonField<String>) = apply { this.city = city }
+
+            /** State/province abbreviation */
+            fun region(region: String?) = region(JsonField.ofNullable(region))
+
+            /** Alias for calling [Builder.region] with `region.orElse(null)`. */
+            fun region(region: Optional<String>) = region(region.getOrNull())
+
+            /**
+             * Sets [Builder.region] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.region] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun region(region: JsonField<String>) = apply { this.region = region }
+
+            /** Full state/province name */
+            fun regionName(regionName: String?) = regionName(JsonField.ofNullable(regionName))
+
+            /** Alias for calling [Builder.regionName] with `regionName.orElse(null)`. */
+            fun regionName(regionName: Optional<String>) = regionName(regionName.getOrNull())
+
+            /**
+             * Sets [Builder.regionName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.regionName] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun regionName(regionName: JsonField<String>) = apply { this.regionName = regionName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Location].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Location =
+                Location(city, region, regionName, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Location = apply {
+            if (validated) {
+                return@apply
+            }
+
+            city()
+            region()
+            regionName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (city.asKnown().isPresent) 1 else 0) +
+                (if (region.asKnown().isPresent) 1 else 0) +
+                (if (regionName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Location &&
+                city == other.city &&
+                region == other.region &&
+                regionName == other.regionName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(city, region, regionName, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Location{city=$city, region=$region, regionName=$regionName, additionalProperties=$additionalProperties}"
+    }
+
+    /** Number type detected by libphonenumber */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val FIXED_LINE = of("FIXED_LINE")
+
+            @JvmField val MOBILE = of("MOBILE")
+
+            @JvmField val FIXED_LINE_OR_MOBILE = of("FIXED_LINE_OR_MOBILE")
+
+            @JvmField val TOLL_FREE = of("TOLL_FREE")
+
+            @JvmField val PREMIUM_RATE = of("PREMIUM_RATE")
+
+            @JvmField val SHARED_COST = of("SHARED_COST")
+
+            @JvmField val VOIP = of("VOIP")
+
+            @JvmField val PERSONAL_NUMBER = of("PERSONAL_NUMBER")
+
+            @JvmField val PAGER = of("PAGER")
+
+            @JvmField val UAN = of("UAN")
+
+            @JvmField val VOICEMAIL = of("VOICEMAIL")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            FIXED_LINE,
+            MOBILE,
+            FIXED_LINE_OR_MOBILE,
+            TOLL_FREE,
+            PREMIUM_RATE,
+            SHARED_COST,
+            VOIP,
+            PERSONAL_NUMBER,
+            PAGER,
+            UAN,
+            VOICEMAIL,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            FIXED_LINE,
+            MOBILE,
+            FIXED_LINE_OR_MOBILE,
+            TOLL_FREE,
+            PREMIUM_RATE,
+            SHARED_COST,
+            VOIP,
+            PERSONAL_NUMBER,
+            PAGER,
+            UAN,
+            VOICEMAIL,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                FIXED_LINE -> Value.FIXED_LINE
+                MOBILE -> Value.MOBILE
+                FIXED_LINE_OR_MOBILE -> Value.FIXED_LINE_OR_MOBILE
+                TOLL_FREE -> Value.TOLL_FREE
+                PREMIUM_RATE -> Value.PREMIUM_RATE
+                SHARED_COST -> Value.SHARED_COST
+                VOIP -> Value.VOIP
+                PERSONAL_NUMBER -> Value.PERSONAL_NUMBER
+                PAGER -> Value.PAGER
+                UAN -> Value.UAN
+                VOICEMAIL -> Value.VOICEMAIL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                FIXED_LINE -> Known.FIXED_LINE
+                MOBILE -> Known.MOBILE
+                FIXED_LINE_OR_MOBILE -> Known.FIXED_LINE_OR_MOBILE
+                TOLL_FREE -> Known.TOLL_FREE
+                PREMIUM_RATE -> Known.PREMIUM_RATE
+                SHARED_COST -> Known.SHARED_COST
+                VOIP -> Known.VOIP
+                PERSONAL_NUMBER -> Known.PERSONAL_NUMBER
+                PAGER -> Known.PAGER
+                UAN -> Known.UAN
+                VOICEMAIL -> Known.VOICEMAIL
+                else -> throw BlooioInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is PhoneNumberLookupResult &&
+            areaCode == other.areaCode &&
+            areaCodeRegion == other.areaCodeRegion &&
+            country == other.country &&
+            countryCallingCode == other.countryCallingCode &&
+            e164 == other.e164 &&
+            exchange == other.exchange &&
+            input == other.input &&
+            international == other.international &&
+            location == other.location &&
+            national == other.national &&
+            nationalNumber == other.nationalNumber &&
+            possible == other.possible &&
+            type == other.type &&
+            valid == other.valid &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            areaCode,
+            areaCodeRegion,
+            country,
+            countryCallingCode,
+            e164,
+            exchange,
+            input,
+            international,
+            location,
+            national,
+            nationalNumber,
+            possible,
+            type,
+            valid,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "PhoneNumberLookupResult{areaCode=$areaCode, areaCodeRegion=$areaCodeRegion, country=$country, countryCallingCode=$countryCallingCode, e164=$e164, exchange=$exchange, input=$input, international=$international, location=$location, national=$national, nationalNumber=$nationalNumber, possible=$possible, type=$type, valid=$valid, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
new file mode 100644
index 0000000..9d3278f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
@@ -0,0 +1,875 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class Webhook
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val apiKeyName: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val deprecatedAt: JsonField<Long>,
+    private val failureCount: JsonField<Long>,
+    private val integrationName: JsonField<String>,
+    private val isActive: JsonField<Boolean>,
+    private val lastTriggered: JsonField<Long>,
+    private val scope: JsonField<Scope>,
+    private val validUntil: JsonField<Long>,
+    private val webhookId: JsonField<String>,
+    private val webhookType: JsonField<WebhookType>,
+    private val webhookUrl: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("api_key_name")
+        @ExcludeMissing
+        apiKeyName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("deprecated_at")
+        @ExcludeMissing
+        deprecatedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("failure_count")
+        @ExcludeMissing
+        failureCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("integration_name")
+        @ExcludeMissing
+        integrationName: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("is_active") @ExcludeMissing isActive: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("last_triggered")
+        @ExcludeMissing
+        lastTriggered: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("scope") @ExcludeMissing scope: JsonField<Scope> = JsonMissing.of(),
+        @JsonProperty("valid_until") @ExcludeMissing validUntil: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("webhook_id") @ExcludeMissing webhookId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("webhook_type")
+        @ExcludeMissing
+        webhookType: JsonField<WebhookType> = JsonMissing.of(),
+        @JsonProperty("webhook_url")
+        @ExcludeMissing
+        webhookUrl: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        apiKeyName,
+        createdAt,
+        deprecatedAt,
+        failureCount,
+        integrationName,
+        isActive,
+        lastTriggered,
+        scope,
+        validUntil,
+        webhookId,
+        webhookType,
+        webhookUrl,
+        mutableMapOf(),
+    )
+
+    /**
+     * Name of the API key (if scope is api_key)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun apiKeyName(): Optional<String> = apiKeyName.getOptional("api_key_name")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdAt(): Optional<Long> = createdAt.getOptional("created_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deprecatedAt(): Optional<Long> = deprecatedAt.getOptional("deprecated_at")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun failureCount(): Optional<Long> = failureCount.getOptional("failure_count")
+
+    /**
+     * Name of the integration (if scope is integration)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun integrationName(): Optional<String> = integrationName.getOptional("integration_name")
+
+    /**
+     * Whether the webhook is active (not deprecated)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun isActive(): Optional<Boolean> = isActive.getOptional("is_active")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun lastTriggered(): Optional<Long> = lastTriggered.getOptional("last_triggered")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun scope(): Optional<Scope> = scope.getOptional("scope")
+
+    /**
+     * -1 means no expiration
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun validUntil(): Optional<Long> = validUntil.getOptional("valid_until")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookId(): Optional<String> = webhookId.getOptional("webhook_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookType(): Optional<WebhookType> = webhookType.getOptional("webhook_type")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookUrl(): Optional<String> = webhookUrl.getOptional("webhook_url")
+
+    /**
+     * Returns the raw JSON value of [apiKeyName].
+     *
+     * Unlike [apiKeyName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("api_key_name") @ExcludeMissing fun _apiKeyName(): JsonField<String> = apiKeyName
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [deprecatedAt].
+     *
+     * Unlike [deprecatedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("deprecated_at")
+    @ExcludeMissing
+    fun _deprecatedAt(): JsonField<Long> = deprecatedAt
+
+    /**
+     * Returns the raw JSON value of [failureCount].
+     *
+     * Unlike [failureCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("failure_count")
+    @ExcludeMissing
+    fun _failureCount(): JsonField<Long> = failureCount
+
+    /**
+     * Returns the raw JSON value of [integrationName].
+     *
+     * Unlike [integrationName], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("integration_name")
+    @ExcludeMissing
+    fun _integrationName(): JsonField<String> = integrationName
+
+    /**
+     * Returns the raw JSON value of [isActive].
+     *
+     * Unlike [isActive], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("is_active") @ExcludeMissing fun _isActive(): JsonField<Boolean> = isActive
+
+    /**
+     * Returns the raw JSON value of [lastTriggered].
+     *
+     * Unlike [lastTriggered], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_triggered")
+    @ExcludeMissing
+    fun _lastTriggered(): JsonField<Long> = lastTriggered
+
+    /**
+     * Returns the raw JSON value of [scope].
+     *
+     * Unlike [scope], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("scope") @ExcludeMissing fun _scope(): JsonField<Scope> = scope
+
+    /**
+     * Returns the raw JSON value of [validUntil].
+     *
+     * Unlike [validUntil], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("valid_until") @ExcludeMissing fun _validUntil(): JsonField<Long> = validUntil
+
+    /**
+     * Returns the raw JSON value of [webhookId].
+     *
+     * Unlike [webhookId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_id") @ExcludeMissing fun _webhookId(): JsonField<String> = webhookId
+
+    /**
+     * Returns the raw JSON value of [webhookType].
+     *
+     * Unlike [webhookType], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_type")
+    @ExcludeMissing
+    fun _webhookType(): JsonField<WebhookType> = webhookType
+
+    /**
+     * Returns the raw JSON value of [webhookUrl].
+     *
+     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_url") @ExcludeMissing fun _webhookUrl(): JsonField<String> = webhookUrl
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [Webhook]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [Webhook]. */
+    class Builder internal constructor() {
+
+        private var apiKeyName: JsonField<String> = JsonMissing.of()
+        private var createdAt: JsonField<Long> = JsonMissing.of()
+        private var deprecatedAt: JsonField<Long> = JsonMissing.of()
+        private var failureCount: JsonField<Long> = JsonMissing.of()
+        private var integrationName: JsonField<String> = JsonMissing.of()
+        private var isActive: JsonField<Boolean> = JsonMissing.of()
+        private var lastTriggered: JsonField<Long> = JsonMissing.of()
+        private var scope: JsonField<Scope> = JsonMissing.of()
+        private var validUntil: JsonField<Long> = JsonMissing.of()
+        private var webhookId: JsonField<String> = JsonMissing.of()
+        private var webhookType: JsonField<WebhookType> = JsonMissing.of()
+        private var webhookUrl: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(webhook: Webhook) = apply {
+            apiKeyName = webhook.apiKeyName
+            createdAt = webhook.createdAt
+            deprecatedAt = webhook.deprecatedAt
+            failureCount = webhook.failureCount
+            integrationName = webhook.integrationName
+            isActive = webhook.isActive
+            lastTriggered = webhook.lastTriggered
+            scope = webhook.scope
+            validUntil = webhook.validUntil
+            webhookId = webhook.webhookId
+            webhookType = webhook.webhookType
+            webhookUrl = webhook.webhookUrl
+            additionalProperties = webhook.additionalProperties.toMutableMap()
+        }
+
+        /** Name of the API key (if scope is api_key) */
+        fun apiKeyName(apiKeyName: String?) = apiKeyName(JsonField.ofNullable(apiKeyName))
+
+        /** Alias for calling [Builder.apiKeyName] with `apiKeyName.orElse(null)`. */
+        fun apiKeyName(apiKeyName: Optional<String>) = apiKeyName(apiKeyName.getOrNull())
+
+        /**
+         * Sets [Builder.apiKeyName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.apiKeyName] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun apiKeyName(apiKeyName: JsonField<String>) = apply { this.apiKeyName = apiKeyName }
+
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        fun deprecatedAt(deprecatedAt: Long?) = deprecatedAt(JsonField.ofNullable(deprecatedAt))
+
+        /**
+         * Alias for [Builder.deprecatedAt].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun deprecatedAt(deprecatedAt: Long) = deprecatedAt(deprecatedAt as Long?)
+
+        /** Alias for calling [Builder.deprecatedAt] with `deprecatedAt.orElse(null)`. */
+        fun deprecatedAt(deprecatedAt: Optional<Long>) = deprecatedAt(deprecatedAt.getOrNull())
+
+        /**
+         * Sets [Builder.deprecatedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deprecatedAt] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun deprecatedAt(deprecatedAt: JsonField<Long>) = apply { this.deprecatedAt = deprecatedAt }
+
+        fun failureCount(failureCount: Long) = failureCount(JsonField.of(failureCount))
+
+        /**
+         * Sets [Builder.failureCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.failureCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun failureCount(failureCount: JsonField<Long>) = apply { this.failureCount = failureCount }
+
+        /** Name of the integration (if scope is integration) */
+        fun integrationName(integrationName: String?) =
+            integrationName(JsonField.ofNullable(integrationName))
+
+        /** Alias for calling [Builder.integrationName] with `integrationName.orElse(null)`. */
+        fun integrationName(integrationName: Optional<String>) =
+            integrationName(integrationName.getOrNull())
+
+        /**
+         * Sets [Builder.integrationName] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.integrationName] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun integrationName(integrationName: JsonField<String>) = apply {
+            this.integrationName = integrationName
+        }
+
+        /** Whether the webhook is active (not deprecated) */
+        fun isActive(isActive: Boolean) = isActive(JsonField.of(isActive))
+
+        /**
+         * Sets [Builder.isActive] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.isActive] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun isActive(isActive: JsonField<Boolean>) = apply { this.isActive = isActive }
+
+        fun lastTriggered(lastTriggered: Long?) = lastTriggered(JsonField.ofNullable(lastTriggered))
+
+        /**
+         * Alias for [Builder.lastTriggered].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun lastTriggered(lastTriggered: Long) = lastTriggered(lastTriggered as Long?)
+
+        /** Alias for calling [Builder.lastTriggered] with `lastTriggered.orElse(null)`. */
+        fun lastTriggered(lastTriggered: Optional<Long>) = lastTriggered(lastTriggered.getOrNull())
+
+        /**
+         * Sets [Builder.lastTriggered] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastTriggered] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun lastTriggered(lastTriggered: JsonField<Long>) = apply {
+            this.lastTriggered = lastTriggered
+        }
+
+        fun scope(scope: Scope) = scope(JsonField.of(scope))
+
+        /**
+         * Sets [Builder.scope] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.scope] with a well-typed [Scope] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun scope(scope: JsonField<Scope>) = apply { this.scope = scope }
+
+        /** -1 means no expiration */
+        fun validUntil(validUntil: Long) = validUntil(JsonField.of(validUntil))
+
+        /**
+         * Sets [Builder.validUntil] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.validUntil] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun validUntil(validUntil: JsonField<Long>) = apply { this.validUntil = validUntil }
+
+        fun webhookId(webhookId: String) = webhookId(JsonField.of(webhookId))
+
+        /**
+         * Sets [Builder.webhookId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookId(webhookId: JsonField<String>) = apply { this.webhookId = webhookId }
+
+        fun webhookType(webhookType: WebhookType) = webhookType(JsonField.of(webhookType))
+
+        /**
+         * Sets [Builder.webhookType] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookType] with a well-typed [WebhookType] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun webhookType(webhookType: JsonField<WebhookType>) = apply {
+            this.webhookType = webhookType
+        }
+
+        fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+
+        /**
+         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [Webhook].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): Webhook =
+            Webhook(
+                apiKeyName,
+                createdAt,
+                deprecatedAt,
+                failureCount,
+                integrationName,
+                isActive,
+                lastTriggered,
+                scope,
+                validUntil,
+                webhookId,
+                webhookType,
+                webhookUrl,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): Webhook = apply {
+        if (validated) {
+            return@apply
+        }
+
+        apiKeyName()
+        createdAt()
+        deprecatedAt()
+        failureCount()
+        integrationName()
+        isActive()
+        lastTriggered()
+        scope().ifPresent { it.validate() }
+        validUntil()
+        webhookId()
+        webhookType().ifPresent { it.validate() }
+        webhookUrl()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (apiKeyName.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (if (deprecatedAt.asKnown().isPresent) 1 else 0) +
+            (if (failureCount.asKnown().isPresent) 1 else 0) +
+            (if (integrationName.asKnown().isPresent) 1 else 0) +
+            (if (isActive.asKnown().isPresent) 1 else 0) +
+            (if (lastTriggered.asKnown().isPresent) 1 else 0) +
+            (scope.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (validUntil.asKnown().isPresent) 1 else 0) +
+            (if (webhookId.asKnown().isPresent) 1 else 0) +
+            (webhookType.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (webhookUrl.asKnown().isPresent) 1 else 0)
+
+    class Scope @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val API_KEY = of("api_key")
+
+            @JvmField val ORGANIZATION = of("organization")
+
+            @JvmField val INTEGRATION = of("integration")
+
+            @JvmStatic fun of(value: String) = Scope(JsonField.of(value))
+        }
+
+        /** An enum containing [Scope]'s known values. */
+        enum class Known {
+            API_KEY,
+            ORGANIZATION,
+            INTEGRATION,
+        }
+
+        /**
+         * An enum containing [Scope]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Scope] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            API_KEY,
+            ORGANIZATION,
+            INTEGRATION,
+            /** An enum member indicating that [Scope] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                API_KEY -> Value.API_KEY
+                ORGANIZATION -> Value.ORGANIZATION
+                INTEGRATION -> Value.INTEGRATION
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                API_KEY -> Known.API_KEY
+                ORGANIZATION -> Known.ORGANIZATION
+                INTEGRATION -> Known.INTEGRATION
+                else -> throw BlooioInvalidDataException("Unknown Scope: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Scope = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Scope && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class WebhookType @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val MESSAGE = of("message")
+
+            @JvmField val STATUS = of("status")
+
+            @JvmField val ALL = of("all")
+
+            @JvmStatic fun of(value: String) = WebhookType(JsonField.of(value))
+        }
+
+        /** An enum containing [WebhookType]'s known values. */
+        enum class Known {
+            MESSAGE,
+            STATUS,
+            ALL,
+        }
+
+        /**
+         * An enum containing [WebhookType]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [WebhookType] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            MESSAGE,
+            STATUS,
+            ALL,
+            /**
+             * An enum member indicating that [WebhookType] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                MESSAGE -> Value.MESSAGE
+                STATUS -> Value.STATUS
+                ALL -> Value.ALL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                MESSAGE -> Known.MESSAGE
+                STATUS -> Known.STATUS
+                ALL -> Known.ALL
+                else -> throw BlooioInvalidDataException("Unknown WebhookType: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): WebhookType = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is WebhookType && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is Webhook &&
+            apiKeyName == other.apiKeyName &&
+            createdAt == other.createdAt &&
+            deprecatedAt == other.deprecatedAt &&
+            failureCount == other.failureCount &&
+            integrationName == other.integrationName &&
+            isActive == other.isActive &&
+            lastTriggered == other.lastTriggered &&
+            scope == other.scope &&
+            validUntil == other.validUntil &&
+            webhookId == other.webhookId &&
+            webhookType == other.webhookType &&
+            webhookUrl == other.webhookUrl &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            apiKeyName,
+            createdAt,
+            deprecatedAt,
+            failureCount,
+            integrationName,
+            isActive,
+            lastTriggered,
+            scope,
+            validUntil,
+            webhookId,
+            webhookType,
+            webhookUrl,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "Webhook{apiKeyName=$apiKeyName, createdAt=$createdAt, deprecatedAt=$deprecatedAt, failureCount=$failureCount, integrationName=$integrationName, isActive=$isActive, lastTriggered=$lastTriggered, scope=$scope, validUntil=$validUntil, webhookId=$webhookId, webhookType=$webhookType, webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
new file mode 100644
index 0000000..7f70739
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
@@ -0,0 +1,700 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Create a new webhook subscription. */
+class WebhookCreateParams
+private constructor(
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /**
+     * URL to receive webhook events
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun webhookUrl(): String = body.webhookUrl()
+
+    /**
+     * Expiration timestamp (-1 for no expiration)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun validUntil(): Optional<Long> = body.validUntil()
+
+    /**
+     * Type of events to receive
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookType(): Optional<WebhookType> = body.webhookType()
+
+    /**
+     * Returns the raw JSON value of [webhookUrl].
+     *
+     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _webhookUrl(): JsonField<String> = body._webhookUrl()
+
+    /**
+     * Returns the raw JSON value of [validUntil].
+     *
+     * Unlike [validUntil], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _validUntil(): JsonField<Long> = body._validUntil()
+
+    /**
+     * Returns the raw JSON value of [webhookType].
+     *
+     * Unlike [webhookType], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _webhookType(): JsonField<WebhookType> = body._webhookType()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [WebhookCreateParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .webhookUrl()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookCreateParams]. */
+    class Builder internal constructor() {
+
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(webhookCreateParams: WebhookCreateParams) = apply {
+            body = webhookCreateParams.body.toBuilder()
+            additionalHeaders = webhookCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = webhookCreateParams.additionalQueryParams.toBuilder()
+        }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [webhookUrl]
+         * - [validUntil]
+         * - [webhookType]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** URL to receive webhook events */
+        fun webhookUrl(webhookUrl: String) = apply { body.webhookUrl(webhookUrl) }
+
+        /**
+         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookUrl(webhookUrl: JsonField<String>) = apply { body.webhookUrl(webhookUrl) }
+
+        /** Expiration timestamp (-1 for no expiration) */
+        fun validUntil(validUntil: Long) = apply { body.validUntil(validUntil) }
+
+        /**
+         * Sets [Builder.validUntil] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.validUntil] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun validUntil(validUntil: JsonField<Long>) = apply { body.validUntil(validUntil) }
+
+        /** Type of events to receive */
+        fun webhookType(webhookType: WebhookType) = apply { body.webhookType(webhookType) }
+
+        /**
+         * Sets [Builder.webhookType] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookType] with a well-typed [WebhookType] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun webhookType(webhookType: JsonField<WebhookType>) = apply {
+            body.webhookType(webhookType)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookCreateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .webhookUrl()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): WebhookCreateParams =
+            WebhookCreateParams(
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val webhookUrl: JsonField<String>,
+        private val validUntil: JsonField<Long>,
+        private val webhookType: JsonField<WebhookType>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("webhook_url")
+            @ExcludeMissing
+            webhookUrl: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("valid_until")
+            @ExcludeMissing
+            validUntil: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("webhook_type")
+            @ExcludeMissing
+            webhookType: JsonField<WebhookType> = JsonMissing.of(),
+        ) : this(webhookUrl, validUntil, webhookType, mutableMapOf())
+
+        /**
+         * URL to receive webhook events
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun webhookUrl(): String = webhookUrl.getRequired("webhook_url")
+
+        /**
+         * Expiration timestamp (-1 for no expiration)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun validUntil(): Optional<Long> = validUntil.getOptional("valid_until")
+
+        /**
+         * Type of events to receive
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun webhookType(): Optional<WebhookType> = webhookType.getOptional("webhook_type")
+
+        /**
+         * Returns the raw JSON value of [webhookUrl].
+         *
+         * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("webhook_url")
+        @ExcludeMissing
+        fun _webhookUrl(): JsonField<String> = webhookUrl
+
+        /**
+         * Returns the raw JSON value of [validUntil].
+         *
+         * Unlike [validUntil], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("valid_until") @ExcludeMissing fun _validUntil(): JsonField<Long> = validUntil
+
+        /**
+         * Returns the raw JSON value of [webhookType].
+         *
+         * Unlike [webhookType], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("webhook_type")
+        @ExcludeMissing
+        fun _webhookType(): JsonField<WebhookType> = webhookType
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .webhookUrl()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var webhookUrl: JsonField<String>? = null
+            private var validUntil: JsonField<Long> = JsonMissing.of()
+            private var webhookType: JsonField<WebhookType> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                webhookUrl = body.webhookUrl
+                validUntil = body.validUntil
+                webhookType = body.webhookType
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** URL to receive webhook events */
+            fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+
+            /**
+             * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.webhookUrl] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+
+            /** Expiration timestamp (-1 for no expiration) */
+            fun validUntil(validUntil: Long) = validUntil(JsonField.of(validUntil))
+
+            /**
+             * Sets [Builder.validUntil] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.validUntil] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun validUntil(validUntil: JsonField<Long>) = apply { this.validUntil = validUntil }
+
+            /** Type of events to receive */
+            fun webhookType(webhookType: WebhookType) = webhookType(JsonField.of(webhookType))
+
+            /**
+             * Sets [Builder.webhookType] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.webhookType] with a well-typed [WebhookType] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun webhookType(webhookType: JsonField<WebhookType>) = apply {
+                this.webhookType = webhookType
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .webhookUrl()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("webhookUrl", webhookUrl),
+                    validUntil,
+                    webhookType,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            webhookUrl()
+            validUntil()
+            webhookType().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (webhookUrl.asKnown().isPresent) 1 else 0) +
+                (if (validUntil.asKnown().isPresent) 1 else 0) +
+                (webhookType.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                webhookUrl == other.webhookUrl &&
+                validUntil == other.validUntil &&
+                webhookType == other.webhookType &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(webhookUrl, validUntil, webhookType, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{webhookUrl=$webhookUrl, validUntil=$validUntil, webhookType=$webhookType, additionalProperties=$additionalProperties}"
+    }
+
+    /** Type of events to receive */
+    class WebhookType @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val MESSAGE = of("message")
+
+            @JvmField val STATUS = of("status")
+
+            @JvmField val ALL = of("all")
+
+            @JvmStatic fun of(value: String) = WebhookType(JsonField.of(value))
+        }
+
+        /** An enum containing [WebhookType]'s known values. */
+        enum class Known {
+            MESSAGE,
+            STATUS,
+            ALL,
+        }
+
+        /**
+         * An enum containing [WebhookType]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [WebhookType] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            MESSAGE,
+            STATUS,
+            ALL,
+            /**
+             * An enum member indicating that [WebhookType] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                MESSAGE -> Value.MESSAGE
+                STATUS -> Value.STATUS
+                ALL -> Value.ALL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                MESSAGE -> Known.MESSAGE
+                STATUS -> Known.STATUS
+                ALL -> Known.ALL
+                else -> throw BlooioInvalidDataException("Unknown WebhookType: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): WebhookType = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is WebhookType && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookCreateParams &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "WebhookCreateParams{body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
new file mode 100644
index 0000000..8339d10
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
@@ -0,0 +1,384 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class WebhookCreateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val message: JsonField<String>,
+    private val scope: JsonField<Scope>,
+    private val webhookId: JsonField<String>,
+    private val webhookUrl: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("scope") @ExcludeMissing scope: JsonField<Scope> = JsonMissing.of(),
+        @JsonProperty("webhook_id") @ExcludeMissing webhookId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("webhook_url")
+        @ExcludeMissing
+        webhookUrl: JsonField<String> = JsonMissing.of(),
+    ) : this(message, scope, webhookId, webhookUrl, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun message(): Optional<String> = message.getOptional("message")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun scope(): Optional<Scope> = scope.getOptional("scope")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookId(): Optional<String> = webhookId.getOptional("webhook_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookUrl(): Optional<String> = webhookUrl.getOptional("webhook_url")
+
+    /**
+     * Returns the raw JSON value of [message].
+     *
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+    /**
+     * Returns the raw JSON value of [scope].
+     *
+     * Unlike [scope], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("scope") @ExcludeMissing fun _scope(): JsonField<Scope> = scope
+
+    /**
+     * Returns the raw JSON value of [webhookId].
+     *
+     * Unlike [webhookId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_id") @ExcludeMissing fun _webhookId(): JsonField<String> = webhookId
+
+    /**
+     * Returns the raw JSON value of [webhookUrl].
+     *
+     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_url") @ExcludeMissing fun _webhookUrl(): JsonField<String> = webhookUrl
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [WebhookCreateResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookCreateResponse]. */
+    class Builder internal constructor() {
+
+        private var message: JsonField<String> = JsonMissing.of()
+        private var scope: JsonField<Scope> = JsonMissing.of()
+        private var webhookId: JsonField<String> = JsonMissing.of()
+        private var webhookUrl: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(webhookCreateResponse: WebhookCreateResponse) = apply {
+            message = webhookCreateResponse.message
+            scope = webhookCreateResponse.scope
+            webhookId = webhookCreateResponse.webhookId
+            webhookUrl = webhookCreateResponse.webhookUrl
+            additionalProperties = webhookCreateResponse.additionalProperties.toMutableMap()
+        }
+
+        fun message(message: String) = message(JsonField.of(message))
+
+        /**
+         * Sets [Builder.message] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun message(message: JsonField<String>) = apply { this.message = message }
+
+        fun scope(scope: Scope) = scope(JsonField.of(scope))
+
+        /**
+         * Sets [Builder.scope] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.scope] with a well-typed [Scope] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun scope(scope: JsonField<Scope>) = apply { this.scope = scope }
+
+        fun webhookId(webhookId: String) = webhookId(JsonField.of(webhookId))
+
+        /**
+         * Sets [Builder.webhookId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookId(webhookId: JsonField<String>) = apply { this.webhookId = webhookId }
+
+        fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+
+        /**
+         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookCreateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): WebhookCreateResponse =
+            WebhookCreateResponse(
+                message,
+                scope,
+                webhookId,
+                webhookUrl,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): WebhookCreateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        message()
+        scope().ifPresent { it.validate() }
+        webhookId()
+        webhookUrl()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (message.asKnown().isPresent) 1 else 0) +
+            (scope.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (webhookId.asKnown().isPresent) 1 else 0) +
+            (if (webhookUrl.asKnown().isPresent) 1 else 0)
+
+    class Scope @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val API_KEY = of("api_key")
+
+            @JvmField val ORGANIZATION = of("organization")
+
+            @JvmStatic fun of(value: String) = Scope(JsonField.of(value))
+        }
+
+        /** An enum containing [Scope]'s known values. */
+        enum class Known {
+            API_KEY,
+            ORGANIZATION,
+        }
+
+        /**
+         * An enum containing [Scope]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Scope] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            API_KEY,
+            ORGANIZATION,
+            /** An enum member indicating that [Scope] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                API_KEY -> Value.API_KEY
+                ORGANIZATION -> Value.ORGANIZATION
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                API_KEY -> Known.API_KEY
+                ORGANIZATION -> Known.ORGANIZATION
+                else -> throw BlooioInvalidDataException("Unknown Scope: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Scope = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Scope && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookCreateResponse &&
+            message == other.message &&
+            scope == other.scope &&
+            webhookId == other.webhookId &&
+            webhookUrl == other.webhookUrl &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(message, scope, webhookId, webhookUrl, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "WebhookCreateResponse{message=$message, scope=$scope, webhookId=$webhookId, webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParams.kt
new file mode 100644
index 0000000..89b72f1
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParams.kt
@@ -0,0 +1,229 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Permanently delete a webhook. */
+class WebhookDeleteParams
+private constructor(
+    private val webhookId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): WebhookDeleteParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [WebhookDeleteParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookDeleteParams]. */
+    class Builder internal constructor() {
+
+        private var webhookId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(webhookDeleteParams: WebhookDeleteParams) = apply {
+            webhookId = webhookDeleteParams.webhookId
+            additionalHeaders = webhookDeleteParams.additionalHeaders.toBuilder()
+            additionalQueryParams = webhookDeleteParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = webhookDeleteParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun webhookId(webhookId: String?) = apply { this.webhookId = webhookId }
+
+        /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
+        fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookDeleteParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): WebhookDeleteParams =
+            WebhookDeleteParams(
+                webhookId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookDeleteParams &&
+            webhookId == other.webhookId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(webhookId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "WebhookDeleteParams{webhookId=$webhookId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
similarity index 70%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponse.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
index 6189e8e..8efbe99 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.config.webhook
+package com.blooio.api.models.webhooks
 
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
@@ -15,19 +15,19 @@ import java.util.Collections
 import java.util.Objects
 import java.util.Optional
 
-class WebhookUpdateResponse
+class WebhookDeleteResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val message: JsonField<String>,
-    private val status: JsonField<String>,
+    private val success: JsonField<Boolean>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
         @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("status") @ExcludeMissing status: JsonField<String> = JsonMissing.of(),
-    ) : this(message, status, mutableMapOf())
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(message, success, mutableMapOf())
 
     /**
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -39,7 +39,7 @@ private constructor(
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
-    fun status(): Optional<String> = status.getOptional("status")
+    fun success(): Optional<Boolean> = success.getOptional("success")
 
     /**
      * Returns the raw JSON value of [message].
@@ -49,11 +49,11 @@ private constructor(
     @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
 
     /**
-     * Returns the raw JSON value of [status].
+     * Returns the raw JSON value of [success].
      *
-     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<String> = status
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
 
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -69,22 +69,22 @@ private constructor(
 
     companion object {
 
-        /** Returns a mutable builder for constructing an instance of [WebhookUpdateResponse]. */
+        /** Returns a mutable builder for constructing an instance of [WebhookDeleteResponse]. */
         @JvmStatic fun builder() = Builder()
     }
 
-    /** A builder for [WebhookUpdateResponse]. */
+    /** A builder for [WebhookDeleteResponse]. */
     class Builder internal constructor() {
 
         private var message: JsonField<String> = JsonMissing.of()
-        private var status: JsonField<String> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
-        internal fun from(webhookUpdateResponse: WebhookUpdateResponse) = apply {
-            message = webhookUpdateResponse.message
-            status = webhookUpdateResponse.status
-            additionalProperties = webhookUpdateResponse.additionalProperties.toMutableMap()
+        internal fun from(webhookDeleteResponse: WebhookDeleteResponse) = apply {
+            message = webhookDeleteResponse.message
+            success = webhookDeleteResponse.success
+            additionalProperties = webhookDeleteResponse.additionalProperties.toMutableMap()
         }
 
         fun message(message: String) = message(JsonField.of(message))
@@ -97,15 +97,15 @@ private constructor(
          */
         fun message(message: JsonField<String>) = apply { this.message = message }
 
-        fun status(status: String) = status(JsonField.of(status))
+        fun success(success: Boolean) = success(JsonField.of(success))
 
         /**
-         * Sets [Builder.status] to an arbitrary JSON value.
+         * Sets [Builder.success] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.status] with a well-typed [String] value instead. This
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun status(status: JsonField<String>) = apply { this.status = status }
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -127,23 +127,23 @@ private constructor(
         }
 
         /**
-         * Returns an immutable instance of [WebhookUpdateResponse].
+         * Returns an immutable instance of [WebhookDeleteResponse].
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): WebhookUpdateResponse =
-            WebhookUpdateResponse(message, status, additionalProperties.toMutableMap())
+        fun build(): WebhookDeleteResponse =
+            WebhookDeleteResponse(message, success, additionalProperties.toMutableMap())
     }
 
     private var validated: Boolean = false
 
-    fun validate(): WebhookUpdateResponse = apply {
+    fun validate(): WebhookDeleteResponse = apply {
         if (validated) {
             return@apply
         }
 
         message()
-        status()
+        success()
         validated = true
     }
 
@@ -162,23 +162,23 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (if (message.asKnown().isPresent) 1 else 0) + (if (status.asKnown().isPresent) 1 else 0)
+        (if (message.asKnown().isPresent) 1 else 0) + (if (success.asKnown().isPresent) 1 else 0)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
         }
 
-        return other is WebhookUpdateResponse &&
+        return other is WebhookDeleteResponse &&
             message == other.message &&
-            status == other.status &&
+            success == other.success &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(message, status, additionalProperties) }
+    private val hashCode: Int by lazy { Objects.hash(message, success, additionalProperties) }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "WebhookUpdateResponse{message=$message, status=$status, additionalProperties=$additionalProperties}"
+        "WebhookDeleteResponse{message=$message, success=$success, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListParams.kt
new file mode 100644
index 0000000..b8bfcfc
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListParams.kt
@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import java.util.Objects
+
+/** List all webhooks for the organization. */
+class WebhookListParams
+private constructor(
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): WebhookListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [WebhookListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookListParams]. */
+    class Builder internal constructor() {
+
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(webhookListParams: WebhookListParams) = apply {
+            additionalHeaders = webhookListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = webhookListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): WebhookListParams =
+            WebhookListParams(additionalHeaders.build(), additionalQueryParams.build())
+    }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookListParams &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int = Objects.hash(additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "WebhookListParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
new file mode 100644
index 0000000..2a25bfb
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
@@ -0,0 +1,178 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class WebhookListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val webhooks: JsonField<List<Webhook>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("webhooks")
+        @ExcludeMissing
+        webhooks: JsonField<List<Webhook>> = JsonMissing.of()
+    ) : this(webhooks, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhooks(): Optional<List<Webhook>> = webhooks.getOptional("webhooks")
+
+    /**
+     * Returns the raw JSON value of [webhooks].
+     *
+     * Unlike [webhooks], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhooks") @ExcludeMissing fun _webhooks(): JsonField<List<Webhook>> = webhooks
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [WebhookListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookListResponse]. */
+    class Builder internal constructor() {
+
+        private var webhooks: JsonField<MutableList<Webhook>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(webhookListResponse: WebhookListResponse) = apply {
+            webhooks = webhookListResponse.webhooks.map { it.toMutableList() }
+            additionalProperties = webhookListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun webhooks(webhooks: List<Webhook>) = webhooks(JsonField.of(webhooks))
+
+        /**
+         * Sets [Builder.webhooks] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhooks] with a well-typed `List<Webhook>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun webhooks(webhooks: JsonField<List<Webhook>>) = apply {
+            this.webhooks = webhooks.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Webhook] to [webhooks].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addWebhook(webhook: Webhook) = apply {
+            webhooks =
+                (webhooks ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("webhooks", it).add(webhook)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): WebhookListResponse =
+            WebhookListResponse(
+                (webhooks ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): WebhookListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        webhooks().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (webhooks.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookListResponse &&
+            webhooks == other.webhooks &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(webhooks, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "WebhookListResponse{webhooks=$webhooks, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParams.kt
similarity index 83%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParams.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParams.kt
index 4d104de..e92f0e5 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParams.kt
@@ -1,19 +1,24 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.config.webhook
+package com.blooio.api.models.webhooks
 
 import com.blooio.api.core.Params
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.QueryParams
 import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
-/** Get the current webhook URL */
+/** Get details for a specific webhook. */
 class WebhookRetrieveParams
 private constructor(
+    private val webhookId: String?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
+    fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
+
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
 
@@ -33,15 +38,22 @@ private constructor(
     /** A builder for [WebhookRetrieveParams]. */
     class Builder internal constructor() {
 
+        private var webhookId: String? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
         internal fun from(webhookRetrieveParams: WebhookRetrieveParams) = apply {
+            webhookId = webhookRetrieveParams.webhookId
             additionalHeaders = webhookRetrieveParams.additionalHeaders.toBuilder()
             additionalQueryParams = webhookRetrieveParams.additionalQueryParams.toBuilder()
         }
 
+        fun webhookId(webhookId: String?) = apply { this.webhookId = webhookId }
+
+        /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
+        fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
+
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
             putAllAdditionalHeaders(additionalHeaders)
@@ -146,9 +158,19 @@ private constructor(
          * Further updates to this [Builder] will not mutate the returned instance.
          */
         fun build(): WebhookRetrieveParams =
-            WebhookRetrieveParams(additionalHeaders.build(), additionalQueryParams.build())
+            WebhookRetrieveParams(
+                webhookId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
     }
 
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId ?: ""
+            else -> ""
+        }
+
     override fun _headers(): Headers = additionalHeaders
 
     override fun _queryParams(): QueryParams = additionalQueryParams
@@ -159,12 +181,13 @@ private constructor(
         }
 
         return other is WebhookRetrieveParams &&
+            webhookId == other.webhookId &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int = Objects.hash(webhookId, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "WebhookRetrieveParams{additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "WebhookRetrieveParams{webhookId=$webhookId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
new file mode 100644
index 0000000..faca872
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
@@ -0,0 +1,685 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Update a webhook's configuration. */
+class WebhookUpdateParams
+private constructor(
+    private val webhookId: String?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
+
+    /**
+     * Set to true to deprecate, false to undeprecate
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deprecate(): Optional<Boolean> = body.deprecate()
+
+    /**
+     * Expiration timestamp. Use -1 or null for no expiration.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun validUntil(): Optional<Long> = body.validUntil()
+
+    /**
+     * Type of events to receive
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookType(): Optional<WebhookType> = body.webhookType()
+
+    /**
+     * Returns the raw JSON value of [deprecate].
+     *
+     * Unlike [deprecate], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _deprecate(): JsonField<Boolean> = body._deprecate()
+
+    /**
+     * Returns the raw JSON value of [validUntil].
+     *
+     * Unlike [validUntil], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _validUntil(): JsonField<Long> = body._validUntil()
+
+    /**
+     * Returns the raw JSON value of [webhookType].
+     *
+     * Unlike [webhookType], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _webhookType(): JsonField<WebhookType> = body._webhookType()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): WebhookUpdateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [WebhookUpdateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [WebhookUpdateParams]. */
+    class Builder internal constructor() {
+
+        private var webhookId: String? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(webhookUpdateParams: WebhookUpdateParams) = apply {
+            webhookId = webhookUpdateParams.webhookId
+            body = webhookUpdateParams.body.toBuilder()
+            additionalHeaders = webhookUpdateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = webhookUpdateParams.additionalQueryParams.toBuilder()
+        }
+
+        fun webhookId(webhookId: String?) = apply { this.webhookId = webhookId }
+
+        /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
+        fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [deprecate]
+         * - [validUntil]
+         * - [webhookType]
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /** Set to true to deprecate, false to undeprecate */
+        fun deprecate(deprecate: Boolean) = apply { body.deprecate(deprecate) }
+
+        /**
+         * Sets [Builder.deprecate] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deprecate] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun deprecate(deprecate: JsonField<Boolean>) = apply { body.deprecate(deprecate) }
+
+        /** Expiration timestamp. Use -1 or null for no expiration. */
+        fun validUntil(validUntil: Long) = apply { body.validUntil(validUntil) }
+
+        /**
+         * Sets [Builder.validUntil] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.validUntil] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun validUntil(validUntil: JsonField<Long>) = apply { body.validUntil(validUntil) }
+
+        /** Type of events to receive */
+        fun webhookType(webhookType: WebhookType) = apply { body.webhookType(webhookType) }
+
+        /**
+         * Sets [Builder.webhookType] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookType] with a well-typed [WebhookType] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun webhookType(webhookType: JsonField<WebhookType>) = apply {
+            body.webhookType(webhookType)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [WebhookUpdateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): WebhookUpdateParams =
+            WebhookUpdateParams(
+                webhookId,
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val deprecate: JsonField<Boolean>,
+        private val validUntil: JsonField<Long>,
+        private val webhookType: JsonField<WebhookType>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("deprecate")
+            @ExcludeMissing
+            deprecate: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("valid_until")
+            @ExcludeMissing
+            validUntil: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("webhook_type")
+            @ExcludeMissing
+            webhookType: JsonField<WebhookType> = JsonMissing.of(),
+        ) : this(deprecate, validUntil, webhookType, mutableMapOf())
+
+        /**
+         * Set to true to deprecate, false to undeprecate
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun deprecate(): Optional<Boolean> = deprecate.getOptional("deprecate")
+
+        /**
+         * Expiration timestamp. Use -1 or null for no expiration.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun validUntil(): Optional<Long> = validUntil.getOptional("valid_until")
+
+        /**
+         * Type of events to receive
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun webhookType(): Optional<WebhookType> = webhookType.getOptional("webhook_type")
+
+        /**
+         * Returns the raw JSON value of [deprecate].
+         *
+         * Unlike [deprecate], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("deprecate") @ExcludeMissing fun _deprecate(): JsonField<Boolean> = deprecate
+
+        /**
+         * Returns the raw JSON value of [validUntil].
+         *
+         * Unlike [validUntil], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("valid_until") @ExcludeMissing fun _validUntil(): JsonField<Long> = validUntil
+
+        /**
+         * Returns the raw JSON value of [webhookType].
+         *
+         * Unlike [webhookType], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("webhook_type")
+        @ExcludeMissing
+        fun _webhookType(): JsonField<WebhookType> = webhookType
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var deprecate: JsonField<Boolean> = JsonMissing.of()
+            private var validUntil: JsonField<Long> = JsonMissing.of()
+            private var webhookType: JsonField<WebhookType> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                deprecate = body.deprecate
+                validUntil = body.validUntil
+                webhookType = body.webhookType
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /** Set to true to deprecate, false to undeprecate */
+            fun deprecate(deprecate: Boolean) = deprecate(JsonField.of(deprecate))
+
+            /**
+             * Sets [Builder.deprecate] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.deprecate] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun deprecate(deprecate: JsonField<Boolean>) = apply { this.deprecate = deprecate }
+
+            /** Expiration timestamp. Use -1 or null for no expiration. */
+            fun validUntil(validUntil: Long) = validUntil(JsonField.of(validUntil))
+
+            /**
+             * Sets [Builder.validUntil] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.validUntil] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun validUntil(validUntil: JsonField<Long>) = apply { this.validUntil = validUntil }
+
+            /** Type of events to receive */
+            fun webhookType(webhookType: WebhookType) = webhookType(JsonField.of(webhookType))
+
+            /**
+             * Sets [Builder.webhookType] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.webhookType] with a well-typed [WebhookType] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun webhookType(webhookType: JsonField<WebhookType>) = apply {
+                this.webhookType = webhookType
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body =
+                Body(deprecate, validUntil, webhookType, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            deprecate()
+            validUntil()
+            webhookType().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (deprecate.asKnown().isPresent) 1 else 0) +
+                (if (validUntil.asKnown().isPresent) 1 else 0) +
+                (webhookType.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                deprecate == other.deprecate &&
+                validUntil == other.validUntil &&
+                webhookType == other.webhookType &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(deprecate, validUntil, webhookType, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{deprecate=$deprecate, validUntil=$validUntil, webhookType=$webhookType, additionalProperties=$additionalProperties}"
+    }
+
+    /** Type of events to receive */
+    class WebhookType @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val MESSAGE = of("message")
+
+            @JvmField val STATUS = of("status")
+
+            @JvmField val ALL = of("all")
+
+            @JvmStatic fun of(value: String) = WebhookType(JsonField.of(value))
+        }
+
+        /** An enum containing [WebhookType]'s known values. */
+        enum class Known {
+            MESSAGE,
+            STATUS,
+            ALL,
+        }
+
+        /**
+         * An enum containing [WebhookType]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [WebhookType] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            MESSAGE,
+            STATUS,
+            ALL,
+            /**
+             * An enum member indicating that [WebhookType] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                MESSAGE -> Value.MESSAGE
+                STATUS -> Value.STATUS
+                ALL -> Value.ALL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                MESSAGE -> Known.MESSAGE
+                STATUS -> Known.STATUS
+                ALL -> Known.ALL
+                else -> throw BlooioInvalidDataException("Unknown WebhookType: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): WebhookType = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is WebhookType && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is WebhookUpdateParams &&
+            webhookId == other.webhookId &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(webhookId, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "WebhookUpdateParams{webhookId=$webhookId, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
new file mode 100644
index 0000000..dac42c3
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
@@ -0,0 +1,464 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonCreator
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** List delivery logs for a specific webhook. */
+class LogListParams
+private constructor(
+    private val webhookId: String?,
+    private val limit: Long?,
+    private val maxStatus: Long?,
+    private val minStatus: Long?,
+    private val offset: Long?,
+    private val sort: Sort?,
+    private val status: Long?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
+
+    /** Maximum number of items to return (1-200) */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /** Maximum HTTP status code */
+    fun maxStatus(): Optional<Long> = Optional.ofNullable(maxStatus)
+
+    /** Minimum HTTP status code */
+    fun minStatus(): Optional<Long> = Optional.ofNullable(minStatus)
+
+    /** Number of items to skip */
+    fun offset(): Optional<Long> = Optional.ofNullable(offset)
+
+    /** Sort order by attempted time */
+    fun sort(): Optional<Sort> = Optional.ofNullable(sort)
+
+    /** Filter by exact HTTP status code */
+    fun status(): Optional<Long> = Optional.ofNullable(status)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): LogListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [LogListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LogListParams]. */
+    class Builder internal constructor() {
+
+        private var webhookId: String? = null
+        private var limit: Long? = null
+        private var maxStatus: Long? = null
+        private var minStatus: Long? = null
+        private var offset: Long? = null
+        private var sort: Sort? = null
+        private var status: Long? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(logListParams: LogListParams) = apply {
+            webhookId = logListParams.webhookId
+            limit = logListParams.limit
+            maxStatus = logListParams.maxStatus
+            minStatus = logListParams.minStatus
+            offset = logListParams.offset
+            sort = logListParams.sort
+            status = logListParams.status
+            additionalHeaders = logListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = logListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun webhookId(webhookId: String?) = apply { this.webhookId = webhookId }
+
+        /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
+        fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
+
+        /** Maximum number of items to return (1-200) */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /** Maximum HTTP status code */
+        fun maxStatus(maxStatus: Long?) = apply { this.maxStatus = maxStatus }
+
+        /**
+         * Alias for [Builder.maxStatus].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxStatus(maxStatus: Long) = maxStatus(maxStatus as Long?)
+
+        /** Alias for calling [Builder.maxStatus] with `maxStatus.orElse(null)`. */
+        fun maxStatus(maxStatus: Optional<Long>) = maxStatus(maxStatus.getOrNull())
+
+        /** Minimum HTTP status code */
+        fun minStatus(minStatus: Long?) = apply { this.minStatus = minStatus }
+
+        /**
+         * Alias for [Builder.minStatus].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun minStatus(minStatus: Long) = minStatus(minStatus as Long?)
+
+        /** Alias for calling [Builder.minStatus] with `minStatus.orElse(null)`. */
+        fun minStatus(minStatus: Optional<Long>) = minStatus(minStatus.getOrNull())
+
+        /** Number of items to skip */
+        fun offset(offset: Long?) = apply { this.offset = offset }
+
+        /**
+         * Alias for [Builder.offset].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun offset(offset: Long) = offset(offset as Long?)
+
+        /** Alias for calling [Builder.offset] with `offset.orElse(null)`. */
+        fun offset(offset: Optional<Long>) = offset(offset.getOrNull())
+
+        /** Sort order by attempted time */
+        fun sort(sort: Sort?) = apply { this.sort = sort }
+
+        /** Alias for calling [Builder.sort] with `sort.orElse(null)`. */
+        fun sort(sort: Optional<Sort>) = sort(sort.getOrNull())
+
+        /** Filter by exact HTTP status code */
+        fun status(status: Long?) = apply { this.status = status }
+
+        /**
+         * Alias for [Builder.status].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun status(status: Long) = status(status as Long?)
+
+        /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+        fun status(status: Optional<Long>) = status(status.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [LogListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): LogListParams =
+            LogListParams(
+                webhookId,
+                limit,
+                maxStatus,
+                minStatus,
+                offset,
+                sort,
+                status,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                limit?.let { put("limit", it.toString()) }
+                maxStatus?.let { put("max_status", it.toString()) }
+                minStatus?.let { put("min_status", it.toString()) }
+                offset?.let { put("offset", it.toString()) }
+                sort?.let { put("sort", it.toString()) }
+                status?.let { put("status", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    /** Sort order by attempted time */
+    class Sort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val ASC = of("asc")
+
+            @JvmField val DESC = of("desc")
+
+            @JvmStatic fun of(value: String) = Sort(JsonField.of(value))
+        }
+
+        /** An enum containing [Sort]'s known values. */
+        enum class Known {
+            ASC,
+            DESC,
+        }
+
+        /**
+         * An enum containing [Sort]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Sort] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            ASC,
+            DESC,
+            /** An enum member indicating that [Sort] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                ASC -> Value.ASC
+                DESC -> Value.DESC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                ASC -> Known.ASC
+                DESC -> Known.DESC
+                else -> throw BlooioInvalidDataException("Unknown Sort: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        fun validate(): Sort = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Sort && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LogListParams &&
+            webhookId == other.webhookId &&
+            limit == other.limit &&
+            maxStatus == other.maxStatus &&
+            minStatus == other.minStatus &&
+            offset == other.offset &&
+            sort == other.sort &&
+            status == other.status &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            webhookId,
+            limit,
+            maxStatus,
+            minStatus,
+            offset,
+            sort,
+            status,
+            additionalHeaders,
+            additionalQueryParams,
+        )
+
+    override fun toString() =
+        "LogListParams{webhookId=$webhookId, limit=$limit, maxStatus=$maxStatus, minStatus=$minStatus, offset=$offset, sort=$sort, status=$status, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
new file mode 100644
index 0000000..6b9e42e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
@@ -0,0 +1,3190 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.Enum
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.checkKnown
+import com.blooio.api.core.toImmutable
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class LogListResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val logs: JsonField<List<Log>>,
+    private val pagination: JsonField<Pagination>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("logs") @ExcludeMissing logs: JsonField<List<Log>> = JsonMissing.of(),
+        @JsonProperty("pagination")
+        @ExcludeMissing
+        pagination: JsonField<Pagination> = JsonMissing.of(),
+    ) : this(logs, pagination, mutableMapOf())
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun logs(): Optional<List<Log>> = logs.getOptional("logs")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun pagination(): Optional<Pagination> = pagination.getOptional("pagination")
+
+    /**
+     * Returns the raw JSON value of [logs].
+     *
+     * Unlike [logs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("logs") @ExcludeMissing fun _logs(): JsonField<List<Log>> = logs
+
+    /**
+     * Returns the raw JSON value of [pagination].
+     *
+     * Unlike [pagination], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("pagination")
+    @ExcludeMissing
+    fun _pagination(): JsonField<Pagination> = pagination
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [LogListResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LogListResponse]. */
+    class Builder internal constructor() {
+
+        private var logs: JsonField<MutableList<Log>>? = null
+        private var pagination: JsonField<Pagination> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(logListResponse: LogListResponse) = apply {
+            logs = logListResponse.logs.map { it.toMutableList() }
+            pagination = logListResponse.pagination
+            additionalProperties = logListResponse.additionalProperties.toMutableMap()
+        }
+
+        fun logs(logs: List<Log>) = logs(JsonField.of(logs))
+
+        /**
+         * Sets [Builder.logs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.logs] with a well-typed `List<Log>` value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun logs(logs: JsonField<List<Log>>) = apply { this.logs = logs.map { it.toMutableList() } }
+
+        /**
+         * Adds a single [Log] to [logs].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addLog(log: Log) = apply {
+            logs = (logs ?: JsonField.of(mutableListOf())).also { checkKnown("logs", it).add(log) }
+        }
+
+        fun pagination(pagination: Pagination) = pagination(JsonField.of(pagination))
+
+        /**
+         * Sets [Builder.pagination] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pagination] with a well-typed [Pagination] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun pagination(pagination: JsonField<Pagination>) = apply { this.pagination = pagination }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [LogListResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): LogListResponse =
+            LogListResponse(
+                (logs ?: JsonMissing.of()).map { it.toImmutable() },
+                pagination,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): LogListResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        logs().ifPresent { it.forEach { it.validate() } }
+        pagination().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (logs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (pagination.asKnown().getOrNull()?.validity() ?: 0)
+
+    class Log
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val attemptedTime: JsonField<Long>,
+        private val eventBody: JsonField<EventBody>,
+        private val eventId: JsonField<String>,
+        private val metadata: JsonField<Metadata>,
+        private val responseJson: JsonValue,
+        private val responseReceivedAt: JsonField<Long>,
+        private val responseStatus: JsonField<Long>,
+        private val scope: JsonField<Scope>,
+        private val webhookUrl: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("attempted_time")
+            @ExcludeMissing
+            attemptedTime: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("event_body")
+            @ExcludeMissing
+            eventBody: JsonField<EventBody> = JsonMissing.of(),
+            @JsonProperty("event_id") @ExcludeMissing eventId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("metadata")
+            @ExcludeMissing
+            metadata: JsonField<Metadata> = JsonMissing.of(),
+            @JsonProperty("response_json")
+            @ExcludeMissing
+            responseJson: JsonValue = JsonMissing.of(),
+            @JsonProperty("response_received_at")
+            @ExcludeMissing
+            responseReceivedAt: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("response_status")
+            @ExcludeMissing
+            responseStatus: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("scope") @ExcludeMissing scope: JsonField<Scope> = JsonMissing.of(),
+            @JsonProperty("webhook_url")
+            @ExcludeMissing
+            webhookUrl: JsonField<String> = JsonMissing.of(),
+        ) : this(
+            attemptedTime,
+            eventBody,
+            eventId,
+            metadata,
+            responseJson,
+            responseReceivedAt,
+            responseStatus,
+            scope,
+            webhookUrl,
+            mutableMapOf(),
+        )
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun attemptedTime(): Optional<Long> = attemptedTime.getOptional("attempted_time")
+
+        /**
+         * Webhook event payload. Structure varies by event type. All message events include group
+         * information when applicable.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun eventBody(): Optional<EventBody> = eventBody.getOptional("event_body")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun eventId(): Optional<String> = eventId.getOptional("event_id")
+
+        /**
+         * Additional metadata about the webhook delivery
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun metadata(): Optional<Metadata> = metadata.getOptional("metadata")
+
+        /**
+         * Response body from the webhook endpoint (if JSON)
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = log.responseJson().convert(MyClass.class);
+         * ```
+         */
+        @JsonProperty("response_json") @ExcludeMissing fun _responseJson(): JsonValue = responseJson
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun responseReceivedAt(): Optional<Long> =
+            responseReceivedAt.getOptional("response_received_at")
+
+        /**
+         * HTTP status code received from the webhook endpoint
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun responseStatus(): Optional<Long> = responseStatus.getOptional("response_status")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun scope(): Optional<Scope> = scope.getOptional("scope")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun webhookUrl(): Optional<String> = webhookUrl.getOptional("webhook_url")
+
+        /**
+         * Returns the raw JSON value of [attemptedTime].
+         *
+         * Unlike [attemptedTime], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("attempted_time")
+        @ExcludeMissing
+        fun _attemptedTime(): JsonField<Long> = attemptedTime
+
+        /**
+         * Returns the raw JSON value of [eventBody].
+         *
+         * Unlike [eventBody], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("event_body")
+        @ExcludeMissing
+        fun _eventBody(): JsonField<EventBody> = eventBody
+
+        /**
+         * Returns the raw JSON value of [eventId].
+         *
+         * Unlike [eventId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("event_id") @ExcludeMissing fun _eventId(): JsonField<String> = eventId
+
+        /**
+         * Returns the raw JSON value of [metadata].
+         *
+         * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonField<Metadata> = metadata
+
+        /**
+         * Returns the raw JSON value of [responseReceivedAt].
+         *
+         * Unlike [responseReceivedAt], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("response_received_at")
+        @ExcludeMissing
+        fun _responseReceivedAt(): JsonField<Long> = responseReceivedAt
+
+        /**
+         * Returns the raw JSON value of [responseStatus].
+         *
+         * Unlike [responseStatus], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("response_status")
+        @ExcludeMissing
+        fun _responseStatus(): JsonField<Long> = responseStatus
+
+        /**
+         * Returns the raw JSON value of [scope].
+         *
+         * Unlike [scope], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("scope") @ExcludeMissing fun _scope(): JsonField<Scope> = scope
+
+        /**
+         * Returns the raw JSON value of [webhookUrl].
+         *
+         * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("webhook_url")
+        @ExcludeMissing
+        fun _webhookUrl(): JsonField<String> = webhookUrl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Log]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Log]. */
+        class Builder internal constructor() {
+
+            private var attemptedTime: JsonField<Long> = JsonMissing.of()
+            private var eventBody: JsonField<EventBody> = JsonMissing.of()
+            private var eventId: JsonField<String> = JsonMissing.of()
+            private var metadata: JsonField<Metadata> = JsonMissing.of()
+            private var responseJson: JsonValue = JsonMissing.of()
+            private var responseReceivedAt: JsonField<Long> = JsonMissing.of()
+            private var responseStatus: JsonField<Long> = JsonMissing.of()
+            private var scope: JsonField<Scope> = JsonMissing.of()
+            private var webhookUrl: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(log: Log) = apply {
+                attemptedTime = log.attemptedTime
+                eventBody = log.eventBody
+                eventId = log.eventId
+                metadata = log.metadata
+                responseJson = log.responseJson
+                responseReceivedAt = log.responseReceivedAt
+                responseStatus = log.responseStatus
+                scope = log.scope
+                webhookUrl = log.webhookUrl
+                additionalProperties = log.additionalProperties.toMutableMap()
+            }
+
+            fun attemptedTime(attemptedTime: Long) = attemptedTime(JsonField.of(attemptedTime))
+
+            /**
+             * Sets [Builder.attemptedTime] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.attemptedTime] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun attemptedTime(attemptedTime: JsonField<Long>) = apply {
+                this.attemptedTime = attemptedTime
+            }
+
+            /**
+             * Webhook event payload. Structure varies by event type. All message events include
+             * group information when applicable.
+             */
+            fun eventBody(eventBody: EventBody) = eventBody(JsonField.of(eventBody))
+
+            /**
+             * Sets [Builder.eventBody] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.eventBody] with a well-typed [EventBody] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun eventBody(eventBody: JsonField<EventBody>) = apply { this.eventBody = eventBody }
+
+            fun eventId(eventId: String) = eventId(JsonField.of(eventId))
+
+            /**
+             * Sets [Builder.eventId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.eventId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun eventId(eventId: JsonField<String>) = apply { this.eventId = eventId }
+
+            /** Additional metadata about the webhook delivery */
+            fun metadata(metadata: Metadata) = metadata(JsonField.of(metadata))
+
+            /**
+             * Sets [Builder.metadata] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.metadata] with a well-typed [Metadata] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun metadata(metadata: JsonField<Metadata>) = apply { this.metadata = metadata }
+
+            /** Response body from the webhook endpoint (if JSON) */
+            fun responseJson(responseJson: JsonValue) = apply { this.responseJson = responseJson }
+
+            fun responseReceivedAt(responseReceivedAt: Long?) =
+                responseReceivedAt(JsonField.ofNullable(responseReceivedAt))
+
+            /**
+             * Alias for [Builder.responseReceivedAt].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun responseReceivedAt(responseReceivedAt: Long) =
+                responseReceivedAt(responseReceivedAt as Long?)
+
+            /**
+             * Alias for calling [Builder.responseReceivedAt] with
+             * `responseReceivedAt.orElse(null)`.
+             */
+            fun responseReceivedAt(responseReceivedAt: Optional<Long>) =
+                responseReceivedAt(responseReceivedAt.getOrNull())
+
+            /**
+             * Sets [Builder.responseReceivedAt] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.responseReceivedAt] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun responseReceivedAt(responseReceivedAt: JsonField<Long>) = apply {
+                this.responseReceivedAt = responseReceivedAt
+            }
+
+            /** HTTP status code received from the webhook endpoint */
+            fun responseStatus(responseStatus: Long?) =
+                responseStatus(JsonField.ofNullable(responseStatus))
+
+            /**
+             * Alias for [Builder.responseStatus].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun responseStatus(responseStatus: Long) = responseStatus(responseStatus as Long?)
+
+            /** Alias for calling [Builder.responseStatus] with `responseStatus.orElse(null)`. */
+            fun responseStatus(responseStatus: Optional<Long>) =
+                responseStatus(responseStatus.getOrNull())
+
+            /**
+             * Sets [Builder.responseStatus] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.responseStatus] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun responseStatus(responseStatus: JsonField<Long>) = apply {
+                this.responseStatus = responseStatus
+            }
+
+            fun scope(scope: Scope) = scope(JsonField.of(scope))
+
+            /**
+             * Sets [Builder.scope] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.scope] with a well-typed [Scope] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun scope(scope: JsonField<Scope>) = apply { this.scope = scope }
+
+            fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+
+            /**
+             * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.webhookUrl] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Log].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Log =
+                Log(
+                    attemptedTime,
+                    eventBody,
+                    eventId,
+                    metadata,
+                    responseJson,
+                    responseReceivedAt,
+                    responseStatus,
+                    scope,
+                    webhookUrl,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Log = apply {
+            if (validated) {
+                return@apply
+            }
+
+            attemptedTime()
+            eventBody().ifPresent { it.validate() }
+            eventId()
+            metadata().ifPresent { it.validate() }
+            responseReceivedAt()
+            responseStatus()
+            scope().ifPresent { it.validate() }
+            webhookUrl()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (attemptedTime.asKnown().isPresent) 1 else 0) +
+                (eventBody.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (eventId.asKnown().isPresent) 1 else 0) +
+                (metadata.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (responseReceivedAt.asKnown().isPresent) 1 else 0) +
+                (if (responseStatus.asKnown().isPresent) 1 else 0) +
+                (scope.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (webhookUrl.asKnown().isPresent) 1 else 0)
+
+        /**
+         * Webhook event payload. Structure varies by event type. All message events include group
+         * information when applicable.
+         */
+        class EventBody
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val attachments: JsonField<List<Attachment>>,
+            private val deliveredAt: JsonField<Long>,
+            private val errorCode: JsonField<String>,
+            private val errorMessage: JsonField<String>,
+            private val event: JsonField<String>,
+            private val externalId: JsonField<String>,
+            private val groupId: JsonField<String>,
+            private val groupName: JsonField<String>,
+            private val internalId: JsonField<String>,
+            private val isGroup: JsonField<Boolean>,
+            private val messageId: JsonField<String>,
+            private val participants: JsonField<List<Participant>>,
+            private val protocol: JsonField<Protocol>,
+            private val readAt: JsonField<Long>,
+            private val sender: JsonField<String>,
+            private val sentAt: JsonField<Long>,
+            private val status: JsonField<Status>,
+            private val text: JsonField<String>,
+            private val timestamp: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("attachments")
+                @ExcludeMissing
+                attachments: JsonField<List<Attachment>> = JsonMissing.of(),
+                @JsonProperty("delivered_at")
+                @ExcludeMissing
+                deliveredAt: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("error_code")
+                @ExcludeMissing
+                errorCode: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("error_message")
+                @ExcludeMissing
+                errorMessage: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("event") @ExcludeMissing event: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("external_id")
+                @ExcludeMissing
+                externalId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("group_id")
+                @ExcludeMissing
+                groupId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("group_name")
+                @ExcludeMissing
+                groupName: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("internal_id")
+                @ExcludeMissing
+                internalId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("is_group")
+                @ExcludeMissing
+                isGroup: JsonField<Boolean> = JsonMissing.of(),
+                @JsonProperty("message_id")
+                @ExcludeMissing
+                messageId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("participants")
+                @ExcludeMissing
+                participants: JsonField<List<Participant>> = JsonMissing.of(),
+                @JsonProperty("protocol")
+                @ExcludeMissing
+                protocol: JsonField<Protocol> = JsonMissing.of(),
+                @JsonProperty("read_at") @ExcludeMissing readAt: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("sender")
+                @ExcludeMissing
+                sender: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("sent_at") @ExcludeMissing sentAt: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("status")
+                @ExcludeMissing
+                status: JsonField<Status> = JsonMissing.of(),
+                @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("timestamp")
+                @ExcludeMissing
+                timestamp: JsonField<Long> = JsonMissing.of(),
+            ) : this(
+                attachments,
+                deliveredAt,
+                errorCode,
+                errorMessage,
+                event,
+                externalId,
+                groupId,
+                groupName,
+                internalId,
+                isGroup,
+                messageId,
+                participants,
+                protocol,
+                readAt,
+                sender,
+                sentAt,
+                status,
+                text,
+                timestamp,
+                mutableMapOf(),
+            )
+
+            /**
+             * Array of attachment objects
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun attachments(): Optional<List<Attachment>> = attachments.getOptional("attachments")
+
+            /**
+             * Timestamp when message was delivered (for message.delivered events)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun deliveredAt(): Optional<Long> = deliveredAt.getOptional("delivered_at")
+
+            /**
+             * Error code (for message.failed events)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun errorCode(): Optional<String> = errorCode.getOptional("error_code")
+
+            /**
+             * Error description (for message.failed events)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun errorMessage(): Optional<String> = errorMessage.getOptional("error_message")
+
+            /**
+             * Event type (e.g., message.received, message.sent, message.delivered, message.failed,
+             * message.read)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun event(): Optional<String> = event.getOptional("event")
+
+            /**
+             * Recipient identifier (phone number, email, or group ID)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun externalId(): Optional<String> = externalId.getOptional("external_id")
+
+            /**
+             * Group ID (only present when is_group=true)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun groupId(): Optional<String> = groupId.getOptional("group_id")
+
+            /**
+             * Group display name (only present when is_group=true)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun groupName(): Optional<String> = groupName.getOptional("group_name")
+
+            /**
+             * Phone number that sent/received the message
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun internalId(): Optional<String> = internalId.getOptional("internal_id")
+
+            /**
+             * Whether this message is from/to a group chat. Always present.
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun isGroup(): Optional<Boolean> = isGroup.getOptional("is_group")
+
+            /**
+             * Unique message identifier
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+            /**
+             * Array of group participants (only present when is_group=true)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun participants(): Optional<List<Participant>> =
+                participants.getOptional("participants")
+
+            /**
+             * Message protocol
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun protocol(): Optional<Protocol> = protocol.getOptional("protocol")
+
+            /**
+             * Timestamp when message was read (for message.read events)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun readAt(): Optional<Long> = readAt.getOptional("read_at")
+
+            /**
+             * Sender identifier (for inbound messages)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun sender(): Optional<String> = sender.getOptional("sender")
+
+            /**
+             * Timestamp when message was sent (for message.sent events)
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun sentAt(): Optional<Long> = sentAt.getOptional("sent_at")
+
+            /**
+             * Message status
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun status(): Optional<Status> = status.getOptional("status")
+
+            /**
+             * Message text content
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun text(): Optional<String> = text.getOptional("text")
+
+            /**
+             * Event timestamp in milliseconds
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timestamp(): Optional<Long> = timestamp.getOptional("timestamp")
+
+            /**
+             * Returns the raw JSON value of [attachments].
+             *
+             * Unlike [attachments], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("attachments")
+            @ExcludeMissing
+            fun _attachments(): JsonField<List<Attachment>> = attachments
+
+            /**
+             * Returns the raw JSON value of [deliveredAt].
+             *
+             * Unlike [deliveredAt], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("delivered_at")
+            @ExcludeMissing
+            fun _deliveredAt(): JsonField<Long> = deliveredAt
+
+            /**
+             * Returns the raw JSON value of [errorCode].
+             *
+             * Unlike [errorCode], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("error_code")
+            @ExcludeMissing
+            fun _errorCode(): JsonField<String> = errorCode
+
+            /**
+             * Returns the raw JSON value of [errorMessage].
+             *
+             * Unlike [errorMessage], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("error_message")
+            @ExcludeMissing
+            fun _errorMessage(): JsonField<String> = errorMessage
+
+            /**
+             * Returns the raw JSON value of [event].
+             *
+             * Unlike [event], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("event") @ExcludeMissing fun _event(): JsonField<String> = event
+
+            /**
+             * Returns the raw JSON value of [externalId].
+             *
+             * Unlike [externalId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("external_id")
+            @ExcludeMissing
+            fun _externalId(): JsonField<String> = externalId
+
+            /**
+             * Returns the raw JSON value of [groupId].
+             *
+             * Unlike [groupId], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("group_id") @ExcludeMissing fun _groupId(): JsonField<String> = groupId
+
+            /**
+             * Returns the raw JSON value of [groupName].
+             *
+             * Unlike [groupName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("group_name")
+            @ExcludeMissing
+            fun _groupName(): JsonField<String> = groupName
+
+            /**
+             * Returns the raw JSON value of [internalId].
+             *
+             * Unlike [internalId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("internal_id")
+            @ExcludeMissing
+            fun _internalId(): JsonField<String> = internalId
+
+            /**
+             * Returns the raw JSON value of [isGroup].
+             *
+             * Unlike [isGroup], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("is_group") @ExcludeMissing fun _isGroup(): JsonField<Boolean> = isGroup
+
+            /**
+             * Returns the raw JSON value of [messageId].
+             *
+             * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            fun _messageId(): JsonField<String> = messageId
+
+            /**
+             * Returns the raw JSON value of [participants].
+             *
+             * Unlike [participants], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("participants")
+            @ExcludeMissing
+            fun _participants(): JsonField<List<Participant>> = participants
+
+            /**
+             * Returns the raw JSON value of [protocol].
+             *
+             * Unlike [protocol], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("protocol")
+            @ExcludeMissing
+            fun _protocol(): JsonField<Protocol> = protocol
+
+            /**
+             * Returns the raw JSON value of [readAt].
+             *
+             * Unlike [readAt], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("read_at") @ExcludeMissing fun _readAt(): JsonField<Long> = readAt
+
+            /**
+             * Returns the raw JSON value of [sender].
+             *
+             * Unlike [sender], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("sender") @ExcludeMissing fun _sender(): JsonField<String> = sender
+
+            /**
+             * Returns the raw JSON value of [sentAt].
+             *
+             * Unlike [sentAt], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("sent_at") @ExcludeMissing fun _sentAt(): JsonField<Long> = sentAt
+
+            /**
+             * Returns the raw JSON value of [status].
+             *
+             * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+            /**
+             * Returns the raw JSON value of [text].
+             *
+             * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+            /**
+             * Returns the raw JSON value of [timestamp].
+             *
+             * Unlike [timestamp], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timestamp") @ExcludeMissing fun _timestamp(): JsonField<Long> = timestamp
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [EventBody]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [EventBody]. */
+            class Builder internal constructor() {
+
+                private var attachments: JsonField<MutableList<Attachment>>? = null
+                private var deliveredAt: JsonField<Long> = JsonMissing.of()
+                private var errorCode: JsonField<String> = JsonMissing.of()
+                private var errorMessage: JsonField<String> = JsonMissing.of()
+                private var event: JsonField<String> = JsonMissing.of()
+                private var externalId: JsonField<String> = JsonMissing.of()
+                private var groupId: JsonField<String> = JsonMissing.of()
+                private var groupName: JsonField<String> = JsonMissing.of()
+                private var internalId: JsonField<String> = JsonMissing.of()
+                private var isGroup: JsonField<Boolean> = JsonMissing.of()
+                private var messageId: JsonField<String> = JsonMissing.of()
+                private var participants: JsonField<MutableList<Participant>>? = null
+                private var protocol: JsonField<Protocol> = JsonMissing.of()
+                private var readAt: JsonField<Long> = JsonMissing.of()
+                private var sender: JsonField<String> = JsonMissing.of()
+                private var sentAt: JsonField<Long> = JsonMissing.of()
+                private var status: JsonField<Status> = JsonMissing.of()
+                private var text: JsonField<String> = JsonMissing.of()
+                private var timestamp: JsonField<Long> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(eventBody: EventBody) = apply {
+                    attachments = eventBody.attachments.map { it.toMutableList() }
+                    deliveredAt = eventBody.deliveredAt
+                    errorCode = eventBody.errorCode
+                    errorMessage = eventBody.errorMessage
+                    event = eventBody.event
+                    externalId = eventBody.externalId
+                    groupId = eventBody.groupId
+                    groupName = eventBody.groupName
+                    internalId = eventBody.internalId
+                    isGroup = eventBody.isGroup
+                    messageId = eventBody.messageId
+                    participants = eventBody.participants.map { it.toMutableList() }
+                    protocol = eventBody.protocol
+                    readAt = eventBody.readAt
+                    sender = eventBody.sender
+                    sentAt = eventBody.sentAt
+                    status = eventBody.status
+                    text = eventBody.text
+                    timestamp = eventBody.timestamp
+                    additionalProperties = eventBody.additionalProperties.toMutableMap()
+                }
+
+                /** Array of attachment objects */
+                fun attachments(attachments: List<Attachment>?) =
+                    attachments(JsonField.ofNullable(attachments))
+
+                /** Alias for calling [Builder.attachments] with `attachments.orElse(null)`. */
+                fun attachments(attachments: Optional<List<Attachment>>) =
+                    attachments(attachments.getOrNull())
+
+                /**
+                 * Sets [Builder.attachments] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.attachments] with a well-typed
+                 * `List<Attachment>` value instead. This method is primarily for setting the field
+                 * to an undocumented or not yet supported value.
+                 */
+                fun attachments(attachments: JsonField<List<Attachment>>) = apply {
+                    this.attachments = attachments.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Attachment] to [attachments].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addAttachment(attachment: Attachment) = apply {
+                    attachments =
+                        (attachments ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("attachments", it).add(attachment)
+                        }
+                }
+
+                /** Timestamp when message was delivered (for message.delivered events) */
+                fun deliveredAt(deliveredAt: Long?) = deliveredAt(JsonField.ofNullable(deliveredAt))
+
+                /**
+                 * Alias for [Builder.deliveredAt].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun deliveredAt(deliveredAt: Long) = deliveredAt(deliveredAt as Long?)
+
+                /** Alias for calling [Builder.deliveredAt] with `deliveredAt.orElse(null)`. */
+                fun deliveredAt(deliveredAt: Optional<Long>) = deliveredAt(deliveredAt.getOrNull())
+
+                /**
+                 * Sets [Builder.deliveredAt] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.deliveredAt] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun deliveredAt(deliveredAt: JsonField<Long>) = apply {
+                    this.deliveredAt = deliveredAt
+                }
+
+                /** Error code (for message.failed events) */
+                fun errorCode(errorCode: String?) = errorCode(JsonField.ofNullable(errorCode))
+
+                /** Alias for calling [Builder.errorCode] with `errorCode.orElse(null)`. */
+                fun errorCode(errorCode: Optional<String>) = errorCode(errorCode.getOrNull())
+
+                /**
+                 * Sets [Builder.errorCode] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.errorCode] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun errorCode(errorCode: JsonField<String>) = apply { this.errorCode = errorCode }
+
+                /** Error description (for message.failed events) */
+                fun errorMessage(errorMessage: String?) =
+                    errorMessage(JsonField.ofNullable(errorMessage))
+
+                /** Alias for calling [Builder.errorMessage] with `errorMessage.orElse(null)`. */
+                fun errorMessage(errorMessage: Optional<String>) =
+                    errorMessage(errorMessage.getOrNull())
+
+                /**
+                 * Sets [Builder.errorMessage] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.errorMessage] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun errorMessage(errorMessage: JsonField<String>) = apply {
+                    this.errorMessage = errorMessage
+                }
+
+                /**
+                 * Event type (e.g., message.received, message.sent, message.delivered,
+                 * message.failed, message.read)
+                 */
+                fun event(event: String) = event(JsonField.of(event))
+
+                /**
+                 * Sets [Builder.event] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.event] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun event(event: JsonField<String>) = apply { this.event = event }
+
+                /** Recipient identifier (phone number, email, or group ID) */
+                fun externalId(externalId: String) = externalId(JsonField.of(externalId))
+
+                /**
+                 * Sets [Builder.externalId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.externalId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun externalId(externalId: JsonField<String>) = apply {
+                    this.externalId = externalId
+                }
+
+                /** Group ID (only present when is_group=true) */
+                fun groupId(groupId: String?) = groupId(JsonField.ofNullable(groupId))
+
+                /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
+                fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
+
+                /**
+                 * Sets [Builder.groupId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.groupId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun groupId(groupId: JsonField<String>) = apply { this.groupId = groupId }
+
+                /** Group display name (only present when is_group=true) */
+                fun groupName(groupName: String?) = groupName(JsonField.ofNullable(groupName))
+
+                /** Alias for calling [Builder.groupName] with `groupName.orElse(null)`. */
+                fun groupName(groupName: Optional<String>) = groupName(groupName.getOrNull())
+
+                /**
+                 * Sets [Builder.groupName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.groupName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun groupName(groupName: JsonField<String>) = apply { this.groupName = groupName }
+
+                /** Phone number that sent/received the message */
+                fun internalId(internalId: String?) = internalId(JsonField.ofNullable(internalId))
+
+                /** Alias for calling [Builder.internalId] with `internalId.orElse(null)`. */
+                fun internalId(internalId: Optional<String>) = internalId(internalId.getOrNull())
+
+                /**
+                 * Sets [Builder.internalId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.internalId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun internalId(internalId: JsonField<String>) = apply {
+                    this.internalId = internalId
+                }
+
+                /** Whether this message is from/to a group chat. Always present. */
+                fun isGroup(isGroup: Boolean) = isGroup(JsonField.of(isGroup))
+
+                /**
+                 * Sets [Builder.isGroup] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.isGroup] with a well-typed [Boolean] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun isGroup(isGroup: JsonField<Boolean>) = apply { this.isGroup = isGroup }
+
+                /** Unique message identifier */
+                fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+                /**
+                 * Sets [Builder.messageId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.messageId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+                /** Array of group participants (only present when is_group=true) */
+                fun participants(participants: List<Participant>?) =
+                    participants(JsonField.ofNullable(participants))
+
+                /** Alias for calling [Builder.participants] with `participants.orElse(null)`. */
+                fun participants(participants: Optional<List<Participant>>) =
+                    participants(participants.getOrNull())
+
+                /**
+                 * Sets [Builder.participants] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.participants] with a well-typed
+                 * `List<Participant>` value instead. This method is primarily for setting the field
+                 * to an undocumented or not yet supported value.
+                 */
+                fun participants(participants: JsonField<List<Participant>>) = apply {
+                    this.participants = participants.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Participant] to [participants].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addParticipant(participant: Participant) = apply {
+                    participants =
+                        (participants ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("participants", it).add(participant)
+                        }
+                }
+
+                /** Message protocol */
+                fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
+
+                /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
+                fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+
+                /**
+                 * Sets [Builder.protocol] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.protocol] with a well-typed [Protocol] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun protocol(protocol: JsonField<Protocol>) = apply { this.protocol = protocol }
+
+                /** Timestamp when message was read (for message.read events) */
+                fun readAt(readAt: Long?) = readAt(JsonField.ofNullable(readAt))
+
+                /**
+                 * Alias for [Builder.readAt].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun readAt(readAt: Long) = readAt(readAt as Long?)
+
+                /** Alias for calling [Builder.readAt] with `readAt.orElse(null)`. */
+                fun readAt(readAt: Optional<Long>) = readAt(readAt.getOrNull())
+
+                /**
+                 * Sets [Builder.readAt] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.readAt] with a well-typed [Long] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun readAt(readAt: JsonField<Long>) = apply { this.readAt = readAt }
+
+                /** Sender identifier (for inbound messages) */
+                fun sender(sender: String?) = sender(JsonField.ofNullable(sender))
+
+                /** Alias for calling [Builder.sender] with `sender.orElse(null)`. */
+                fun sender(sender: Optional<String>) = sender(sender.getOrNull())
+
+                /**
+                 * Sets [Builder.sender] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.sender] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun sender(sender: JsonField<String>) = apply { this.sender = sender }
+
+                /** Timestamp when message was sent (for message.sent events) */
+                fun sentAt(sentAt: Long?) = sentAt(JsonField.ofNullable(sentAt))
+
+                /**
+                 * Alias for [Builder.sentAt].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun sentAt(sentAt: Long) = sentAt(sentAt as Long?)
+
+                /** Alias for calling [Builder.sentAt] with `sentAt.orElse(null)`. */
+                fun sentAt(sentAt: Optional<Long>) = sentAt(sentAt.getOrNull())
+
+                /**
+                 * Sets [Builder.sentAt] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.sentAt] with a well-typed [Long] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun sentAt(sentAt: JsonField<Long>) = apply { this.sentAt = sentAt }
+
+                /** Message status */
+                fun status(status: Status) = status(JsonField.of(status))
+
+                /**
+                 * Sets [Builder.status] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.status] with a well-typed [Status] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun status(status: JsonField<Status>) = apply { this.status = status }
+
+                /** Message text content */
+                fun text(text: String?) = text(JsonField.ofNullable(text))
+
+                /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+                fun text(text: Optional<String>) = text(text.getOrNull())
+
+                /**
+                 * Sets [Builder.text] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.text] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun text(text: JsonField<String>) = apply { this.text = text }
+
+                /** Event timestamp in milliseconds */
+                fun timestamp(timestamp: Long) = timestamp(JsonField.of(timestamp))
+
+                /**
+                 * Sets [Builder.timestamp] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timestamp] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timestamp(timestamp: JsonField<Long>) = apply { this.timestamp = timestamp }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [EventBody].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): EventBody =
+                    EventBody(
+                        (attachments ?: JsonMissing.of()).map { it.toImmutable() },
+                        deliveredAt,
+                        errorCode,
+                        errorMessage,
+                        event,
+                        externalId,
+                        groupId,
+                        groupName,
+                        internalId,
+                        isGroup,
+                        messageId,
+                        (participants ?: JsonMissing.of()).map { it.toImmutable() },
+                        protocol,
+                        readAt,
+                        sender,
+                        sentAt,
+                        status,
+                        text,
+                        timestamp,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            fun validate(): EventBody = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                attachments().ifPresent { it.forEach { it.validate() } }
+                deliveredAt()
+                errorCode()
+                errorMessage()
+                event()
+                externalId()
+                groupId()
+                groupName()
+                internalId()
+                isGroup()
+                messageId()
+                participants().ifPresent { it.forEach { it.validate() } }
+                protocol().ifPresent { it.validate() }
+                readAt()
+                sender()
+                sentAt()
+                status().ifPresent { it.validate() }
+                text()
+                timestamp()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (attachments.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                    (if (deliveredAt.asKnown().isPresent) 1 else 0) +
+                    (if (errorCode.asKnown().isPresent) 1 else 0) +
+                    (if (errorMessage.asKnown().isPresent) 1 else 0) +
+                    (if (event.asKnown().isPresent) 1 else 0) +
+                    (if (externalId.asKnown().isPresent) 1 else 0) +
+                    (if (groupId.asKnown().isPresent) 1 else 0) +
+                    (if (groupName.asKnown().isPresent) 1 else 0) +
+                    (if (internalId.asKnown().isPresent) 1 else 0) +
+                    (if (isGroup.asKnown().isPresent) 1 else 0) +
+                    (if (messageId.asKnown().isPresent) 1 else 0) +
+                    (participants.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                    (protocol.asKnown().getOrNull()?.validity() ?: 0) +
+                    (if (readAt.asKnown().isPresent) 1 else 0) +
+                    (if (sender.asKnown().isPresent) 1 else 0) +
+                    (if (sentAt.asKnown().isPresent) 1 else 0) +
+                    (status.asKnown().getOrNull()?.validity() ?: 0) +
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                    (if (timestamp.asKnown().isPresent) 1 else 0)
+
+            class Attachment
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val name: JsonField<String>,
+                private val url: JsonField<String>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("name")
+                    @ExcludeMissing
+                    name: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+                ) : this(name, url, mutableMapOf())
+
+                /**
+                 * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun name(): Optional<String> = name.getOptional("name")
+
+                /**
+                 * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun url(): Optional<String> = url.getOptional("url")
+
+                /**
+                 * Returns the raw JSON value of [name].
+                 *
+                 * Unlike [name], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+                /**
+                 * Returns the raw JSON value of [url].
+                 *
+                 * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+                 */
+                @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Attachment]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Attachment]. */
+                class Builder internal constructor() {
+
+                    private var name: JsonField<String> = JsonMissing.of()
+                    private var url: JsonField<String> = JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(attachment: Attachment) = apply {
+                        name = attachment.name
+                        url = attachment.url
+                        additionalProperties = attachment.additionalProperties.toMutableMap()
+                    }
+
+                    fun name(name: String?) = name(JsonField.ofNullable(name))
+
+                    /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+                    fun name(name: Optional<String>) = name(name.getOrNull())
+
+                    /**
+                     * Sets [Builder.name] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.name] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun name(name: JsonField<String>) = apply { this.name = name }
+
+                    fun url(url: String) = url(JsonField.of(url))
+
+                    /**
+                     * Sets [Builder.url] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.url] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun url(url: JsonField<String>) = apply { this.url = url }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Attachment].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Attachment =
+                        Attachment(name, url, additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                fun validate(): Attachment = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    name()
+                    url()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: BlooioInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (name.asKnown().isPresent) 1 else 0) +
+                        (if (url.asKnown().isPresent) 1 else 0)
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Attachment &&
+                        name == other.name &&
+                        url == other.url &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(name, url, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Attachment{name=$name, url=$url, additionalProperties=$additionalProperties}"
+            }
+
+            class Participant
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val contactId: JsonField<String>,
+                private val identifier: JsonField<String>,
+                private val name: JsonField<String>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("contact_id")
+                    @ExcludeMissing
+                    contactId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("identifier")
+                    @ExcludeMissing
+                    identifier: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                ) : this(contactId, identifier, name, mutableMapOf())
+
+                /**
+                 * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun contactId(): Optional<String> = contactId.getOptional("contact_id")
+
+                /**
+                 * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun identifier(): Optional<String> = identifier.getOptional("identifier")
+
+                /**
+                 * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun name(): Optional<String> = name.getOptional("name")
+
+                /**
+                 * Returns the raw JSON value of [contactId].
+                 *
+                 * Unlike [contactId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("contact_id")
+                @ExcludeMissing
+                fun _contactId(): JsonField<String> = contactId
+
+                /**
+                 * Returns the raw JSON value of [identifier].
+                 *
+                 * Unlike [identifier], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("identifier")
+                @ExcludeMissing
+                fun _identifier(): JsonField<String> = identifier
+
+                /**
+                 * Returns the raw JSON value of [name].
+                 *
+                 * Unlike [name], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Participant]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Participant]. */
+                class Builder internal constructor() {
+
+                    private var contactId: JsonField<String> = JsonMissing.of()
+                    private var identifier: JsonField<String> = JsonMissing.of()
+                    private var name: JsonField<String> = JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(participant: Participant) = apply {
+                        contactId = participant.contactId
+                        identifier = participant.identifier
+                        name = participant.name
+                        additionalProperties = participant.additionalProperties.toMutableMap()
+                    }
+
+                    fun contactId(contactId: String) = contactId(JsonField.of(contactId))
+
+                    /**
+                     * Sets [Builder.contactId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.contactId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun contactId(contactId: JsonField<String>) = apply {
+                        this.contactId = contactId
+                    }
+
+                    fun identifier(identifier: String) = identifier(JsonField.of(identifier))
+
+                    /**
+                     * Sets [Builder.identifier] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.identifier] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun identifier(identifier: JsonField<String>) = apply {
+                        this.identifier = identifier
+                    }
+
+                    fun name(name: String?) = name(JsonField.ofNullable(name))
+
+                    /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+                    fun name(name: Optional<String>) = name(name.getOrNull())
+
+                    /**
+                     * Sets [Builder.name] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.name] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun name(name: JsonField<String>) = apply { this.name = name }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Participant].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Participant =
+                        Participant(
+                            contactId,
+                            identifier,
+                            name,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                fun validate(): Participant = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    contactId()
+                    identifier()
+                    name()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: BlooioInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (contactId.asKnown().isPresent) 1 else 0) +
+                        (if (identifier.asKnown().isPresent) 1 else 0) +
+                        (if (name.asKnown().isPresent) 1 else 0)
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Participant &&
+                        contactId == other.contactId &&
+                        identifier == other.identifier &&
+                        name == other.name &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(contactId, identifier, name, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Participant{contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
+            }
+
+            /** Message protocol */
+            class Protocol @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val IMESSAGE = of("imessage")
+
+                    @JvmField val SMS = of("sms")
+
+                    @JvmField val RCS = of("rcs")
+
+                    @JvmField val NON_IMESSAGE = of("non-imessage")
+
+                    @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
+                }
+
+                /** An enum containing [Protocol]'s known values. */
+                enum class Known {
+                    IMESSAGE,
+                    SMS,
+                    RCS,
+                    NON_IMESSAGE,
+                }
+
+                /**
+                 * An enum containing [Protocol]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Protocol] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    IMESSAGE,
+                    SMS,
+                    RCS,
+                    NON_IMESSAGE,
+                    /**
+                     * An enum member indicating that [Protocol] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        IMESSAGE -> Value.IMESSAGE
+                        SMS -> Value.SMS
+                        RCS -> Value.RCS
+                        NON_IMESSAGE -> Value.NON_IMESSAGE
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws BlooioInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        IMESSAGE -> Known.IMESSAGE
+                        SMS -> Known.SMS
+                        RCS -> Known.RCS
+                        NON_IMESSAGE -> Known.NON_IMESSAGE
+                        else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws BlooioInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        BlooioInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                fun validate(): Protocol = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: BlooioInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Protocol && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /** Message status */
+            class Status @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val QUEUED = of("queued")
+
+                    @JvmField val PENDING = of("pending")
+
+                    @JvmField val SENT = of("sent")
+
+                    @JvmField val DELIVERED = of("delivered")
+
+                    @JvmField val FAILED = of("failed")
+
+                    @JvmField val READ = of("read")
+
+                    @JvmField val RECEIVED = of("received")
+
+                    @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+                }
+
+                /** An enum containing [Status]'s known values. */
+                enum class Known {
+                    QUEUED,
+                    PENDING,
+                    SENT,
+                    DELIVERED,
+                    FAILED,
+                    READ,
+                    RECEIVED,
+                }
+
+                /**
+                 * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Status] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    QUEUED,
+                    PENDING,
+                    SENT,
+                    DELIVERED,
+                    FAILED,
+                    READ,
+                    RECEIVED,
+                    /**
+                     * An enum member indicating that [Status] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        QUEUED -> Value.QUEUED
+                        PENDING -> Value.PENDING
+                        SENT -> Value.SENT
+                        DELIVERED -> Value.DELIVERED
+                        FAILED -> Value.FAILED
+                        READ -> Value.READ
+                        RECEIVED -> Value.RECEIVED
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws BlooioInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        QUEUED -> Known.QUEUED
+                        PENDING -> Known.PENDING
+                        SENT -> Known.SENT
+                        DELIVERED -> Known.DELIVERED
+                        FAILED -> Known.FAILED
+                        READ -> Known.READ
+                        RECEIVED -> Known.RECEIVED
+                        else -> throw BlooioInvalidDataException("Unknown Status: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws BlooioInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        BlooioInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                fun validate(): Status = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: BlooioInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Status && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is EventBody &&
+                    attachments == other.attachments &&
+                    deliveredAt == other.deliveredAt &&
+                    errorCode == other.errorCode &&
+                    errorMessage == other.errorMessage &&
+                    event == other.event &&
+                    externalId == other.externalId &&
+                    groupId == other.groupId &&
+                    groupName == other.groupName &&
+                    internalId == other.internalId &&
+                    isGroup == other.isGroup &&
+                    messageId == other.messageId &&
+                    participants == other.participants &&
+                    protocol == other.protocol &&
+                    readAt == other.readAt &&
+                    sender == other.sender &&
+                    sentAt == other.sentAt &&
+                    status == other.status &&
+                    text == other.text &&
+                    timestamp == other.timestamp &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    attachments,
+                    deliveredAt,
+                    errorCode,
+                    errorMessage,
+                    event,
+                    externalId,
+                    groupId,
+                    groupName,
+                    internalId,
+                    isGroup,
+                    messageId,
+                    participants,
+                    protocol,
+                    readAt,
+                    sender,
+                    sentAt,
+                    status,
+                    text,
+                    timestamp,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "EventBody{attachments=$attachments, deliveredAt=$deliveredAt, errorCode=$errorCode, errorMessage=$errorMessage, event=$event, externalId=$externalId, groupId=$groupId, groupName=$groupName, internalId=$internalId, isGroup=$isGroup, messageId=$messageId, participants=$participants, protocol=$protocol, readAt=$readAt, sender=$sender, sentAt=$sentAt, status=$status, text=$text, timestamp=$timestamp, additionalProperties=$additionalProperties}"
+        }
+
+        /** Additional metadata about the webhook delivery */
+        class Metadata
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val durationMs: JsonField<Long>,
+            private val eventName: JsonField<String>,
+            private val isReplay: JsonField<Boolean>,
+            private val messageId: JsonField<String>,
+            private val organizationId: JsonField<String>,
+            private val originalEventId: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("duration_ms")
+                @ExcludeMissing
+                durationMs: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("event_name")
+                @ExcludeMissing
+                eventName: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("is_replay")
+                @ExcludeMissing
+                isReplay: JsonField<Boolean> = JsonMissing.of(),
+                @JsonProperty("message_id")
+                @ExcludeMissing
+                messageId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("organization_id")
+                @ExcludeMissing
+                organizationId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("original_event_id")
+                @ExcludeMissing
+                originalEventId: JsonField<String> = JsonMissing.of(),
+            ) : this(
+                durationMs,
+                eventName,
+                isReplay,
+                messageId,
+                organizationId,
+                originalEventId,
+                mutableMapOf(),
+            )
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun durationMs(): Optional<Long> = durationMs.getOptional("duration_ms")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun eventName(): Optional<String> = eventName.getOptional("event_name")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun isReplay(): Optional<Boolean> = isReplay.getOptional("is_replay")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun organizationId(): Optional<String> = organizationId.getOptional("organization_id")
+
+            /**
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun originalEventId(): Optional<String> =
+                originalEventId.getOptional("original_event_id")
+
+            /**
+             * Returns the raw JSON value of [durationMs].
+             *
+             * Unlike [durationMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("duration_ms")
+            @ExcludeMissing
+            fun _durationMs(): JsonField<Long> = durationMs
+
+            /**
+             * Returns the raw JSON value of [eventName].
+             *
+             * Unlike [eventName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("event_name")
+            @ExcludeMissing
+            fun _eventName(): JsonField<String> = eventName
+
+            /**
+             * Returns the raw JSON value of [isReplay].
+             *
+             * Unlike [isReplay], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("is_replay")
+            @ExcludeMissing
+            fun _isReplay(): JsonField<Boolean> = isReplay
+
+            /**
+             * Returns the raw JSON value of [messageId].
+             *
+             * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            fun _messageId(): JsonField<String> = messageId
+
+            /**
+             * Returns the raw JSON value of [organizationId].
+             *
+             * Unlike [organizationId], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("organization_id")
+            @ExcludeMissing
+            fun _organizationId(): JsonField<String> = organizationId
+
+            /**
+             * Returns the raw JSON value of [originalEventId].
+             *
+             * Unlike [originalEventId], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("original_event_id")
+            @ExcludeMissing
+            fun _originalEventId(): JsonField<String> = originalEventId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Metadata]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Metadata]. */
+            class Builder internal constructor() {
+
+                private var durationMs: JsonField<Long> = JsonMissing.of()
+                private var eventName: JsonField<String> = JsonMissing.of()
+                private var isReplay: JsonField<Boolean> = JsonMissing.of()
+                private var messageId: JsonField<String> = JsonMissing.of()
+                private var organizationId: JsonField<String> = JsonMissing.of()
+                private var originalEventId: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(metadata: Metadata) = apply {
+                    durationMs = metadata.durationMs
+                    eventName = metadata.eventName
+                    isReplay = metadata.isReplay
+                    messageId = metadata.messageId
+                    organizationId = metadata.organizationId
+                    originalEventId = metadata.originalEventId
+                    additionalProperties = metadata.additionalProperties.toMutableMap()
+                }
+
+                fun durationMs(durationMs: Long) = durationMs(JsonField.of(durationMs))
+
+                /**
+                 * Sets [Builder.durationMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.durationMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun durationMs(durationMs: JsonField<Long>) = apply { this.durationMs = durationMs }
+
+                fun eventName(eventName: String) = eventName(JsonField.of(eventName))
+
+                /**
+                 * Sets [Builder.eventName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.eventName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun eventName(eventName: JsonField<String>) = apply { this.eventName = eventName }
+
+                fun isReplay(isReplay: Boolean) = isReplay(JsonField.of(isReplay))
+
+                /**
+                 * Sets [Builder.isReplay] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.isReplay] with a well-typed [Boolean] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun isReplay(isReplay: JsonField<Boolean>) = apply { this.isReplay = isReplay }
+
+                fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+                /**
+                 * Sets [Builder.messageId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.messageId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+                fun organizationId(organizationId: String) =
+                    organizationId(JsonField.of(organizationId))
+
+                /**
+                 * Sets [Builder.organizationId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.organizationId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun organizationId(organizationId: JsonField<String>) = apply {
+                    this.organizationId = organizationId
+                }
+
+                fun originalEventId(originalEventId: String) =
+                    originalEventId(JsonField.of(originalEventId))
+
+                /**
+                 * Sets [Builder.originalEventId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.originalEventId] with a well-typed [String]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun originalEventId(originalEventId: JsonField<String>) = apply {
+                    this.originalEventId = originalEventId
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Metadata].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Metadata =
+                    Metadata(
+                        durationMs,
+                        eventName,
+                        isReplay,
+                        messageId,
+                        organizationId,
+                        originalEventId,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            fun validate(): Metadata = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                durationMs()
+                eventName()
+                isReplay()
+                messageId()
+                organizationId()
+                originalEventId()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (durationMs.asKnown().isPresent) 1 else 0) +
+                    (if (eventName.asKnown().isPresent) 1 else 0) +
+                    (if (isReplay.asKnown().isPresent) 1 else 0) +
+                    (if (messageId.asKnown().isPresent) 1 else 0) +
+                    (if (organizationId.asKnown().isPresent) 1 else 0) +
+                    (if (originalEventId.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Metadata &&
+                    durationMs == other.durationMs &&
+                    eventName == other.eventName &&
+                    isReplay == other.isReplay &&
+                    messageId == other.messageId &&
+                    organizationId == other.organizationId &&
+                    originalEventId == other.originalEventId &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    durationMs,
+                    eventName,
+                    isReplay,
+                    messageId,
+                    organizationId,
+                    originalEventId,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Metadata{durationMs=$durationMs, eventName=$eventName, isReplay=$isReplay, messageId=$messageId, organizationId=$organizationId, originalEventId=$originalEventId, additionalProperties=$additionalProperties}"
+        }
+
+        class Scope @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val API = of("api")
+
+                @JvmField val INTEGRATION = of("integration")
+
+                @JvmField val ORG = of("org")
+
+                @JvmStatic fun of(value: String) = Scope(JsonField.of(value))
+            }
+
+            /** An enum containing [Scope]'s known values. */
+            enum class Known {
+                API,
+                INTEGRATION,
+                ORG,
+            }
+
+            /**
+             * An enum containing [Scope]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Scope] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                API,
+                INTEGRATION,
+                ORG,
+                /**
+                 * An enum member indicating that [Scope] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    API -> Value.API
+                    INTEGRATION -> Value.INTEGRATION
+                    ORG -> Value.ORG
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    API -> Known.API
+                    INTEGRATION -> Known.INTEGRATION
+                    ORG -> Known.ORG
+                    else -> throw BlooioInvalidDataException("Unknown Scope: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            fun validate(): Scope = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Scope && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Log &&
+                attemptedTime == other.attemptedTime &&
+                eventBody == other.eventBody &&
+                eventId == other.eventId &&
+                metadata == other.metadata &&
+                responseJson == other.responseJson &&
+                responseReceivedAt == other.responseReceivedAt &&
+                responseStatus == other.responseStatus &&
+                scope == other.scope &&
+                webhookUrl == other.webhookUrl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                attemptedTime,
+                eventBody,
+                eventId,
+                metadata,
+                responseJson,
+                responseReceivedAt,
+                responseStatus,
+                scope,
+                webhookUrl,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Log{attemptedTime=$attemptedTime, eventBody=$eventBody, eventId=$eventId, metadata=$metadata, responseJson=$responseJson, responseReceivedAt=$responseReceivedAt, responseStatus=$responseStatus, scope=$scope, webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+    }
+
+    class Pagination
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val hasMore: JsonField<Boolean>,
+        private val limit: JsonField<Long>,
+        private val offset: JsonField<Long>,
+        private val returned: JsonField<Long>,
+        private val total: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("has_more")
+            @ExcludeMissing
+            hasMore: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("limit") @ExcludeMissing limit: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("offset") @ExcludeMissing offset: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("returned") @ExcludeMissing returned: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("total") @ExcludeMissing total: JsonField<Long> = JsonMissing.of(),
+        ) : this(hasMore, limit, offset, returned, total, mutableMapOf())
+
+        /**
+         * Whether there are more logs to fetch
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun hasMore(): Optional<Boolean> = hasMore.getOptional("has_more")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun limit(): Optional<Long> = limit.getOptional("limit")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun offset(): Optional<Long> = offset.getOptional("offset")
+
+        /**
+         * Number of logs returned in this response
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun returned(): Optional<Long> = returned.getOptional("returned")
+
+        /**
+         * Total number of matching logs
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun total(): Optional<Long> = total.getOptional("total")
+
+        /**
+         * Returns the raw JSON value of [hasMore].
+         *
+         * Unlike [hasMore], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("has_more") @ExcludeMissing fun _hasMore(): JsonField<Boolean> = hasMore
+
+        /**
+         * Returns the raw JSON value of [limit].
+         *
+         * Unlike [limit], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("limit") @ExcludeMissing fun _limit(): JsonField<Long> = limit
+
+        /**
+         * Returns the raw JSON value of [offset].
+         *
+         * Unlike [offset], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("offset") @ExcludeMissing fun _offset(): JsonField<Long> = offset
+
+        /**
+         * Returns the raw JSON value of [returned].
+         *
+         * Unlike [returned], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("returned") @ExcludeMissing fun _returned(): JsonField<Long> = returned
+
+        /**
+         * Returns the raw JSON value of [total].
+         *
+         * Unlike [total], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("total") @ExcludeMissing fun _total(): JsonField<Long> = total
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Pagination]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Pagination]. */
+        class Builder internal constructor() {
+
+            private var hasMore: JsonField<Boolean> = JsonMissing.of()
+            private var limit: JsonField<Long> = JsonMissing.of()
+            private var offset: JsonField<Long> = JsonMissing.of()
+            private var returned: JsonField<Long> = JsonMissing.of()
+            private var total: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(pagination: Pagination) = apply {
+                hasMore = pagination.hasMore
+                limit = pagination.limit
+                offset = pagination.offset
+                returned = pagination.returned
+                total = pagination.total
+                additionalProperties = pagination.additionalProperties.toMutableMap()
+            }
+
+            /** Whether there are more logs to fetch */
+            fun hasMore(hasMore: Boolean) = hasMore(JsonField.of(hasMore))
+
+            /**
+             * Sets [Builder.hasMore] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.hasMore] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun hasMore(hasMore: JsonField<Boolean>) = apply { this.hasMore = hasMore }
+
+            fun limit(limit: Long) = limit(JsonField.of(limit))
+
+            /**
+             * Sets [Builder.limit] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.limit] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun limit(limit: JsonField<Long>) = apply { this.limit = limit }
+
+            fun offset(offset: Long) = offset(JsonField.of(offset))
+
+            /**
+             * Sets [Builder.offset] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.offset] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun offset(offset: JsonField<Long>) = apply { this.offset = offset }
+
+            /** Number of logs returned in this response */
+            fun returned(returned: Long) = returned(JsonField.of(returned))
+
+            /**
+             * Sets [Builder.returned] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.returned] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun returned(returned: JsonField<Long>) = apply { this.returned = returned }
+
+            /** Total number of matching logs */
+            fun total(total: Long) = total(JsonField.of(total))
+
+            /**
+             * Sets [Builder.total] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.total] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun total(total: JsonField<Long>) = apply { this.total = total }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Pagination].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Pagination =
+                Pagination(
+                    hasMore,
+                    limit,
+                    offset,
+                    returned,
+                    total,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): Pagination = apply {
+            if (validated) {
+                return@apply
+            }
+
+            hasMore()
+            limit()
+            offset()
+            returned()
+            total()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (hasMore.asKnown().isPresent) 1 else 0) +
+                (if (limit.asKnown().isPresent) 1 else 0) +
+                (if (offset.asKnown().isPresent) 1 else 0) +
+                (if (returned.asKnown().isPresent) 1 else 0) +
+                (if (total.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Pagination &&
+                hasMore == other.hasMore &&
+                limit == other.limit &&
+                offset == other.offset &&
+                returned == other.returned &&
+                total == other.total &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(hasMore, limit, offset, returned, total, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Pagination{hasMore=$hasMore, limit=$limit, offset=$offset, returned=$returned, total=$total, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LogListResponse &&
+            logs == other.logs &&
+            pagination == other.pagination &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(logs, pagination, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "LogListResponse{logs=$logs, pagination=$pagination, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParams.kt
new file mode 100644
index 0000000..1d3b1c9
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParams.kt
@@ -0,0 +1,258 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Re-send a webhook event to the configured URL. */
+class LogReplayParams
+private constructor(
+    private val webhookId: String,
+    private val eventId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun webhookId(): String = webhookId
+
+    fun eventId(): Optional<String> = Optional.ofNullable(eventId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [LogReplayParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .webhookId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LogReplayParams]. */
+    class Builder internal constructor() {
+
+        private var webhookId: String? = null
+        private var eventId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(logReplayParams: LogReplayParams) = apply {
+            webhookId = logReplayParams.webhookId
+            eventId = logReplayParams.eventId
+            additionalHeaders = logReplayParams.additionalHeaders.toBuilder()
+            additionalQueryParams = logReplayParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = logReplayParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun webhookId(webhookId: String) = apply { this.webhookId = webhookId }
+
+        fun eventId(eventId: String?) = apply { this.eventId = eventId }
+
+        /** Alias for calling [Builder.eventId] with `eventId.orElse(null)`. */
+        fun eventId(eventId: Optional<String>) = eventId(eventId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [LogReplayParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .webhookId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): LogReplayParams =
+            LogReplayParams(
+                checkRequired("webhookId", webhookId),
+                eventId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId
+            1 -> eventId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LogReplayParams &&
+            webhookId == other.webhookId &&
+            eventId == other.eventId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            webhookId,
+            eventId,
+            additionalHeaders,
+            additionalQueryParams,
+            additionalBodyProperties,
+        )
+
+    override fun toString() =
+        "LogReplayParams{webhookId=$webhookId, eventId=$eventId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
new file mode 100644
index 0000000..a5f1f4a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
@@ -0,0 +1,782 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class LogReplayResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val durationMs: JsonField<Long>,
+    private val originalEventId: JsonField<String>,
+    private val replayEventId: JsonField<String>,
+    private val responseData: JsonField<ResponseData>,
+    private val responseStatus: JsonField<Long>,
+    private val success: JsonField<Boolean>,
+    private val webhookId: JsonField<String>,
+    private val webhookUrl: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("duration_ms") @ExcludeMissing durationMs: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("original_event_id")
+        @ExcludeMissing
+        originalEventId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("replay_event_id")
+        @ExcludeMissing
+        replayEventId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("response_data")
+        @ExcludeMissing
+        responseData: JsonField<ResponseData> = JsonMissing.of(),
+        @JsonProperty("response_status")
+        @ExcludeMissing
+        responseStatus: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("webhook_id") @ExcludeMissing webhookId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("webhook_url")
+        @ExcludeMissing
+        webhookUrl: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        durationMs,
+        originalEventId,
+        replayEventId,
+        responseData,
+        responseStatus,
+        success,
+        webhookId,
+        webhookUrl,
+        mutableMapOf(),
+    )
+
+    /**
+     * Time taken for the replay request in milliseconds
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun durationMs(): Optional<Long> = durationMs.getOptional("duration_ms")
+
+    /**
+     * The original event ID that was replayed
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun originalEventId(): Optional<String> = originalEventId.getOptional("original_event_id")
+
+    /**
+     * New event ID for this replay attempt
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun replayEventId(): Optional<String> = replayEventId.getOptional("replay_event_id")
+
+    /**
+     * Response details from the replay attempt
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun responseData(): Optional<ResponseData> = responseData.getOptional("response_data")
+
+    /**
+     * HTTP status code from replay attempt
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun responseStatus(): Optional<Long> = responseStatus.getOptional("response_status")
+
+    /**
+     * Whether the replay received a 2xx response
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun success(): Optional<Boolean> = success.getOptional("success")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookId(): Optional<String> = webhookId.getOptional("webhook_id")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookUrl(): Optional<String> = webhookUrl.getOptional("webhook_url")
+
+    /**
+     * Returns the raw JSON value of [durationMs].
+     *
+     * Unlike [durationMs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("duration_ms") @ExcludeMissing fun _durationMs(): JsonField<Long> = durationMs
+
+    /**
+     * Returns the raw JSON value of [originalEventId].
+     *
+     * Unlike [originalEventId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("original_event_id")
+    @ExcludeMissing
+    fun _originalEventId(): JsonField<String> = originalEventId
+
+    /**
+     * Returns the raw JSON value of [replayEventId].
+     *
+     * Unlike [replayEventId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("replay_event_id")
+    @ExcludeMissing
+    fun _replayEventId(): JsonField<String> = replayEventId
+
+    /**
+     * Returns the raw JSON value of [responseData].
+     *
+     * Unlike [responseData], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response_data")
+    @ExcludeMissing
+    fun _responseData(): JsonField<ResponseData> = responseData
+
+    /**
+     * Returns the raw JSON value of [responseStatus].
+     *
+     * Unlike [responseStatus], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response_status")
+    @ExcludeMissing
+    fun _responseStatus(): JsonField<Long> = responseStatus
+
+    /**
+     * Returns the raw JSON value of [success].
+     *
+     * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
+
+    /**
+     * Returns the raw JSON value of [webhookId].
+     *
+     * Unlike [webhookId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_id") @ExcludeMissing fun _webhookId(): JsonField<String> = webhookId
+
+    /**
+     * Returns the raw JSON value of [webhookUrl].
+     *
+     * Unlike [webhookUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_url") @ExcludeMissing fun _webhookUrl(): JsonField<String> = webhookUrl
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [LogReplayResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LogReplayResponse]. */
+    class Builder internal constructor() {
+
+        private var durationMs: JsonField<Long> = JsonMissing.of()
+        private var originalEventId: JsonField<String> = JsonMissing.of()
+        private var replayEventId: JsonField<String> = JsonMissing.of()
+        private var responseData: JsonField<ResponseData> = JsonMissing.of()
+        private var responseStatus: JsonField<Long> = JsonMissing.of()
+        private var success: JsonField<Boolean> = JsonMissing.of()
+        private var webhookId: JsonField<String> = JsonMissing.of()
+        private var webhookUrl: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(logReplayResponse: LogReplayResponse) = apply {
+            durationMs = logReplayResponse.durationMs
+            originalEventId = logReplayResponse.originalEventId
+            replayEventId = logReplayResponse.replayEventId
+            responseData = logReplayResponse.responseData
+            responseStatus = logReplayResponse.responseStatus
+            success = logReplayResponse.success
+            webhookId = logReplayResponse.webhookId
+            webhookUrl = logReplayResponse.webhookUrl
+            additionalProperties = logReplayResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Time taken for the replay request in milliseconds */
+        fun durationMs(durationMs: Long) = durationMs(JsonField.of(durationMs))
+
+        /**
+         * Sets [Builder.durationMs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.durationMs] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun durationMs(durationMs: JsonField<Long>) = apply { this.durationMs = durationMs }
+
+        /** The original event ID that was replayed */
+        fun originalEventId(originalEventId: String) =
+            originalEventId(JsonField.of(originalEventId))
+
+        /**
+         * Sets [Builder.originalEventId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.originalEventId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun originalEventId(originalEventId: JsonField<String>) = apply {
+            this.originalEventId = originalEventId
+        }
+
+        /** New event ID for this replay attempt */
+        fun replayEventId(replayEventId: String) = replayEventId(JsonField.of(replayEventId))
+
+        /**
+         * Sets [Builder.replayEventId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.replayEventId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun replayEventId(replayEventId: JsonField<String>) = apply {
+            this.replayEventId = replayEventId
+        }
+
+        /** Response details from the replay attempt */
+        fun responseData(responseData: ResponseData) = responseData(JsonField.of(responseData))
+
+        /**
+         * Sets [Builder.responseData] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.responseData] with a well-typed [ResponseData] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun responseData(responseData: JsonField<ResponseData>) = apply {
+            this.responseData = responseData
+        }
+
+        /** HTTP status code from replay attempt */
+        fun responseStatus(responseStatus: Long) = responseStatus(JsonField.of(responseStatus))
+
+        /**
+         * Sets [Builder.responseStatus] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.responseStatus] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun responseStatus(responseStatus: JsonField<Long>) = apply {
+            this.responseStatus = responseStatus
+        }
+
+        /** Whether the replay received a 2xx response */
+        fun success(success: Boolean) = success(JsonField.of(success))
+
+        /**
+         * Sets [Builder.success] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
+
+        fun webhookId(webhookId: String) = webhookId(JsonField.of(webhookId))
+
+        /**
+         * Sets [Builder.webhookId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookId(webhookId: JsonField<String>) = apply { this.webhookId = webhookId }
+
+        fun webhookUrl(webhookUrl: String) = webhookUrl(JsonField.of(webhookUrl))
+
+        /**
+         * Sets [Builder.webhookUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookUrl(webhookUrl: JsonField<String>) = apply { this.webhookUrl = webhookUrl }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [LogReplayResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): LogReplayResponse =
+            LogReplayResponse(
+                durationMs,
+                originalEventId,
+                replayEventId,
+                responseData,
+                responseStatus,
+                success,
+                webhookId,
+                webhookUrl,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): LogReplayResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        durationMs()
+        originalEventId()
+        replayEventId()
+        responseData().ifPresent { it.validate() }
+        responseStatus()
+        success()
+        webhookId()
+        webhookUrl()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (durationMs.asKnown().isPresent) 1 else 0) +
+            (if (originalEventId.asKnown().isPresent) 1 else 0) +
+            (if (replayEventId.asKnown().isPresent) 1 else 0) +
+            (responseData.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (responseStatus.asKnown().isPresent) 1 else 0) +
+            (if (success.asKnown().isPresent) 1 else 0) +
+            (if (webhookId.asKnown().isPresent) 1 else 0) +
+            (if (webhookUrl.asKnown().isPresent) 1 else 0)
+
+    /** Response details from the replay attempt */
+    class ResponseData
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val body: JsonValue,
+        private val contentType: JsonField<String>,
+        private val duration: JsonField<Long>,
+        private val error: JsonField<String>,
+        private val errorType: JsonField<String>,
+        private val headers: JsonValue,
+        private val size: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("body") @ExcludeMissing body: JsonValue = JsonMissing.of(),
+            @JsonProperty("contentType")
+            @ExcludeMissing
+            contentType: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("duration") @ExcludeMissing duration: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("errorType")
+            @ExcludeMissing
+            errorType: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("headers") @ExcludeMissing headers: JsonValue = JsonMissing.of(),
+            @JsonProperty("size") @ExcludeMissing size: JsonField<Long> = JsonMissing.of(),
+        ) : this(body, contentType, duration, error, errorType, headers, size, mutableMapOf())
+
+        /**
+         * Response body (if parseable)
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = responseData.body().convert(MyClass.class);
+         * ```
+         */
+        @JsonProperty("body") @ExcludeMissing fun _body(): JsonValue = body
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contentType(): Optional<String> = contentType.getOptional("contentType")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun duration(): Optional<Long> = duration.getOptional("duration")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun errorType(): Optional<String> = errorType.getOptional("errorType")
+
+        /**
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = responseData.headers().convert(MyClass.class);
+         * ```
+         */
+        @JsonProperty("headers") @ExcludeMissing fun _headers(): JsonValue = headers
+
+        /**
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun size(): Optional<Long> = size.getOptional("size")
+
+        /**
+         * Returns the raw JSON value of [contentType].
+         *
+         * Unlike [contentType], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("contentType")
+        @ExcludeMissing
+        fun _contentType(): JsonField<String> = contentType
+
+        /**
+         * Returns the raw JSON value of [duration].
+         *
+         * Unlike [duration], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("duration") @ExcludeMissing fun _duration(): JsonField<Long> = duration
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [errorType].
+         *
+         * Unlike [errorType], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("errorType") @ExcludeMissing fun _errorType(): JsonField<String> = errorType
+
+        /**
+         * Returns the raw JSON value of [size].
+         *
+         * Unlike [size], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("size") @ExcludeMissing fun _size(): JsonField<Long> = size
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [ResponseData]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ResponseData]. */
+        class Builder internal constructor() {
+
+            private var body: JsonValue = JsonMissing.of()
+            private var contentType: JsonField<String> = JsonMissing.of()
+            private var duration: JsonField<Long> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var errorType: JsonField<String> = JsonMissing.of()
+            private var headers: JsonValue = JsonMissing.of()
+            private var size: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(responseData: ResponseData) = apply {
+                body = responseData.body
+                contentType = responseData.contentType
+                duration = responseData.duration
+                error = responseData.error
+                errorType = responseData.errorType
+                headers = responseData.headers
+                size = responseData.size
+                additionalProperties = responseData.additionalProperties.toMutableMap()
+            }
+
+            /** Response body (if parseable) */
+            fun body(body: JsonValue) = apply { this.body = body }
+
+            fun contentType(contentType: String) = contentType(JsonField.of(contentType))
+
+            /**
+             * Sets [Builder.contentType] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contentType] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun contentType(contentType: JsonField<String>) = apply {
+                this.contentType = contentType
+            }
+
+            fun duration(duration: Long) = duration(JsonField.of(duration))
+
+            /**
+             * Sets [Builder.duration] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.duration] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun duration(duration: JsonField<Long>) = apply { this.duration = duration }
+
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            fun errorType(errorType: String?) = errorType(JsonField.ofNullable(errorType))
+
+            /** Alias for calling [Builder.errorType] with `errorType.orElse(null)`. */
+            fun errorType(errorType: Optional<String>) = errorType(errorType.getOrNull())
+
+            /**
+             * Sets [Builder.errorType] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.errorType] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun errorType(errorType: JsonField<String>) = apply { this.errorType = errorType }
+
+            fun headers(headers: JsonValue) = apply { this.headers = headers }
+
+            fun size(size: Long) = size(JsonField.of(size))
+
+            /**
+             * Sets [Builder.size] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.size] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun size(size: JsonField<Long>) = apply { this.size = size }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ResponseData].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): ResponseData =
+                ResponseData(
+                    body,
+                    contentType,
+                    duration,
+                    error,
+                    errorType,
+                    headers,
+                    size,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        fun validate(): ResponseData = apply {
+            if (validated) {
+                return@apply
+            }
+
+            contentType()
+            duration()
+            error()
+            errorType()
+            size()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (contentType.asKnown().isPresent) 1 else 0) +
+                (if (duration.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (errorType.asKnown().isPresent) 1 else 0) +
+                (if (size.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ResponseData &&
+                body == other.body &&
+                contentType == other.contentType &&
+                duration == other.duration &&
+                error == other.error &&
+                errorType == other.errorType &&
+                headers == other.headers &&
+                size == other.size &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                body,
+                contentType,
+                duration,
+                error,
+                errorType,
+                headers,
+                size,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ResponseData{body=$body, contentType=$contentType, duration=$duration, error=$error, errorType=$errorType, headers=$headers, size=$size, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is LogReplayResponse &&
+            durationMs == other.durationMs &&
+            originalEventId == other.originalEventId &&
+            replayEventId == other.replayEventId &&
+            responseData == other.responseData &&
+            responseStatus == other.responseStatus &&
+            success == other.success &&
+            webhookId == other.webhookId &&
+            webhookUrl == other.webhookUrl &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            durationMs,
+            originalEventId,
+            replayEventId,
+            responseData,
+            responseStatus,
+            success,
+            webhookId,
+            webhookUrl,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "LogReplayResponse{durationMs=$durationMs, originalEventId=$originalEventId, replayEventId=$replayEventId, responseData=$responseData, responseStatus=$responseStatus, success=$success, webhookId=$webhookId, webhookUrl=$webhookUrl, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParams.kt
new file mode 100644
index 0000000..36f62ca
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParams.kt
@@ -0,0 +1,232 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.secret
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.Params
+import com.blooio.api.core.http.Headers
+import com.blooio.api.core.http.QueryParams
+import com.blooio.api.core.toImmutable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Generate a new signing secret for the webhook. The new secret is returned only once in this
+ * response - store it securely. The old secret becomes invalid immediately.
+ */
+class SecretRotateParams
+private constructor(
+    private val webhookId: String?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): SecretRotateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [SecretRotateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [SecretRotateParams]. */
+    class Builder internal constructor() {
+
+        private var webhookId: String? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(secretRotateParams: SecretRotateParams) = apply {
+            webhookId = secretRotateParams.webhookId
+            additionalHeaders = secretRotateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = secretRotateParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = secretRotateParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun webhookId(webhookId: String?) = apply { this.webhookId = webhookId }
+
+        /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
+        fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [SecretRotateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): SecretRotateParams =
+            SecretRotateParams(
+                webhookId,
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> webhookId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers = additionalHeaders
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is SecretRotateParams &&
+            webhookId == other.webhookId &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(webhookId, additionalHeaders, additionalQueryParams, additionalBodyProperties)
+
+    override fun toString() =
+        "SecretRotateParams{webhookId=$webhookId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
new file mode 100644
index 0000000..0675b46
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
@@ -0,0 +1,319 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.secret
+
+import com.blooio.api.core.ExcludeMissing
+import com.blooio.api.core.JsonField
+import com.blooio.api.core.JsonMissing
+import com.blooio.api.core.JsonValue
+import com.blooio.api.errors.BlooioInvalidDataException
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class SecretRotateResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val rotatedAt: JsonField<Long>,
+    private val rotatedBy: JsonField<String>,
+    private val rotationCount: JsonField<Long>,
+    private val signingSecret: JsonField<String>,
+    private val webhookId: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("rotated_at") @ExcludeMissing rotatedAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("rotated_by") @ExcludeMissing rotatedBy: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("rotation_count")
+        @ExcludeMissing
+        rotationCount: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("signing_secret")
+        @ExcludeMissing
+        signingSecret: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("webhook_id") @ExcludeMissing webhookId: JsonField<String> = JsonMissing.of(),
+    ) : this(rotatedAt, rotatedBy, rotationCount, signingSecret, webhookId, mutableMapOf())
+
+    /**
+     * Timestamp when the secret was rotated
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun rotatedAt(): Optional<Long> = rotatedAt.getOptional("rotated_at")
+
+    /**
+     * Identifier of who rotated the secret
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun rotatedBy(): Optional<String> = rotatedBy.getOptional("rotated_by")
+
+    /**
+     * Total number of times this secret has been rotated
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun rotationCount(): Optional<Long> = rotationCount.getOptional("rotation_count")
+
+    /**
+     * The new signing secret. Store this securely - it will not be shown again.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun signingSecret(): Optional<String> = signingSecret.getOptional("signing_secret")
+
+    /**
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun webhookId(): Optional<String> = webhookId.getOptional("webhook_id")
+
+    /**
+     * Returns the raw JSON value of [rotatedAt].
+     *
+     * Unlike [rotatedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("rotated_at") @ExcludeMissing fun _rotatedAt(): JsonField<Long> = rotatedAt
+
+    /**
+     * Returns the raw JSON value of [rotatedBy].
+     *
+     * Unlike [rotatedBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("rotated_by") @ExcludeMissing fun _rotatedBy(): JsonField<String> = rotatedBy
+
+    /**
+     * Returns the raw JSON value of [rotationCount].
+     *
+     * Unlike [rotationCount], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("rotation_count")
+    @ExcludeMissing
+    fun _rotationCount(): JsonField<Long> = rotationCount
+
+    /**
+     * Returns the raw JSON value of [signingSecret].
+     *
+     * Unlike [signingSecret], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("signing_secret")
+    @ExcludeMissing
+    fun _signingSecret(): JsonField<String> = signingSecret
+
+    /**
+     * Returns the raw JSON value of [webhookId].
+     *
+     * Unlike [webhookId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("webhook_id") @ExcludeMissing fun _webhookId(): JsonField<String> = webhookId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [SecretRotateResponse]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [SecretRotateResponse]. */
+    class Builder internal constructor() {
+
+        private var rotatedAt: JsonField<Long> = JsonMissing.of()
+        private var rotatedBy: JsonField<String> = JsonMissing.of()
+        private var rotationCount: JsonField<Long> = JsonMissing.of()
+        private var signingSecret: JsonField<String> = JsonMissing.of()
+        private var webhookId: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(secretRotateResponse: SecretRotateResponse) = apply {
+            rotatedAt = secretRotateResponse.rotatedAt
+            rotatedBy = secretRotateResponse.rotatedBy
+            rotationCount = secretRotateResponse.rotationCount
+            signingSecret = secretRotateResponse.signingSecret
+            webhookId = secretRotateResponse.webhookId
+            additionalProperties = secretRotateResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Timestamp when the secret was rotated */
+        fun rotatedAt(rotatedAt: Long) = rotatedAt(JsonField.of(rotatedAt))
+
+        /**
+         * Sets [Builder.rotatedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.rotatedAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun rotatedAt(rotatedAt: JsonField<Long>) = apply { this.rotatedAt = rotatedAt }
+
+        /** Identifier of who rotated the secret */
+        fun rotatedBy(rotatedBy: String) = rotatedBy(JsonField.of(rotatedBy))
+
+        /**
+         * Sets [Builder.rotatedBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.rotatedBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun rotatedBy(rotatedBy: JsonField<String>) = apply { this.rotatedBy = rotatedBy }
+
+        /** Total number of times this secret has been rotated */
+        fun rotationCount(rotationCount: Long) = rotationCount(JsonField.of(rotationCount))
+
+        /**
+         * Sets [Builder.rotationCount] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.rotationCount] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun rotationCount(rotationCount: JsonField<Long>) = apply {
+            this.rotationCount = rotationCount
+        }
+
+        /** The new signing secret. Store this securely - it will not be shown again. */
+        fun signingSecret(signingSecret: String) = signingSecret(JsonField.of(signingSecret))
+
+        /**
+         * Sets [Builder.signingSecret] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.signingSecret] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun signingSecret(signingSecret: JsonField<String>) = apply {
+            this.signingSecret = signingSecret
+        }
+
+        fun webhookId(webhookId: String) = webhookId(JsonField.of(webhookId))
+
+        /**
+         * Sets [Builder.webhookId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.webhookId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun webhookId(webhookId: JsonField<String>) = apply { this.webhookId = webhookId }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [SecretRotateResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): SecretRotateResponse =
+            SecretRotateResponse(
+                rotatedAt,
+                rotatedBy,
+                rotationCount,
+                signingSecret,
+                webhookId,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    fun validate(): SecretRotateResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        rotatedAt()
+        rotatedBy()
+        rotationCount()
+        signingSecret()
+        webhookId()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: BlooioInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (rotatedAt.asKnown().isPresent) 1 else 0) +
+            (if (rotatedBy.asKnown().isPresent) 1 else 0) +
+            (if (rotationCount.asKnown().isPresent) 1 else 0) +
+            (if (signingSecret.asKnown().isPresent) 1 else 0) +
+            (if (webhookId.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is SecretRotateResponse &&
+            rotatedAt == other.rotatedAt &&
+            rotatedBy == other.rotatedBy &&
+            rotationCount == other.rotationCount &&
+            signingSecret == other.signingSecret &&
+            webhookId == other.webhookId &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            rotatedAt,
+            rotatedBy,
+            rotationCount,
+            signingSecret,
+            webhookId,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "SecretRotateResponse{rotatedAt=$rotatedAt, rotatedBy=$rotatedBy, rotationCount=$rotationCount, signingSecret=$signingSecret, webhookId=$webhookId, additionalProperties=$additionalProperties}"
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
deleted file mode 100644
index 992a0ae..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsync.kt
+++ /dev/null
@@ -1,290 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponse
-import com.blooio.api.models.batches.BatchCreateParams
-import com.blooio.api.models.batches.BatchListMessagesParams
-import com.blooio.api.models.batches.BatchRetrieveParams
-import com.blooio.api.models.batches.BatchRetrieveStatusParams
-import java.util.concurrent.CompletableFuture
-import java.util.function.Consumer
-
-/** Bulk/batch operations (stubbed) */
-interface BatchServiceAsync {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): BatchServiceAsync
-
-    /** Create a batch of messages (stub) */
-    fun create(): CompletableFuture<Void?> = create(BatchCreateParams.none())
-
-    /** @see create */
-    fun create(
-        params: BatchCreateParams = BatchCreateParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?>
-
-    /** @see create */
-    fun create(params: BatchCreateParams = BatchCreateParams.none()): CompletableFuture<Void?> =
-        create(params, RequestOptions.none())
-
-    /** @see create */
-    fun create(requestOptions: RequestOptions): CompletableFuture<Void?> =
-        create(BatchCreateParams.none(), requestOptions)
-
-    /** Get batch details (stub) */
-    fun retrieve(batchId: String): CompletableFuture<Void?> =
-        retrieve(batchId, BatchRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        batchId: String,
-        params: BatchRetrieveParams = BatchRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?> =
-        retrieve(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see retrieve */
-    fun retrieve(
-        batchId: String,
-        params: BatchRetrieveParams = BatchRetrieveParams.none(),
-    ): CompletableFuture<Void?> = retrieve(batchId, params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: BatchRetrieveParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?>
-
-    /** @see retrieve */
-    fun retrieve(params: BatchRetrieveParams): CompletableFuture<Void?> =
-        retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(batchId: String, requestOptions: RequestOptions): CompletableFuture<Void?> =
-        retrieve(batchId, BatchRetrieveParams.none(), requestOptions)
-
-    /** List messages in a batch (stub) */
-    fun listMessages(batchId: String): CompletableFuture<Void?> =
-        listMessages(batchId, BatchListMessagesParams.none())
-
-    /** @see listMessages */
-    fun listMessages(
-        batchId: String,
-        params: BatchListMessagesParams = BatchListMessagesParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?> =
-        listMessages(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see listMessages */
-    fun listMessages(
-        batchId: String,
-        params: BatchListMessagesParams = BatchListMessagesParams.none(),
-    ): CompletableFuture<Void?> = listMessages(batchId, params, RequestOptions.none())
-
-    /** @see listMessages */
-    fun listMessages(
-        params: BatchListMessagesParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?>
-
-    /** @see listMessages */
-    fun listMessages(params: BatchListMessagesParams): CompletableFuture<Void?> =
-        listMessages(params, RequestOptions.none())
-
-    /** @see listMessages */
-    fun listMessages(batchId: String, requestOptions: RequestOptions): CompletableFuture<Void?> =
-        listMessages(batchId, BatchListMessagesParams.none(), requestOptions)
-
-    /** Get batch status (stub) */
-    fun retrieveStatus(batchId: String): CompletableFuture<Void?> =
-        retrieveStatus(batchId, BatchRetrieveStatusParams.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        batchId: String,
-        params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?> =
-        retrieveStatus(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        batchId: String,
-        params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-    ): CompletableFuture<Void?> = retrieveStatus(batchId, params, RequestOptions.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        params: BatchRetrieveStatusParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<Void?>
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(params: BatchRetrieveStatusParams): CompletableFuture<Void?> =
-        retrieveStatus(params, RequestOptions.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(batchId: String, requestOptions: RequestOptions): CompletableFuture<Void?> =
-        retrieveStatus(batchId, BatchRetrieveStatusParams.none(), requestOptions)
-
-    /** A view of [BatchServiceAsync] that provides access to raw HTTP responses for each method. */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): BatchServiceAsync.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `post /v1/api/batches`, but is otherwise the same as
-         * [BatchServiceAsync.create].
-         */
-        fun create(): CompletableFuture<HttpResponse> = create(BatchCreateParams.none())
-
-        /** @see create */
-        fun create(
-            params: BatchCreateParams = BatchCreateParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse>
-
-        /** @see create */
-        fun create(
-            params: BatchCreateParams = BatchCreateParams.none()
-        ): CompletableFuture<HttpResponse> = create(params, RequestOptions.none())
-
-        /** @see create */
-        fun create(requestOptions: RequestOptions): CompletableFuture<HttpResponse> =
-            create(BatchCreateParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}`, but is otherwise the
-         * same as [BatchServiceAsync.retrieve].
-         */
-        fun retrieve(batchId: String): CompletableFuture<HttpResponse> =
-            retrieve(batchId, BatchRetrieveParams.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            batchId: String,
-            params: BatchRetrieveParams = BatchRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse> =
-            retrieve(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see retrieve */
-        fun retrieve(
-            batchId: String,
-            params: BatchRetrieveParams = BatchRetrieveParams.none(),
-        ): CompletableFuture<HttpResponse> = retrieve(batchId, params, RequestOptions.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            params: BatchRetrieveParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse>
-
-        /** @see retrieve */
-        fun retrieve(params: BatchRetrieveParams): CompletableFuture<HttpResponse> =
-            retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            batchId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> =
-            retrieve(batchId, BatchRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}/messages`, but is
-         * otherwise the same as [BatchServiceAsync.listMessages].
-         */
-        fun listMessages(batchId: String): CompletableFuture<HttpResponse> =
-            listMessages(batchId, BatchListMessagesParams.none())
-
-        /** @see listMessages */
-        fun listMessages(
-            batchId: String,
-            params: BatchListMessagesParams = BatchListMessagesParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse> =
-            listMessages(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see listMessages */
-        fun listMessages(
-            batchId: String,
-            params: BatchListMessagesParams = BatchListMessagesParams.none(),
-        ): CompletableFuture<HttpResponse> = listMessages(batchId, params, RequestOptions.none())
-
-        /** @see listMessages */
-        fun listMessages(
-            params: BatchListMessagesParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse>
-
-        /** @see listMessages */
-        fun listMessages(params: BatchListMessagesParams): CompletableFuture<HttpResponse> =
-            listMessages(params, RequestOptions.none())
-
-        /** @see listMessages */
-        fun listMessages(
-            batchId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> =
-            listMessages(batchId, BatchListMessagesParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}/status`, but is otherwise
-         * the same as [BatchServiceAsync.retrieveStatus].
-         */
-        fun retrieveStatus(batchId: String): CompletableFuture<HttpResponse> =
-            retrieveStatus(batchId, BatchRetrieveStatusParams.none())
-
-        /** @see retrieveStatus */
-        fun retrieveStatus(
-            batchId: String,
-            params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse> =
-            retrieveStatus(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see retrieveStatus */
-        fun retrieveStatus(
-            batchId: String,
-            params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-        ): CompletableFuture<HttpResponse> = retrieveStatus(batchId, params, RequestOptions.none())
-
-        /** @see retrieveStatus */
-        fun retrieveStatus(
-            params: BatchRetrieveStatusParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponse>
-
-        /** @see retrieveStatus */
-        fun retrieveStatus(params: BatchRetrieveStatusParams): CompletableFuture<HttpResponse> =
-            retrieveStatus(params, RequestOptions.none())
-
-        /** @see retrieveStatus */
-        fun retrieveStatus(
-            batchId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> =
-            retrieveStatus(batchId, BatchRetrieveStatusParams.none(), requestOptions)
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
deleted file mode 100644
index 18c975a..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/BatchServiceAsyncImpl.kt
+++ /dev/null
@@ -1,182 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.checkRequired
-import com.blooio.api.core.handlers.emptyHandler
-import com.blooio.api.core.handlers.errorBodyHandler
-import com.blooio.api.core.handlers.errorHandler
-import com.blooio.api.core.http.HttpMethod
-import com.blooio.api.core.http.HttpRequest
-import com.blooio.api.core.http.HttpResponse
-import com.blooio.api.core.http.HttpResponse.Handler
-import com.blooio.api.core.http.json
-import com.blooio.api.core.http.parseable
-import com.blooio.api.core.prepareAsync
-import com.blooio.api.models.batches.BatchCreateParams
-import com.blooio.api.models.batches.BatchListMessagesParams
-import com.blooio.api.models.batches.BatchRetrieveParams
-import com.blooio.api.models.batches.BatchRetrieveStatusParams
-import java.util.concurrent.CompletableFuture
-import java.util.function.Consumer
-import kotlin.jvm.optionals.getOrNull
-
-/** Bulk/batch operations (stubbed) */
-class BatchServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
-    BatchServiceAsync {
-
-    private val withRawResponse: BatchServiceAsync.WithRawResponse by lazy {
-        WithRawResponseImpl(clientOptions)
-    }
-
-    override fun withRawResponse(): BatchServiceAsync.WithRawResponse = withRawResponse
-
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BatchServiceAsync =
-        BatchServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
-
-    override fun create(
-        params: BatchCreateParams,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<Void?> =
-        // post /v1/api/batches
-        withRawResponse().create(params, requestOptions).thenAccept {}
-
-    override fun retrieve(
-        params: BatchRetrieveParams,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<Void?> =
-        // get /v1/api/batches/{batchId}
-        withRawResponse().retrieve(params, requestOptions).thenAccept {}
-
-    override fun listMessages(
-        params: BatchListMessagesParams,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<Void?> =
-        // get /v1/api/batches/{batchId}/messages
-        withRawResponse().listMessages(params, requestOptions).thenAccept {}
-
-    override fun retrieveStatus(
-        params: BatchRetrieveStatusParams,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<Void?> =
-        // get /v1/api/batches/{batchId}/status
-        withRawResponse().retrieveStatus(params, requestOptions).thenAccept {}
-
-    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        BatchServiceAsync.WithRawResponse {
-
-        private val errorHandler: Handler<HttpResponse> =
-            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
-
-        override fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): BatchServiceAsync.WithRawResponse =
-            BatchServiceAsyncImpl.WithRawResponseImpl(
-                clientOptions.toBuilder().apply(modifier::accept).build()
-            )
-
-        private val createHandler: Handler<Void?> = emptyHandler()
-
-        override fun create(
-            params: BatchCreateParams,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> {
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.POST)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches")
-                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
-                    .build()
-                    .prepareAsync(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            return request
-                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
-                .thenApply { response ->
-                    errorHandler.handle(response).parseable {
-                        response.use { createHandler.handle(it) }
-                    }
-                }
-        }
-
-        private val retrieveHandler: Handler<Void?> = emptyHandler()
-
-        override fun retrieve(
-            params: BatchRetrieveParams,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0))
-                    .build()
-                    .prepareAsync(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            return request
-                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
-                .thenApply { response ->
-                    errorHandler.handle(response).parseable {
-                        response.use { retrieveHandler.handle(it) }
-                    }
-                }
-        }
-
-        private val listMessagesHandler: Handler<Void?> = emptyHandler()
-
-        override fun listMessages(
-            params: BatchListMessagesParams,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0), "messages")
-                    .build()
-                    .prepareAsync(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            return request
-                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
-                .thenApply { response ->
-                    errorHandler.handle(response).parseable {
-                        response.use { listMessagesHandler.handle(it) }
-                    }
-                }
-        }
-
-        private val retrieveStatusHandler: Handler<Void?> = emptyHandler()
-
-        override fun retrieveStatus(
-            params: BatchRetrieveStatusParams,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponse> {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0), "status")
-                    .build()
-                    .prepareAsync(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            return request
-                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
-                .thenApply { response ->
-                    errorHandler.handle(response).parseable {
-                        response.use { retrieveStatusHandler.handle(it) }
-                    }
-                }
-        }
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
new file mode 100644
index 0000000..3984bad
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
@@ -0,0 +1,356 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.ChatListParams
+import com.blooio.api.models.chats.ChatListResponse
+import com.blooio.api.models.chats.ChatMarkAsReadParams
+import com.blooio.api.models.chats.ChatMarkAsReadResponse
+import com.blooio.api.models.chats.ChatRetrieveParams
+import com.blooio.api.models.chats.ChatRetrieveResponse
+import com.blooio.api.models.chats.ChatShareContactCardParams
+import com.blooio.api.models.chats.ChatShareContactCardResponse
+import com.blooio.api.services.async.chats.BackgroundServiceAsync
+import com.blooio.api.services.async.chats.MessageServiceAsync
+import com.blooio.api.services.async.chats.PollServiceAsync
+import com.blooio.api.services.async.chats.TypingServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+interface ChatServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatServiceAsync
+
+    fun messages(): MessageServiceAsync
+
+    /**
+     * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+     * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+     * require webhook_type 'poll' or 'all'.
+     */
+    fun polls(): PollServiceAsync
+
+    /** Control typing indicators for conversations */
+    fun typing(): TypingServiceAsync
+
+    /** Set, get, and remove conversation backgrounds */
+    fun background(): BackgroundServiceAsync
+
+    /** Get details for a specific conversation. */
+    fun retrieve(chatId: String): CompletableFuture<ChatRetrieveResponse> =
+        retrieve(chatId, ChatRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: ChatRetrieveParams = ChatRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatRetrieveResponse> =
+        retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: ChatRetrieveParams = ChatRetrieveParams.none(),
+    ): CompletableFuture<ChatRetrieveResponse> = retrieve(chatId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ChatRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatRetrieveResponse>
+
+    /** @see retrieve */
+    fun retrieve(params: ChatRetrieveParams): CompletableFuture<ChatRetrieveResponse> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatRetrieveResponse> =
+        retrieve(chatId, ChatRetrieveParams.none(), requestOptions)
+
+    /** List all unique conversations for the organization, sorted by most recent message. */
+    fun list(): CompletableFuture<ChatListResponse> = list(ChatListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ChatListParams = ChatListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatListResponse>
+
+    /** @see list */
+    fun list(params: ChatListParams = ChatListParams.none()): CompletableFuture<ChatListResponse> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<ChatListResponse> =
+        list(ChatListParams.none(), requestOptions)
+
+    /** Mark all messages in a chat as read. This sends a read receipt to the sender. */
+    fun markAsRead(chatId: String): CompletableFuture<ChatMarkAsReadResponse> =
+        markAsRead(chatId, ChatMarkAsReadParams.none())
+
+    /** @see markAsRead */
+    fun markAsRead(
+        chatId: String,
+        params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatMarkAsReadResponse> =
+        markAsRead(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see markAsRead */
+    fun markAsRead(
+        chatId: String,
+        params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+    ): CompletableFuture<ChatMarkAsReadResponse> = markAsRead(chatId, params, RequestOptions.none())
+
+    /** @see markAsRead */
+    fun markAsRead(
+        params: ChatMarkAsReadParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatMarkAsReadResponse>
+
+    /** @see markAsRead */
+    fun markAsRead(params: ChatMarkAsReadParams): CompletableFuture<ChatMarkAsReadResponse> =
+        markAsRead(params, RequestOptions.none())
+
+    /** @see markAsRead */
+    fun markAsRead(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatMarkAsReadResponse> =
+        markAsRead(chatId, ChatMarkAsReadParams.none(), requestOptions)
+
+    /**
+     * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be
+     * piggybacked onto the next outgoing message (text or attachment) sent to this chat. This is
+     * idempotent — calling it multiple times is harmless.
+     */
+    fun shareContactCard(chatId: String): CompletableFuture<ChatShareContactCardResponse> =
+        shareContactCard(chatId, ChatShareContactCardParams.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatShareContactCardResponse> =
+        shareContactCard(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+    ): CompletableFuture<ChatShareContactCardResponse> =
+        shareContactCard(chatId, params, RequestOptions.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        params: ChatShareContactCardParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatShareContactCardResponse>
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        params: ChatShareContactCardParams
+    ): CompletableFuture<ChatShareContactCardResponse> =
+        shareContactCard(params, RequestOptions.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatShareContactCardResponse> =
+        shareContactCard(chatId, ChatShareContactCardParams.none(), requestOptions)
+
+    /** A view of [ChatServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatServiceAsync.WithRawResponse
+
+        fun messages(): MessageServiceAsync.WithRawResponse
+
+        /**
+         * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+         * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+         * require webhook_type 'poll' or 'all'.
+         */
+        fun polls(): PollServiceAsync.WithRawResponse
+
+        /** Control typing indicators for conversations */
+        fun typing(): TypingServiceAsync.WithRawResponse
+
+        /** Set, get, and remove conversation backgrounds */
+        fun background(): BackgroundServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}`, but is otherwise the same as
+         * [ChatServiceAsync.retrieve].
+         */
+        fun retrieve(chatId: String): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> =
+            retrieve(chatId, ChatRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            params: ChatRetrieveParams = ChatRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> =
+            retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            params: ChatRetrieveParams = ChatRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> =
+            retrieve(chatId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ChatRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>>
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ChatRetrieveParams
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> =
+            retrieve(chatId, ChatRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /chats`, but is otherwise the same as
+         * [ChatServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<ChatListResponse>> =
+            list(ChatListParams.none())
+
+        /** @see list */
+        fun list(
+            params: ChatListParams = ChatListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatListResponse>>
+
+        /** @see list */
+        fun list(
+            params: ChatListParams = ChatListParams.none()
+        ): CompletableFuture<HttpResponseFor<ChatListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<ChatListResponse>> =
+            list(ChatListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/read`, but is otherwise the same as
+         * [ChatServiceAsync.markAsRead].
+         */
+        fun markAsRead(chatId: String): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> =
+            markAsRead(chatId, ChatMarkAsReadParams.none())
+
+        /** @see markAsRead */
+        fun markAsRead(
+            chatId: String,
+            params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> =
+            markAsRead(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see markAsRead */
+        fun markAsRead(
+            chatId: String,
+            params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> =
+            markAsRead(chatId, params, RequestOptions.none())
+
+        /** @see markAsRead */
+        fun markAsRead(
+            params: ChatMarkAsReadParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>>
+
+        /** @see markAsRead */
+        fun markAsRead(
+            params: ChatMarkAsReadParams
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> =
+            markAsRead(params, RequestOptions.none())
+
+        /** @see markAsRead */
+        fun markAsRead(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> =
+            markAsRead(chatId, ChatMarkAsReadParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/contact-card`, but is otherwise the
+         * same as [ChatServiceAsync.shareContactCard].
+         */
+        fun shareContactCard(
+            chatId: String
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> =
+            shareContactCard(chatId, ChatShareContactCardParams.none())
+
+        /** @see shareContactCard */
+        fun shareContactCard(
+            chatId: String,
+            params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> =
+            shareContactCard(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see shareContactCard */
+        fun shareContactCard(
+            chatId: String,
+            params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> =
+            shareContactCard(chatId, params, RequestOptions.none())
+
+        /** @see shareContactCard */
+        fun shareContactCard(
+            params: ChatShareContactCardParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>>
+
+        /** @see shareContactCard */
+        fun shareContactCard(
+            params: ChatShareContactCardParams
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> =
+            shareContactCard(params, RequestOptions.none())
+
+        /** @see shareContactCard */
+        fun shareContactCard(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> =
+            shareContactCard(chatId, ChatShareContactCardParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
new file mode 100644
index 0000000..971f007
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
@@ -0,0 +1,279 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.chats.ChatListParams
+import com.blooio.api.models.chats.ChatListResponse
+import com.blooio.api.models.chats.ChatMarkAsReadParams
+import com.blooio.api.models.chats.ChatMarkAsReadResponse
+import com.blooio.api.models.chats.ChatRetrieveParams
+import com.blooio.api.models.chats.ChatRetrieveResponse
+import com.blooio.api.models.chats.ChatShareContactCardParams
+import com.blooio.api.models.chats.ChatShareContactCardResponse
+import com.blooio.api.services.async.chats.BackgroundServiceAsync
+import com.blooio.api.services.async.chats.BackgroundServiceAsyncImpl
+import com.blooio.api.services.async.chats.MessageServiceAsync
+import com.blooio.api.services.async.chats.MessageServiceAsyncImpl
+import com.blooio.api.services.async.chats.PollServiceAsync
+import com.blooio.api.services.async.chats.PollServiceAsyncImpl
+import com.blooio.api.services.async.chats.TypingServiceAsync
+import com.blooio.api.services.async.chats.TypingServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class ChatServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    ChatServiceAsync {
+
+    private val withRawResponse: ChatServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val messages: MessageServiceAsync by lazy { MessageServiceAsyncImpl(clientOptions) }
+
+    private val polls: PollServiceAsync by lazy { PollServiceAsyncImpl(clientOptions) }
+
+    private val typing: TypingServiceAsync by lazy { TypingServiceAsyncImpl(clientOptions) }
+
+    private val background: BackgroundServiceAsync by lazy {
+        BackgroundServiceAsyncImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ChatServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatServiceAsync =
+        ChatServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun messages(): MessageServiceAsync = messages
+
+    /**
+     * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+     * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+     * require webhook_type 'poll' or 'all'.
+     */
+    override fun polls(): PollServiceAsync = polls
+
+    /** Control typing indicators for conversations */
+    override fun typing(): TypingServiceAsync = typing
+
+    /** Set, get, and remove conversation backgrounds */
+    override fun background(): BackgroundServiceAsync = background
+
+    override fun retrieve(
+        params: ChatRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatRetrieveResponse> =
+        // get /chats/{chatId}
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun list(
+        params: ChatListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatListResponse> =
+        // get /chats
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun markAsRead(
+        params: ChatMarkAsReadParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatMarkAsReadResponse> =
+        // post /chats/{chatId}/read
+        withRawResponse().markAsRead(params, requestOptions).thenApply { it.parse() }
+
+    override fun shareContactCard(
+        params: ChatShareContactCardParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatShareContactCardResponse> =
+        // post /chats/{chatId}/contact-card
+        withRawResponse().shareContactCard(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ChatServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val messages: MessageServiceAsync.WithRawResponse by lazy {
+            MessageServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val polls: PollServiceAsync.WithRawResponse by lazy {
+            PollServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val typing: TypingServiceAsync.WithRawResponse by lazy {
+            TypingServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val background: BackgroundServiceAsync.WithRawResponse by lazy {
+            BackgroundServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ChatServiceAsync.WithRawResponse =
+            ChatServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        override fun messages(): MessageServiceAsync.WithRawResponse = messages
+
+        /**
+         * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+         * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+         * require webhook_type 'poll' or 'all'.
+         */
+        override fun polls(): PollServiceAsync.WithRawResponse = polls
+
+        /** Control typing indicators for conversations */
+        override fun typing(): TypingServiceAsync.WithRawResponse = typing
+
+        /** Set, get, and remove conversation backgrounds */
+        override fun background(): BackgroundServiceAsync.WithRawResponse = background
+
+        private val retrieveHandler: Handler<ChatRetrieveResponse> =
+            jsonHandler<ChatRetrieveResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ChatRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatRetrieveResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val listHandler: Handler<ChatListResponse> =
+            jsonHandler<ChatListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ChatListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val markAsReadHandler: Handler<ChatMarkAsReadResponse> =
+            jsonHandler<ChatMarkAsReadResponse>(clientOptions.jsonMapper)
+
+        override fun markAsRead(
+            params: ChatMarkAsReadParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatMarkAsReadResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "read")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { markAsReadHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val shareContactCardHandler: Handler<ChatShareContactCardResponse> =
+            jsonHandler<ChatShareContactCardResponse>(clientOptions.jsonMapper)
+
+        override fun shareContactCard(
+            params: ChatShareContactCardParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatShareContactCardResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "contact-card")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { shareContactCardHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
deleted file mode 100644
index aecaf95..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsyncImpl.kt
+++ /dev/null
@@ -1,44 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.async.config.WebhookServiceAsync
-import com.blooio.api.services.async.config.WebhookServiceAsyncImpl
-import java.util.function.Consumer
-
-class ConfigServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
-    ConfigServiceAsync {
-
-    private val withRawResponse: ConfigServiceAsync.WithRawResponse by lazy {
-        WithRawResponseImpl(clientOptions)
-    }
-
-    private val webhook: WebhookServiceAsync by lazy { WebhookServiceAsyncImpl(clientOptions) }
-
-    override fun withRawResponse(): ConfigServiceAsync.WithRawResponse = withRawResponse
-
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigServiceAsync =
-        ConfigServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
-
-    /** Account-level configuration */
-    override fun webhook(): WebhookServiceAsync = webhook
-
-    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        ConfigServiceAsync.WithRawResponse {
-
-        private val webhook: WebhookServiceAsync.WithRawResponse by lazy {
-            WebhookServiceAsyncImpl.WithRawResponseImpl(clientOptions)
-        }
-
-        override fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): ConfigServiceAsync.WithRawResponse =
-            ConfigServiceAsyncImpl.WithRawResponseImpl(
-                clientOptions.toBuilder().apply(modifier::accept).build()
-            )
-
-        /** Account-level configuration */
-        override fun webhook(): WebhookServiceAsync.WithRawResponse = webhook
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
index 1588d35..d0cee1a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsync.kt
@@ -5,12 +5,21 @@ package com.blooio.api.services.async
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
 import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.contacts.Contact
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesParams
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactDeleteParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactListResponse
+import com.blooio.api.models.contacts.ContactRetrieveParams
+import com.blooio.api.models.contacts.ContactUpdateParams
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.services.async.contacts.TagServiceAsync
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
-/** Contact-related operations */
+/** Manage contacts (phone numbers and emails) */
 interface ContactServiceAsync {
 
     /**
@@ -25,27 +34,154 @@ interface ContactServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactServiceAsync
 
-    /**
-     * Check if a phone number or email address supports iMessage, SMS, RCS, and other messaging
-     * capabilities.
-     */
-    fun checkCapabilities(contact: String): CompletableFuture<ContactCheckCapabilitiesResponse> =
-        checkCapabilities(contact, ContactCheckCapabilitiesParams.none())
+    /** Manage contacts (phone numbers and emails) */
+    fun tags(): TagServiceAsync
+
+    /** Create a new contact with a phone number (E.164 format) or email address. */
+    fun create(params: ContactCreateParams): CompletableFuture<Contact> =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: ContactCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Contact>
+
+    /** Get details for a specific contact by phone number or email. */
+    fun retrieve(contactId: String): CompletableFuture<Contact> =
+        retrieve(contactId, ContactRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        contactId: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Contact> =
+        retrieve(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        contactId: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+    ): CompletableFuture<Contact> = retrieve(contactId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Contact>
+
+    /** @see retrieve */
+    fun retrieve(params: ContactRetrieveParams): CompletableFuture<Contact> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(contactId: String, requestOptions: RequestOptions): CompletableFuture<Contact> =
+        retrieve(contactId, ContactRetrieveParams.none(), requestOptions)
+
+    /** Update a contact's name. */
+    fun update(contactId: String): CompletableFuture<Contact> =
+        update(contactId, ContactUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        contactId: String,
+        params: ContactUpdateParams = ContactUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Contact> =
+        update(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        contactId: String,
+        params: ContactUpdateParams = ContactUpdateParams.none(),
+    ): CompletableFuture<Contact> = update(contactId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: ContactUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Contact>
+
+    /** @see update */
+    fun update(params: ContactUpdateParams): CompletableFuture<Contact> =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(contactId: String, requestOptions: RequestOptions): CompletableFuture<Contact> =
+        update(contactId, ContactUpdateParams.none(), requestOptions)
+
+    /** List all contacts for the organization with optional search and pagination. */
+    fun list(): CompletableFuture<ContactListResponse> = list(ContactListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactListResponse>
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none()
+    ): CompletableFuture<ContactListResponse> = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<ContactListResponse> =
+        list(ContactListParams.none(), requestOptions)
+
+    /** Soft-delete a contact. */
+    fun delete(contactId: String): CompletableFuture<DeleteResponse> =
+        delete(contactId, ContactDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        contactId: String,
+        params: ContactDeleteParams = ContactDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<DeleteResponse> =
+        delete(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        contactId: String,
+        params: ContactDeleteParams = ContactDeleteParams.none(),
+    ): CompletableFuture<DeleteResponse> = delete(contactId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: ContactDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<DeleteResponse>
+
+    /** @see delete */
+    fun delete(params: ContactDeleteParams): CompletableFuture<DeleteResponse> =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        contactId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<DeleteResponse> =
+        delete(contactId, ContactDeleteParams.none(), requestOptions)
+
+    /** Check if a contact supports iMessage and/or SMS. */
+    fun checkCapabilities(contactId: String): CompletableFuture<ContactCheckCapabilitiesResponse> =
+        checkCapabilities(contactId, ContactCheckCapabilitiesParams.none())
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
         requestOptions: RequestOptions = RequestOptions.none(),
     ): CompletableFuture<ContactCheckCapabilitiesResponse> =
-        checkCapabilities(params.toBuilder().contact(contact).build(), requestOptions)
+        checkCapabilities(params.toBuilder().contactId(contactId).build(), requestOptions)
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
     ): CompletableFuture<ContactCheckCapabilitiesResponse> =
-        checkCapabilities(contact, params, RequestOptions.none())
+        checkCapabilities(contactId, params, RequestOptions.none())
 
     /** @see checkCapabilities */
     fun checkCapabilities(
@@ -61,10 +197,10 @@ interface ContactServiceAsync {
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         requestOptions: RequestOptions,
     ): CompletableFuture<ContactCheckCapabilitiesResponse> =
-        checkCapabilities(contact, ContactCheckCapabilitiesParams.none(), requestOptions)
+        checkCapabilities(contactId, ContactCheckCapabilitiesParams.none(), requestOptions)
 
     /**
      * A view of [ContactServiceAsync] that provides access to raw HTTP responses for each method.
@@ -80,29 +216,189 @@ interface ContactServiceAsync {
             modifier: Consumer<ClientOptions.Builder>
         ): ContactServiceAsync.WithRawResponse
 
+        /** Manage contacts (phone numbers and emails) */
+        fun tags(): TagServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /contacts`, but is otherwise the same as
+         * [ContactServiceAsync.create].
+         */
+        fun create(params: ContactCreateParams): CompletableFuture<HttpResponseFor<Contact>> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        fun create(
+            params: ContactCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>>
+
+        /**
+         * Returns a raw HTTP response for `get /contacts/{contactId}`, but is otherwise the same as
+         * [ContactServiceAsync.retrieve].
+         */
+        fun retrieve(contactId: String): CompletableFuture<HttpResponseFor<Contact>> =
+            retrieve(contactId, ContactRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            contactId: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            retrieve(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            contactId: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            retrieve(contactId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>>
+
+        /** @see retrieve */
+        fun retrieve(params: ContactRetrieveParams): CompletableFuture<HttpResponseFor<Contact>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            retrieve(contactId, ContactRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `patch /contacts/{contactId}`, but is otherwise the same
+         * as [ContactServiceAsync.update].
+         */
+        fun update(contactId: String): CompletableFuture<HttpResponseFor<Contact>> =
+            update(contactId, ContactUpdateParams.none())
+
+        /** @see update */
+        fun update(
+            contactId: String,
+            params: ContactUpdateParams = ContactUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            update(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see update */
+        fun update(
+            contactId: String,
+            params: ContactUpdateParams = ContactUpdateParams.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            update(contactId, params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            params: ContactUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Contact>>
+
+        /** @see update */
+        fun update(params: ContactUpdateParams): CompletableFuture<HttpResponseFor<Contact>> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Contact>> =
+            update(contactId, ContactUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /contacts`, but is otherwise the same as
+         * [ContactServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(ContactListParams.none())
+
+        /** @see list */
+        fun list(
+            params: ContactListParams = ContactListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>>
+
+        /** @see list */
+        fun list(
+            params: ContactListParams = ContactListParams.none()
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(ContactListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /contacts/{contactId}`, but is otherwise the same
+         * as [ContactServiceAsync.delete].
+         */
+        fun delete(contactId: String): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            delete(contactId, ContactDeleteParams.none())
+
+        /** @see delete */
+        fun delete(
+            contactId: String,
+            params: ContactDeleteParams = ContactDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            delete(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see delete */
+        fun delete(
+            contactId: String,
+            params: ContactDeleteParams = ContactDeleteParams.none(),
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            delete(contactId, params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            params: ContactDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>>
+
+        /** @see delete */
+        fun delete(
+            params: ContactDeleteParams
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            delete(contactId, ContactDeleteParams.none(), requestOptions)
+
         /**
-         * Returns a raw HTTP response for `get /v1/api/contacts/{contact}/capabilities`, but is
+         * Returns a raw HTTP response for `get /contacts/{contactId}/capabilities`, but is
          * otherwise the same as [ContactServiceAsync.checkCapabilities].
          */
         fun checkCapabilities(
-            contact: String
+            contactId: String
         ): CompletableFuture<HttpResponseFor<ContactCheckCapabilitiesResponse>> =
-            checkCapabilities(contact, ContactCheckCapabilitiesParams.none())
+            checkCapabilities(contactId, ContactCheckCapabilitiesParams.none())
 
         /** @see checkCapabilities */
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
             requestOptions: RequestOptions = RequestOptions.none(),
         ): CompletableFuture<HttpResponseFor<ContactCheckCapabilitiesResponse>> =
-            checkCapabilities(params.toBuilder().contact(contact).build(), requestOptions)
+            checkCapabilities(params.toBuilder().contactId(contactId).build(), requestOptions)
 
         /** @see checkCapabilities */
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
         ): CompletableFuture<HttpResponseFor<ContactCheckCapabilitiesResponse>> =
-            checkCapabilities(contact, params, RequestOptions.none())
+            checkCapabilities(contactId, params, RequestOptions.none())
 
         /** @see checkCapabilities */
         fun checkCapabilities(
@@ -118,9 +414,9 @@ interface ContactServiceAsync {
 
         /** @see checkCapabilities */
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             requestOptions: RequestOptions,
         ): CompletableFuture<HttpResponseFor<ContactCheckCapabilitiesResponse>> =
-            checkCapabilities(contact, ContactCheckCapabilitiesParams.none(), requestOptions)
+            checkCapabilities(contactId, ContactCheckCapabilitiesParams.none(), requestOptions)
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
index b7fd70b..819ff3e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ContactServiceAsyncImpl.kt
@@ -13,15 +13,26 @@ import com.blooio.api.core.http.HttpRequest
 import com.blooio.api.core.http.HttpResponse
 import com.blooio.api.core.http.HttpResponse.Handler
 import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.contacts.Contact
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesParams
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactDeleteParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactListResponse
+import com.blooio.api.models.contacts.ContactRetrieveParams
+import com.blooio.api.models.contacts.ContactUpdateParams
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.services.async.contacts.TagServiceAsync
+import com.blooio.api.services.async.contacts.TagServiceAsyncImpl
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Contact-related operations */
+/** Manage contacts (phone numbers and emails) */
 class ContactServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     ContactServiceAsync {
 
@@ -29,16 +40,56 @@ class ContactServiceAsyncImpl internal constructor(private val clientOptions: Cl
         WithRawResponseImpl(clientOptions)
     }
 
+    private val tags: TagServiceAsync by lazy { TagServiceAsyncImpl(clientOptions) }
+
     override fun withRawResponse(): ContactServiceAsync.WithRawResponse = withRawResponse
 
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactServiceAsync =
         ContactServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Manage contacts (phone numbers and emails) */
+    override fun tags(): TagServiceAsync = tags
+
+    override fun create(
+        params: ContactCreateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Contact> =
+        // post /contacts
+        withRawResponse().create(params, requestOptions).thenApply { it.parse() }
+
+    override fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Contact> =
+        // get /contacts/{contactId}
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun update(
+        params: ContactUpdateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Contact> =
+        // patch /contacts/{contactId}
+        withRawResponse().update(params, requestOptions).thenApply { it.parse() }
+
+    override fun list(
+        params: ContactListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactListResponse> =
+        // get /contacts
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun delete(
+        params: ContactDeleteParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<DeleteResponse> =
+        // delete /contacts/{contactId}
+        withRawResponse().delete(params, requestOptions).thenApply { it.parse() }
+
     override fun checkCapabilities(
         params: ContactCheckCapabilitiesParams,
         requestOptions: RequestOptions,
     ): CompletableFuture<ContactCheckCapabilitiesResponse> =
-        // get /v1/api/contacts/{contact}/capabilities
+        // get /contacts/{contactId}/capabilities
         withRawResponse().checkCapabilities(params, requestOptions).thenApply { it.parse() }
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -47,6 +98,10 @@ class ContactServiceAsyncImpl internal constructor(private val clientOptions: Cl
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
+        private val tags: TagServiceAsync.WithRawResponse by lazy {
+            TagServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): ContactServiceAsync.WithRawResponse =
@@ -54,6 +109,169 @@ class ContactServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Manage contacts (phone numbers and emails) */
+        override fun tags(): TagServiceAsync.WithRawResponse = tags
+
+        private val createHandler: Handler<Contact> = jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: ContactCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Contact>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { createHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val retrieveHandler: Handler<Contact> =
+            jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Contact>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val updateHandler: Handler<Contact> = jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: ContactUpdateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Contact>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { updateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val listHandler: Handler<ContactListResponse> =
+            jsonHandler<ContactListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ContactListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val deleteHandler: Handler<DeleteResponse> =
+            jsonHandler<DeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: ContactDeleteParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { deleteHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
         private val checkCapabilitiesHandler: Handler<ContactCheckCapabilitiesResponse> =
             jsonHandler<ContactCheckCapabilitiesResponse>(clientOptions.jsonMapper)
 
@@ -63,12 +281,12 @@ class ContactServiceAsyncImpl internal constructor(private val clientOptions: Cl
         ): CompletableFuture<HttpResponseFor<ContactCheckCapabilitiesResponse>> {
             // We check here instead of in the params builder because this can be specified
             // positionally or in the params class.
-            checkRequired("contact", params.contact().getOrNull())
+            checkRequired("contactId", params.contactId().getOrNull())
             val request =
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "contacts", params._pathParam(0), "capabilities")
+                    .addPathSegments("contacts", params._pathParam(0), "capabilities")
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsync.kt
new file mode 100644
index 0000000..cc48907
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsync.kt
@@ -0,0 +1,75 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import com.blooio.api.models.facetime.FacetimeInitiateCallResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Initiate FaceTime calls */
+interface FacetimeServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): FacetimeServiceAsync
+
+    /**
+     * **Coming Soon** -- This endpoint is temporarily disabled while we stabilize the FaceTime call
+     * flow.
+     *
+     * Initiates a FaceTime call to the specified phone number or email address. Returns a shareable
+     * FaceTime link that anyone can use to join the call. The call will ring the contact and
+     * auto-admit the first person who joins via the link.
+     */
+    fun initiateCall(
+        params: FacetimeInitiateCallParams
+    ): CompletableFuture<FacetimeInitiateCallResponse> = initiateCall(params, RequestOptions.none())
+
+    /** @see initiateCall */
+    fun initiateCall(
+        params: FacetimeInitiateCallParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<FacetimeInitiateCallResponse>
+
+    /**
+     * A view of [FacetimeServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): FacetimeServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /facetime/calls`, but is otherwise the same as
+         * [FacetimeServiceAsync.initiateCall].
+         */
+        fun initiateCall(
+            params: FacetimeInitiateCallParams
+        ): CompletableFuture<HttpResponseFor<FacetimeInitiateCallResponse>> =
+            initiateCall(params, RequestOptions.none())
+
+        /** @see initiateCall */
+        fun initiateCall(
+            params: FacetimeInitiateCallParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<FacetimeInitiateCallResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncImpl.kt
new file mode 100644
index 0000000..7b9bed4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncImpl.kt
@@ -0,0 +1,87 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import com.blooio.api.models.facetime.FacetimeInitiateCallResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Initiate FaceTime calls */
+class FacetimeServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    FacetimeServiceAsync {
+
+    private val withRawResponse: FacetimeServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): FacetimeServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): FacetimeServiceAsync =
+        FacetimeServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun initiateCall(
+        params: FacetimeInitiateCallParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<FacetimeInitiateCallResponse> =
+        // post /facetime/calls
+        withRawResponse().initiateCall(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        FacetimeServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): FacetimeServiceAsync.WithRawResponse =
+            FacetimeServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val initiateCallHandler: Handler<FacetimeInitiateCallResponse> =
+            jsonHandler<FacetimeInitiateCallResponse>(clientOptions.jsonMapper)
+
+        override fun initiateCall(
+            params: FacetimeInitiateCallParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<FacetimeInitiateCallResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("facetime", "calls")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { initiateCallHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsync.kt
new file mode 100644
index 0000000..be25469
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsync.kt
@@ -0,0 +1,371 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.Group
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupCreateResponse
+import com.blooio.api.models.groups.GroupDeleteParams
+import com.blooio.api.models.groups.GroupDeleteResponse
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupListResponse
+import com.blooio.api.models.groups.GroupRetrieveParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import com.blooio.api.models.groups.GroupUpdateResponse
+import com.blooio.api.services.async.groups.IconServiceAsync
+import com.blooio.api.services.async.groups.MemberServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage contact groups */
+interface GroupServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): GroupServiceAsync
+
+    /** Manage group membership */
+    fun members(): MemberServiceAsync
+
+    /** Manage contact groups */
+    fun icon(): IconServiceAsync
+
+    /**
+     * Create a new group. There are two modes:
+     *
+     * **1. Link to existing iMessage chat:** Provide `chat_guid` to join an existing group chat
+     * that was created outside the API. The `members` list records who is in the group but does NOT
+     * add them to the linked iMessage chat. Multiple groups can have the same participants if they
+     * have different `chat_guid`s.
+     *
+     * **2. Create new group:** Omit `chat_guid` to create a new group. When you send the first
+     * message, a new iMessage chat will be created. Note: iMessage only allows one chat per unique
+     * participant set when created via API.
+     */
+    fun create(params: GroupCreateParams): CompletableFuture<GroupCreateResponse> =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: GroupCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupCreateResponse>
+
+    /** Get details for a specific group. */
+    fun retrieve(groupId: String): CompletableFuture<Group> =
+        retrieve(groupId, GroupRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        groupId: String,
+        params: GroupRetrieveParams = GroupRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Group> =
+        retrieve(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        groupId: String,
+        params: GroupRetrieveParams = GroupRetrieveParams.none(),
+    ): CompletableFuture<Group> = retrieve(groupId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: GroupRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Group>
+
+    /** @see retrieve */
+    fun retrieve(params: GroupRetrieveParams): CompletableFuture<Group> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(groupId: String, requestOptions: RequestOptions): CompletableFuture<Group> =
+        retrieve(groupId, GroupRetrieveParams.none(), requestOptions)
+
+    /**
+     * Update a group's name. If the group has a linked `chat_guid`, the display name will also be
+     * updated in the linked iMessage chat. Note: iMessage only allows one chat per unique
+     * participant set, so renaming simply changes the display name on the existing chat thread.
+     */
+    fun update(groupId: String): CompletableFuture<GroupUpdateResponse> =
+        update(groupId, GroupUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        groupId: String,
+        params: GroupUpdateParams = GroupUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupUpdateResponse> =
+        update(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        groupId: String,
+        params: GroupUpdateParams = GroupUpdateParams.none(),
+    ): CompletableFuture<GroupUpdateResponse> = update(groupId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: GroupUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupUpdateResponse>
+
+    /** @see update */
+    fun update(params: GroupUpdateParams): CompletableFuture<GroupUpdateResponse> =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        groupId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupUpdateResponse> =
+        update(groupId, GroupUpdateParams.none(), requestOptions)
+
+    /** List all groups for the organization with optional search and pagination. */
+    fun list(): CompletableFuture<GroupListResponse> = list(GroupListParams.none())
+
+    /** @see list */
+    fun list(
+        params: GroupListParams = GroupListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupListResponse>
+
+    /** @see list */
+    fun list(
+        params: GroupListParams = GroupListParams.none()
+    ): CompletableFuture<GroupListResponse> = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<GroupListResponse> =
+        list(GroupListParams.none(), requestOptions)
+
+    /**
+     * Soft-delete a group. Members are automatically removed. If the group is linked to an existing
+     * iMessage chat, the number also leaves that chat.
+     */
+    fun delete(groupId: String): CompletableFuture<GroupDeleteResponse> =
+        delete(groupId, GroupDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        groupId: String,
+        params: GroupDeleteParams = GroupDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupDeleteResponse> =
+        delete(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        groupId: String,
+        params: GroupDeleteParams = GroupDeleteParams.none(),
+    ): CompletableFuture<GroupDeleteResponse> = delete(groupId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: GroupDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupDeleteResponse>
+
+    /** @see delete */
+    fun delete(params: GroupDeleteParams): CompletableFuture<GroupDeleteResponse> =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        groupId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupDeleteResponse> =
+        delete(groupId, GroupDeleteParams.none(), requestOptions)
+
+    /** A view of [GroupServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): GroupServiceAsync.WithRawResponse
+
+        /** Manage group membership */
+        fun members(): MemberServiceAsync.WithRawResponse
+
+        /** Manage contact groups */
+        fun icon(): IconServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /groups`, but is otherwise the same as
+         * [GroupServiceAsync.create].
+         */
+        fun create(
+            params: GroupCreateParams
+        ): CompletableFuture<HttpResponseFor<GroupCreateResponse>> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        fun create(
+            params: GroupCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupCreateResponse>>
+
+        /**
+         * Returns a raw HTTP response for `get /groups/{groupId}`, but is otherwise the same as
+         * [GroupServiceAsync.retrieve].
+         */
+        fun retrieve(groupId: String): CompletableFuture<HttpResponseFor<Group>> =
+            retrieve(groupId, GroupRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            groupId: String,
+            params: GroupRetrieveParams = GroupRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Group>> =
+            retrieve(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            groupId: String,
+            params: GroupRetrieveParams = GroupRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<Group>> =
+            retrieve(groupId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: GroupRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Group>>
+
+        /** @see retrieve */
+        fun retrieve(params: GroupRetrieveParams): CompletableFuture<HttpResponseFor<Group>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Group>> =
+            retrieve(groupId, GroupRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `patch /groups/{groupId}`, but is otherwise the same as
+         * [GroupServiceAsync.update].
+         */
+        fun update(groupId: String): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> =
+            update(groupId, GroupUpdateParams.none())
+
+        /** @see update */
+        fun update(
+            groupId: String,
+            params: GroupUpdateParams = GroupUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> =
+            update(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see update */
+        fun update(
+            groupId: String,
+            params: GroupUpdateParams = GroupUpdateParams.none(),
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> =
+            update(groupId, params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            params: GroupUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>>
+
+        /** @see update */
+        fun update(
+            params: GroupUpdateParams
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> =
+            update(groupId, GroupUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /groups`, but is otherwise the same as
+         * [GroupServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<GroupListResponse>> =
+            list(GroupListParams.none())
+
+        /** @see list */
+        fun list(
+            params: GroupListParams = GroupListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupListResponse>>
+
+        /** @see list */
+        fun list(
+            params: GroupListParams = GroupListParams.none()
+        ): CompletableFuture<HttpResponseFor<GroupListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<GroupListResponse>> =
+            list(GroupListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}`, but is otherwise the same as
+         * [GroupServiceAsync.delete].
+         */
+        fun delete(groupId: String): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> =
+            delete(groupId, GroupDeleteParams.none())
+
+        /** @see delete */
+        fun delete(
+            groupId: String,
+            params: GroupDeleteParams = GroupDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> =
+            delete(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see delete */
+        fun delete(
+            groupId: String,
+            params: GroupDeleteParams = GroupDeleteParams.none(),
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> =
+            delete(groupId, params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            params: GroupDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>>
+
+        /** @see delete */
+        fun delete(
+            params: GroupDeleteParams
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> =
+            delete(groupId, GroupDeleteParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsyncImpl.kt
new file mode 100644
index 0000000..1b295a6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/GroupServiceAsyncImpl.kt
@@ -0,0 +1,283 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.groups.Group
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupCreateResponse
+import com.blooio.api.models.groups.GroupDeleteParams
+import com.blooio.api.models.groups.GroupDeleteResponse
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupListResponse
+import com.blooio.api.models.groups.GroupRetrieveParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import com.blooio.api.models.groups.GroupUpdateResponse
+import com.blooio.api.services.async.groups.IconServiceAsync
+import com.blooio.api.services.async.groups.IconServiceAsyncImpl
+import com.blooio.api.services.async.groups.MemberServiceAsync
+import com.blooio.api.services.async.groups.MemberServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contact groups */
+class GroupServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    GroupServiceAsync {
+
+    private val withRawResponse: GroupServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val members: MemberServiceAsync by lazy { MemberServiceAsyncImpl(clientOptions) }
+
+    private val icon: IconServiceAsync by lazy { IconServiceAsyncImpl(clientOptions) }
+
+    override fun withRawResponse(): GroupServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): GroupServiceAsync =
+        GroupServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage group membership */
+    override fun members(): MemberServiceAsync = members
+
+    /** Manage contact groups */
+    override fun icon(): IconServiceAsync = icon
+
+    override fun create(
+        params: GroupCreateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupCreateResponse> =
+        // post /groups
+        withRawResponse().create(params, requestOptions).thenApply { it.parse() }
+
+    override fun retrieve(
+        params: GroupRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Group> =
+        // get /groups/{groupId}
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun update(
+        params: GroupUpdateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupUpdateResponse> =
+        // patch /groups/{groupId}
+        withRawResponse().update(params, requestOptions).thenApply { it.parse() }
+
+    override fun list(
+        params: GroupListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupListResponse> =
+        // get /groups
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun delete(
+        params: GroupDeleteParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupDeleteResponse> =
+        // delete /groups/{groupId}
+        withRawResponse().delete(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        GroupServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val members: MemberServiceAsync.WithRawResponse by lazy {
+            MemberServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val icon: IconServiceAsync.WithRawResponse by lazy {
+            IconServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): GroupServiceAsync.WithRawResponse =
+            GroupServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage group membership */
+        override fun members(): MemberServiceAsync.WithRawResponse = members
+
+        /** Manage contact groups */
+        override fun icon(): IconServiceAsync.WithRawResponse = icon
+
+        private val createHandler: Handler<GroupCreateResponse> =
+            jsonHandler<GroupCreateResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: GroupCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupCreateResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { createHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val retrieveHandler: Handler<Group> = jsonHandler<Group>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: GroupRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Group>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val updateHandler: Handler<GroupUpdateResponse> =
+            jsonHandler<GroupUpdateResponse>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: GroupUpdateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupUpdateResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { updateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val listHandler: Handler<GroupListResponse> =
+            jsonHandler<GroupListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: GroupListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val deleteHandler: Handler<GroupDeleteResponse> =
+            jsonHandler<GroupDeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: GroupDeleteParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupDeleteResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { deleteHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsync.kt
similarity index 65%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsync.kt
index ded859c..e72363d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ConfigServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsync.kt
@@ -3,10 +3,10 @@
 package com.blooio.api.services.async
 
 import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.async.config.WebhookServiceAsync
+import com.blooio.api.services.async.location.ContactServiceAsync
 import java.util.function.Consumer
 
-interface ConfigServiceAsync {
+interface LocationServiceAsync {
 
     /**
      * Returns a view of this service that provides access to raw HTTP responses for each method.
@@ -18,13 +18,13 @@ interface ConfigServiceAsync {
      *
      * The original service is not modified.
      */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigServiceAsync
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LocationServiceAsync
 
-    /** Account-level configuration */
-    fun webhook(): WebhookServiceAsync
+    /** FindMy contact location tracking */
+    fun contacts(): ContactServiceAsync
 
     /**
-     * A view of [ConfigServiceAsync] that provides access to raw HTTP responses for each method.
+     * A view of [LocationServiceAsync] that provides access to raw HTTP responses for each method.
      */
     interface WithRawResponse {
 
@@ -35,9 +35,9 @@ interface ConfigServiceAsync {
          */
         fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
-        ): ConfigServiceAsync.WithRawResponse
+        ): LocationServiceAsync.WithRawResponse
 
-        /** Account-level configuration */
-        fun webhook(): WebhookServiceAsync.WithRawResponse
+        /** FindMy contact location tracking */
+        fun contacts(): ContactServiceAsync.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsyncImpl.kt
new file mode 100644
index 0000000..4424297
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/LocationServiceAsyncImpl.kt
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.services.async.location.ContactServiceAsync
+import com.blooio.api.services.async.location.ContactServiceAsyncImpl
+import java.util.function.Consumer
+
+class LocationServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    LocationServiceAsync {
+
+    private val withRawResponse: LocationServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val contacts: ContactServiceAsync by lazy { ContactServiceAsyncImpl(clientOptions) }
+
+    override fun withRawResponse(): LocationServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LocationServiceAsync =
+        LocationServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** FindMy contact location tracking */
+    override fun contacts(): ContactServiceAsync = contacts
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        LocationServiceAsync.WithRawResponse {
+
+        private val contacts: ContactServiceAsync.WithRawResponse by lazy {
+            ContactServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): LocationServiceAsync.WithRawResponse =
+            LocationServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** FindMy contact location tracking */
+        override fun contacts(): ContactServiceAsync.WithRawResponse = contacts
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
index ec55599..b1356f9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsync.kt
@@ -7,10 +7,11 @@ import com.blooio.api.core.RequestOptions
 import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.models.me.MeRetrieveParams
 import com.blooio.api.models.me.MeRetrieveResponse
+import com.blooio.api.services.async.me.NumberServiceAsync
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
-/** Account and API key information */
+/** Authentication and account information */
 interface MeServiceAsync {
 
     /**
@@ -25,9 +26,12 @@ interface MeServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeServiceAsync
 
+    /** Manage phone numbers linked to your account */
+    fun numbers(): NumberServiceAsync
+
     /**
-     * Returns information about the authenticated API key including plan, devices, usage
-     * statistics, and integration details.
+     * Returns details about the authenticated API key or dashboard user, including organization
+     * info, devices, and usage statistics.
      */
     fun retrieve(): CompletableFuture<MeRetrieveResponse> = retrieve(MeRetrieveParams.none())
 
@@ -56,8 +60,11 @@ interface MeServiceAsync {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeServiceAsync.WithRawResponse
 
+        /** Manage phone numbers linked to your account */
+        fun numbers(): NumberServiceAsync.WithRawResponse
+
         /**
-         * Returns a raw HTTP response for `get /v1/api/me`, but is otherwise the same as
+         * Returns a raw HTTP response for `get /me`, but is otherwise the same as
          * [MeServiceAsync.retrieve].
          */
         fun retrieve(): CompletableFuture<HttpResponseFor<MeRetrieveResponse>> =
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
index 2e07d54..254d916 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MeServiceAsyncImpl.kt
@@ -16,10 +16,12 @@ import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepareAsync
 import com.blooio.api.models.me.MeRetrieveParams
 import com.blooio.api.models.me.MeRetrieveResponse
+import com.blooio.api.services.async.me.NumberServiceAsync
+import com.blooio.api.services.async.me.NumberServiceAsyncImpl
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
-/** Account and API key information */
+/** Authentication and account information */
 class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     MeServiceAsync {
 
@@ -27,16 +29,21 @@ class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientO
         WithRawResponseImpl(clientOptions)
     }
 
+    private val numbers: NumberServiceAsync by lazy { NumberServiceAsyncImpl(clientOptions) }
+
     override fun withRawResponse(): MeServiceAsync.WithRawResponse = withRawResponse
 
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeServiceAsync =
         MeServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Manage phone numbers linked to your account */
+    override fun numbers(): NumberServiceAsync = numbers
+
     override fun retrieve(
         params: MeRetrieveParams,
         requestOptions: RequestOptions,
     ): CompletableFuture<MeRetrieveResponse> =
-        // get /v1/api/me
+        // get /me
         withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -45,6 +52,10 @@ class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientO
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
+        private val numbers: NumberServiceAsync.WithRawResponse by lazy {
+            NumberServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): MeServiceAsync.WithRawResponse =
@@ -52,6 +63,9 @@ class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientO
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Manage phone numbers linked to your account */
+        override fun numbers(): NumberServiceAsync.WithRawResponse = numbers
+
         private val retrieveHandler: Handler<MeRetrieveResponse> =
             jsonHandler<MeRetrieveResponse>(clientOptions.jsonMapper)
 
@@ -63,7 +77,7 @@ class MeServiceAsyncImpl internal constructor(private val clientOptions: ClientO
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "me")
+                    .addPathSegments("me")
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
deleted file mode 100644
index dbbe25c..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsync.kt
+++ /dev/null
@@ -1,321 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponseFor
-import com.blooio.api.models.messages.MessageCancelParams
-import com.blooio.api.models.messages.MessageCancelResponse
-import com.blooio.api.models.messages.MessageGetStatusParams
-import com.blooio.api.models.messages.MessageGetStatusResponse
-import com.blooio.api.models.messages.MessageRetrieveParams
-import com.blooio.api.models.messages.MessageRetrieveResponse
-import com.blooio.api.models.messages.MessageSendParams
-import com.blooio.api.models.messages.MessageSendResponse
-import java.util.concurrent.CompletableFuture
-import java.util.function.Consumer
-
-/** Send and manage individual messages */
-interface MessageServiceAsync {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageServiceAsync
-
-    /**
-     * Retrieve full message metadata including direction, protocol, text length, attachments count,
-     * timestamps, current status, and original metadata.
-     */
-    fun retrieve(messageId: String): CompletableFuture<MessageRetrieveResponse> =
-        retrieve(messageId, MessageRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        messageId: String,
-        params: MessageRetrieveParams = MessageRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageRetrieveResponse> =
-        retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see retrieve */
-    fun retrieve(
-        messageId: String,
-        params: MessageRetrieveParams = MessageRetrieveParams.none(),
-    ): CompletableFuture<MessageRetrieveResponse> =
-        retrieve(messageId, params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: MessageRetrieveParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageRetrieveResponse>
-
-    /** @see retrieve */
-    fun retrieve(params: MessageRetrieveParams): CompletableFuture<MessageRetrieveResponse> =
-        retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        messageId: String,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<MessageRetrieveResponse> =
-        retrieve(messageId, MessageRetrieveParams.none(), requestOptions)
-
-    /**
-     * Request cancellation for a queued or scheduled message. If the message is already in a
-     * non-cancellable state (e.g., sent), the response indicates the current status. Note: response
-     * may include deprecated `current_status`; use `status` instead.
-     */
-    fun cancel(messageId: String): CompletableFuture<MessageCancelResponse> =
-        cancel(messageId, MessageCancelParams.none())
-
-    /** @see cancel */
-    fun cancel(
-        messageId: String,
-        params: MessageCancelParams = MessageCancelParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageCancelResponse> =
-        cancel(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see cancel */
-    fun cancel(
-        messageId: String,
-        params: MessageCancelParams = MessageCancelParams.none(),
-    ): CompletableFuture<MessageCancelResponse> = cancel(messageId, params, RequestOptions.none())
-
-    /** @see cancel */
-    fun cancel(
-        params: MessageCancelParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageCancelResponse>
-
-    /** @see cancel */
-    fun cancel(params: MessageCancelParams): CompletableFuture<MessageCancelResponse> =
-        cancel(params, RequestOptions.none())
-
-    /** @see cancel */
-    fun cancel(
-        messageId: String,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<MessageCancelResponse> =
-        cancel(messageId, MessageCancelParams.none(), requestOptions)
-
-    /** Get current delivery status only */
-    fun getStatus(messageId: String): CompletableFuture<MessageGetStatusResponse> =
-        getStatus(messageId, MessageGetStatusParams.none())
-
-    /** @see getStatus */
-    fun getStatus(
-        messageId: String,
-        params: MessageGetStatusParams = MessageGetStatusParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageGetStatusResponse> =
-        getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see getStatus */
-    fun getStatus(
-        messageId: String,
-        params: MessageGetStatusParams = MessageGetStatusParams.none(),
-    ): CompletableFuture<MessageGetStatusResponse> =
-        getStatus(messageId, params, RequestOptions.none())
-
-    /** @see getStatus */
-    fun getStatus(
-        params: MessageGetStatusParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageGetStatusResponse>
-
-    /** @see getStatus */
-    fun getStatus(params: MessageGetStatusParams): CompletableFuture<MessageGetStatusResponse> =
-        getStatus(params, RequestOptions.none())
-
-    /** @see getStatus */
-    fun getStatus(
-        messageId: String,
-        requestOptions: RequestOptions,
-    ): CompletableFuture<MessageGetStatusResponse> =
-        getStatus(messageId, MessageGetStatusParams.none(), requestOptions)
-
-    /**
-     * Queues an outbound iMessage/SMS to the specified phone number.
-     *
-     * Supports optional media attachments via public URLs, and arbitrary metadata for correlation.
-     *
-     * For safe retries, provide an `Idempotency-Key` header. If the same key is used twice, the
-     * original message will be returned with 200; otherwise a new message is queued with 202.
-     */
-    fun send(params: MessageSendParams): CompletableFuture<MessageSendResponse> =
-        send(params, RequestOptions.none())
-
-    /** @see send */
-    fun send(
-        params: MessageSendParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<MessageSendResponse>
-
-    /**
-     * A view of [MessageServiceAsync] that provides access to raw HTTP responses for each method.
-     */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): MessageServiceAsync.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/messages/{messageId}`, but is otherwise the
-         * same as [MessageServiceAsync.retrieve].
-         */
-        fun retrieve(
-            messageId: String
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
-            retrieve(messageId, MessageRetrieveParams.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            messageId: String,
-            params: MessageRetrieveParams = MessageRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
-            retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see retrieve */
-        fun retrieve(
-            messageId: String,
-            params: MessageRetrieveParams = MessageRetrieveParams.none(),
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
-            retrieve(messageId, params, RequestOptions.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            params: MessageRetrieveParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>>
-
-        /** @see retrieve */
-        fun retrieve(
-            params: MessageRetrieveParams
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
-            retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
-            retrieve(messageId, MessageRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `delete /v1/api/messages/{messageId}`, but is otherwise
-         * the same as [MessageServiceAsync.cancel].
-         */
-        fun cancel(messageId: String): CompletableFuture<HttpResponseFor<MessageCancelResponse>> =
-            cancel(messageId, MessageCancelParams.none())
-
-        /** @see cancel */
-        fun cancel(
-            messageId: String,
-            params: MessageCancelParams = MessageCancelParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>> =
-            cancel(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see cancel */
-        fun cancel(
-            messageId: String,
-            params: MessageCancelParams = MessageCancelParams.none(),
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>> =
-            cancel(messageId, params, RequestOptions.none())
-
-        /** @see cancel */
-        fun cancel(
-            params: MessageCancelParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>>
-
-        /** @see cancel */
-        fun cancel(
-            params: MessageCancelParams
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>> =
-            cancel(params, RequestOptions.none())
-
-        /** @see cancel */
-        fun cancel(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>> =
-            cancel(messageId, MessageCancelParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/messages/{messageId}/status`, but is
-         * otherwise the same as [MessageServiceAsync.getStatus].
-         */
-        fun getStatus(
-            messageId: String
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
-            getStatus(messageId, MessageGetStatusParams.none())
-
-        /** @see getStatus */
-        fun getStatus(
-            messageId: String,
-            params: MessageGetStatusParams = MessageGetStatusParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
-            getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see getStatus */
-        fun getStatus(
-            messageId: String,
-            params: MessageGetStatusParams = MessageGetStatusParams.none(),
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
-            getStatus(messageId, params, RequestOptions.none())
-
-        /** @see getStatus */
-        fun getStatus(
-            params: MessageGetStatusParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>>
-
-        /** @see getStatus */
-        fun getStatus(
-            params: MessageGetStatusParams
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
-            getStatus(params, RequestOptions.none())
-
-        /** @see getStatus */
-        fun getStatus(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
-            getStatus(messageId, MessageGetStatusParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `post /v1/api/messages`, but is otherwise the same as
-         * [MessageServiceAsync.send].
-         */
-        fun send(
-            params: MessageSendParams
-        ): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
-            send(params, RequestOptions.none())
-
-        /** @see send */
-        fun send(
-            params: MessageSendParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<MessageSendResponse>>
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsync.kt
new file mode 100644
index 0000000..48df20d
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsync.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateResponse
+import com.blooio.api.services.async.phonenumbers.LookupServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+interface PhoneNumberServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): PhoneNumberServiceAsync
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    fun lookup(): LookupServiceAsync
+
+    /**
+     * Look up multiple phone numbers in a single request. Returns the same detailed information as
+     * the single lookup endpoint for each number. Maximum 100 numbers per request.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise).
+     */
+    fun batchCreate(
+        params: PhoneNumberBatchCreateParams
+    ): CompletableFuture<PhoneNumberBatchCreateResponse> =
+        batchCreate(params, RequestOptions.none())
+
+    /** @see batchCreate */
+    fun batchCreate(
+        params: PhoneNumberBatchCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PhoneNumberBatchCreateResponse>
+
+    /**
+     * A view of [PhoneNumberServiceAsync] that provides access to raw HTTP responses for each
+     * method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PhoneNumberServiceAsync.WithRawResponse
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        fun lookup(): LookupServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /phone-numbers/batch`, but is otherwise the same as
+         * [PhoneNumberServiceAsync.batchCreate].
+         */
+        fun batchCreate(
+            params: PhoneNumberBatchCreateParams
+        ): CompletableFuture<HttpResponseFor<PhoneNumberBatchCreateResponse>> =
+            batchCreate(params, RequestOptions.none())
+
+        /** @see batchCreate */
+        fun batchCreate(
+            params: PhoneNumberBatchCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PhoneNumberBatchCreateResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncImpl.kt
new file mode 100644
index 0000000..d010266
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncImpl.kt
@@ -0,0 +1,110 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateResponse
+import com.blooio.api.services.async.phonenumbers.LookupServiceAsync
+import com.blooio.api.services.async.phonenumbers.LookupServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+class PhoneNumberServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    PhoneNumberServiceAsync {
+
+    private val withRawResponse: PhoneNumberServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val lookup: LookupServiceAsync by lazy { LookupServiceAsyncImpl(clientOptions) }
+
+    override fun withRawResponse(): PhoneNumberServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): PhoneNumberServiceAsync =
+        PhoneNumberServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    override fun lookup(): LookupServiceAsync = lookup
+
+    override fun batchCreate(
+        params: PhoneNumberBatchCreateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<PhoneNumberBatchCreateResponse> =
+        // post /phone-numbers/batch
+        withRawResponse().batchCreate(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        PhoneNumberServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val lookup: LookupServiceAsync.WithRawResponse by lazy {
+            LookupServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PhoneNumberServiceAsync.WithRawResponse =
+            PhoneNumberServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        override fun lookup(): LookupServiceAsync.WithRawResponse = lookup
+
+        private val batchCreateHandler: Handler<PhoneNumberBatchCreateResponse> =
+            jsonHandler<PhoneNumberBatchCreateResponse>(clientOptions.jsonMapper)
+
+        override fun batchCreate(
+            params: PhoneNumberBatchCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<PhoneNumberBatchCreateResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("phone-numbers", "batch")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { batchCreateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsync.kt
new file mode 100644
index 0000000..0ee9175
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsync.kt
@@ -0,0 +1,349 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.Webhook
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookCreateResponse
+import com.blooio.api.models.webhooks.WebhookDeleteParams
+import com.blooio.api.models.webhooks.WebhookDeleteResponse
+import com.blooio.api.models.webhooks.WebhookListParams
+import com.blooio.api.models.webhooks.WebhookListResponse
+import com.blooio.api.models.webhooks.WebhookRetrieveParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import com.blooio.api.services.async.webhooks.LogServiceAsync
+import com.blooio.api.services.async.webhooks.SecretServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage webhook subscriptions */
+interface WebhookServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookServiceAsync
+
+    /** Manage webhook subscriptions */
+    fun secret(): SecretServiceAsync
+
+    /** View and replay webhook deliveries */
+    fun logs(): LogServiceAsync
+
+    /** Create a new webhook subscription. */
+    fun create(params: WebhookCreateParams): CompletableFuture<WebhookCreateResponse> =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: WebhookCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<WebhookCreateResponse>
+
+    /** Get details for a specific webhook. */
+    fun retrieve(webhookId: String): CompletableFuture<Webhook> =
+        retrieve(webhookId, WebhookRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        webhookId: String,
+        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Webhook> =
+        retrieve(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        webhookId: String,
+        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+    ): CompletableFuture<Webhook> = retrieve(webhookId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: WebhookRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Webhook>
+
+    /** @see retrieve */
+    fun retrieve(params: WebhookRetrieveParams): CompletableFuture<Webhook> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(webhookId: String, requestOptions: RequestOptions): CompletableFuture<Webhook> =
+        retrieve(webhookId, WebhookRetrieveParams.none(), requestOptions)
+
+    /** Update a webhook's configuration. */
+    fun update(webhookId: String): CompletableFuture<Webhook> =
+        update(webhookId, WebhookUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        webhookId: String,
+        params: WebhookUpdateParams = WebhookUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Webhook> =
+        update(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        webhookId: String,
+        params: WebhookUpdateParams = WebhookUpdateParams.none(),
+    ): CompletableFuture<Webhook> = update(webhookId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: WebhookUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Webhook>
+
+    /** @see update */
+    fun update(params: WebhookUpdateParams): CompletableFuture<Webhook> =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(webhookId: String, requestOptions: RequestOptions): CompletableFuture<Webhook> =
+        update(webhookId, WebhookUpdateParams.none(), requestOptions)
+
+    /** List all webhooks for the organization. */
+    fun list(): CompletableFuture<WebhookListResponse> = list(WebhookListParams.none())
+
+    /** @see list */
+    fun list(
+        params: WebhookListParams = WebhookListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<WebhookListResponse>
+
+    /** @see list */
+    fun list(
+        params: WebhookListParams = WebhookListParams.none()
+    ): CompletableFuture<WebhookListResponse> = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<WebhookListResponse> =
+        list(WebhookListParams.none(), requestOptions)
+
+    /** Permanently delete a webhook. */
+    fun delete(webhookId: String): CompletableFuture<WebhookDeleteResponse> =
+        delete(webhookId, WebhookDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        webhookId: String,
+        params: WebhookDeleteParams = WebhookDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<WebhookDeleteResponse> =
+        delete(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        webhookId: String,
+        params: WebhookDeleteParams = WebhookDeleteParams.none(),
+    ): CompletableFuture<WebhookDeleteResponse> = delete(webhookId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: WebhookDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<WebhookDeleteResponse>
+
+    /** @see delete */
+    fun delete(params: WebhookDeleteParams): CompletableFuture<WebhookDeleteResponse> =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        webhookId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<WebhookDeleteResponse> =
+        delete(webhookId, WebhookDeleteParams.none(), requestOptions)
+
+    /**
+     * A view of [WebhookServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): WebhookServiceAsync.WithRawResponse
+
+        /** Manage webhook subscriptions */
+        fun secret(): SecretServiceAsync.WithRawResponse
+
+        /** View and replay webhook deliveries */
+        fun logs(): LogServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks`, but is otherwise the same as
+         * [WebhookServiceAsync.create].
+         */
+        fun create(
+            params: WebhookCreateParams
+        ): CompletableFuture<HttpResponseFor<WebhookCreateResponse>> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        fun create(
+            params: WebhookCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<WebhookCreateResponse>>
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks/{webhookId}`, but is otherwise the same as
+         * [WebhookServiceAsync.retrieve].
+         */
+        fun retrieve(webhookId: String): CompletableFuture<HttpResponseFor<Webhook>> =
+            retrieve(webhookId, WebhookRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            webhookId: String,
+            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            retrieve(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            webhookId: String,
+            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            retrieve(webhookId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: WebhookRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>>
+
+        /** @see retrieve */
+        fun retrieve(params: WebhookRetrieveParams): CompletableFuture<HttpResponseFor<Webhook>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            retrieve(webhookId, WebhookRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `patch /webhooks/{webhookId}`, but is otherwise the same
+         * as [WebhookServiceAsync.update].
+         */
+        fun update(webhookId: String): CompletableFuture<HttpResponseFor<Webhook>> =
+            update(webhookId, WebhookUpdateParams.none())
+
+        /** @see update */
+        fun update(
+            webhookId: String,
+            params: WebhookUpdateParams = WebhookUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            update(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see update */
+        fun update(
+            webhookId: String,
+            params: WebhookUpdateParams = WebhookUpdateParams.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            update(webhookId, params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            params: WebhookUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<Webhook>>
+
+        /** @see update */
+        fun update(params: WebhookUpdateParams): CompletableFuture<HttpResponseFor<Webhook>> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Webhook>> =
+            update(webhookId, WebhookUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks`, but is otherwise the same as
+         * [WebhookServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<WebhookListResponse>> =
+            list(WebhookListParams.none())
+
+        /** @see list */
+        fun list(
+            params: WebhookListParams = WebhookListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<WebhookListResponse>>
+
+        /** @see list */
+        fun list(
+            params: WebhookListParams = WebhookListParams.none()
+        ): CompletableFuture<HttpResponseFor<WebhookListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<WebhookListResponse>> =
+            list(WebhookListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /webhooks/{webhookId}`, but is otherwise the same
+         * as [WebhookServiceAsync.delete].
+         */
+        fun delete(webhookId: String): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> =
+            delete(webhookId, WebhookDeleteParams.none())
+
+        /** @see delete */
+        fun delete(
+            webhookId: String,
+            params: WebhookDeleteParams = WebhookDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> =
+            delete(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see delete */
+        fun delete(
+            webhookId: String,
+            params: WebhookDeleteParams = WebhookDeleteParams.none(),
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> =
+            delete(webhookId, params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            params: WebhookDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>>
+
+        /** @see delete */
+        fun delete(
+            params: WebhookDeleteParams
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> =
+            delete(webhookId, WebhookDeleteParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsyncImpl.kt
new file mode 100644
index 0000000..12509a0
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/WebhookServiceAsyncImpl.kt
@@ -0,0 +1,282 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.webhooks.Webhook
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookCreateResponse
+import com.blooio.api.models.webhooks.WebhookDeleteParams
+import com.blooio.api.models.webhooks.WebhookDeleteResponse
+import com.blooio.api.models.webhooks.WebhookListParams
+import com.blooio.api.models.webhooks.WebhookListResponse
+import com.blooio.api.models.webhooks.WebhookRetrieveParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import com.blooio.api.services.async.webhooks.LogServiceAsync
+import com.blooio.api.services.async.webhooks.LogServiceAsyncImpl
+import com.blooio.api.services.async.webhooks.SecretServiceAsync
+import com.blooio.api.services.async.webhooks.SecretServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage webhook subscriptions */
+class WebhookServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    WebhookServiceAsync {
+
+    private val withRawResponse: WebhookServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val secret: SecretServiceAsync by lazy { SecretServiceAsyncImpl(clientOptions) }
+
+    private val logs: LogServiceAsync by lazy { LogServiceAsyncImpl(clientOptions) }
+
+    override fun withRawResponse(): WebhookServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookServiceAsync =
+        WebhookServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage webhook subscriptions */
+    override fun secret(): SecretServiceAsync = secret
+
+    /** View and replay webhook deliveries */
+    override fun logs(): LogServiceAsync = logs
+
+    override fun create(
+        params: WebhookCreateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<WebhookCreateResponse> =
+        // post /webhooks
+        withRawResponse().create(params, requestOptions).thenApply { it.parse() }
+
+    override fun retrieve(
+        params: WebhookRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Webhook> =
+        // get /webhooks/{webhookId}
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun update(
+        params: WebhookUpdateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Webhook> =
+        // patch /webhooks/{webhookId}
+        withRawResponse().update(params, requestOptions).thenApply { it.parse() }
+
+    override fun list(
+        params: WebhookListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<WebhookListResponse> =
+        // get /webhooks
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun delete(
+        params: WebhookDeleteParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<WebhookDeleteResponse> =
+        // delete /webhooks/{webhookId}
+        withRawResponse().delete(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        WebhookServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val secret: SecretServiceAsync.WithRawResponse by lazy {
+            SecretServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val logs: LogServiceAsync.WithRawResponse by lazy {
+            LogServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): WebhookServiceAsync.WithRawResponse =
+            WebhookServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage webhook subscriptions */
+        override fun secret(): SecretServiceAsync.WithRawResponse = secret
+
+        /** View and replay webhook deliveries */
+        override fun logs(): LogServiceAsync.WithRawResponse = logs
+
+        private val createHandler: Handler<WebhookCreateResponse> =
+            jsonHandler<WebhookCreateResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: WebhookCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<WebhookCreateResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { createHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val retrieveHandler: Handler<Webhook> =
+            jsonHandler<Webhook>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: WebhookRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Webhook>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val updateHandler: Handler<Webhook> = jsonHandler<Webhook>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: WebhookUpdateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<Webhook>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { updateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val listHandler: Handler<WebhookListResponse> =
+            jsonHandler<WebhookListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: WebhookListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<WebhookListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val deleteHandler: Handler<WebhookDeleteResponse> =
+            jsonHandler<WebhookDeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: WebhookDeleteParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<WebhookDeleteResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { deleteHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
new file mode 100644
index 0000000..b40cb9d
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
@@ -0,0 +1,260 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.background.BackgroundRemoveParams
+import com.blooio.api.models.chats.background.BackgroundRetrieveParams
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import com.blooio.api.models.chats.background.ChatBackgroundResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Set, get, and remove conversation backgrounds */
+interface BackgroundServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): BackgroundServiceAsync
+
+    /**
+     * Get the current background image metadata for a conversation. Works for both 1-on-1 and group
+     * chats.
+     */
+    fun retrieve(chatId: String): CompletableFuture<ChatBackgroundResponse> =
+        retrieve(chatId, BackgroundRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse> =
+        retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+    ): CompletableFuture<ChatBackgroundResponse> = retrieve(chatId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: BackgroundRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse>
+
+    /** @see retrieve */
+    fun retrieve(params: BackgroundRetrieveParams): CompletableFuture<ChatBackgroundResponse> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatBackgroundResponse> =
+        retrieve(chatId, BackgroundRetrieveParams.none(), requestOptions)
+
+    /** Remove the background image from a conversation, reverting to the default appearance. */
+    fun remove(chatId: String): CompletableFuture<ChatBackgroundResponse> =
+        remove(chatId, BackgroundRemoveParams.none())
+
+    /** @see remove */
+    fun remove(
+        chatId: String,
+        params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse> =
+        remove(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(
+        chatId: String,
+        params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+    ): CompletableFuture<ChatBackgroundResponse> = remove(chatId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: BackgroundRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse>
+
+    /** @see remove */
+    fun remove(params: BackgroundRemoveParams): CompletableFuture<ChatBackgroundResponse> =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatBackgroundResponse> =
+        remove(chatId, BackgroundRemoveParams.none(), requestOptions)
+
+    /**
+     * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
+     *
+     * The uploaded image is converted into a PosterKit-compatible archive and applied to the
+     * iMessage conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP,
+     * HEIC/HEIF. Maximum file size: 10 MB.
+     */
+    fun set(
+        chatId: String,
+        params: BackgroundSetParams,
+    ): CompletableFuture<ChatBackgroundResponse> = set(chatId, params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        chatId: String,
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse> =
+        set(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see set */
+    fun set(params: BackgroundSetParams): CompletableFuture<ChatBackgroundResponse> =
+        set(params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ChatBackgroundResponse>
+
+    /**
+     * A view of [BackgroundServiceAsync] that provides access to raw HTTP responses for each
+     * method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): BackgroundServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundServiceAsync.retrieve].
+         */
+        fun retrieve(chatId: String): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            retrieve(chatId, BackgroundRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            retrieve(chatId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: BackgroundRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>>
+
+        /** @see retrieve */
+        fun retrieve(
+            params: BackgroundRetrieveParams
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            retrieve(chatId, BackgroundRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundServiceAsync.remove].
+         */
+        fun remove(chatId: String): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            remove(chatId, BackgroundRemoveParams.none())
+
+        /** @see remove */
+        fun remove(
+            chatId: String,
+            params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            remove(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see remove */
+        fun remove(
+            chatId: String,
+            params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            remove(chatId, params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            params: BackgroundRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>>
+
+        /** @see remove */
+        fun remove(
+            params: BackgroundRemoveParams
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            remove(chatId, BackgroundRemoveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `put /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundServiceAsync.set].
+         */
+        fun set(
+            chatId: String,
+            params: BackgroundSetParams,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            set(chatId, params, RequestOptions.none())
+
+        /** @see set */
+        fun set(
+            chatId: String,
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            set(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see set */
+        fun set(
+            params: BackgroundSetParams
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> =
+            set(params, RequestOptions.none())
+
+        /** @see set */
+        fun set(
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
new file mode 100644
index 0000000..95def31
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
@@ -0,0 +1,176 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.multipartFormData
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.chats.background.BackgroundRemoveParams
+import com.blooio.api.models.chats.background.BackgroundRetrieveParams
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import com.blooio.api.models.chats.background.ChatBackgroundResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Set, get, and remove conversation backgrounds */
+class BackgroundServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    BackgroundServiceAsync {
+
+    private val withRawResponse: BackgroundServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): BackgroundServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BackgroundServiceAsync =
+        BackgroundServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: BackgroundRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatBackgroundResponse> =
+        // get /chats/{chatId}/background
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun remove(
+        params: BackgroundRemoveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatBackgroundResponse> =
+        // delete /chats/{chatId}/background
+        withRawResponse().remove(params, requestOptions).thenApply { it.parse() }
+
+    override fun set(
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ChatBackgroundResponse> =
+        // put /chats/{chatId}/background
+        withRawResponse().set(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        BackgroundServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): BackgroundServiceAsync.WithRawResponse =
+            BackgroundServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: BackgroundRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val removeHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: BackgroundRemoveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { removeHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val setHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun set(
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ChatBackgroundResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PUT)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .body(multipartFormData(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { setHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
new file mode 100644
index 0000000..e6af4da
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -0,0 +1,380 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageGetStatusResponse
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageListResponse
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageReactResponse
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageRetrieveResponse
+import com.blooio.api.models.chats.messages.MessageSendParams
+import com.blooio.api.models.chats.messages.MessageSendResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+interface MessageServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageServiceAsync
+
+    /** Get details for a specific message. */
+    fun retrieve(
+        messageId: String,
+        params: MessageRetrieveParams,
+    ): CompletableFuture<MessageRetrieveResponse> =
+        retrieve(messageId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        messageId: String,
+        params: MessageRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageRetrieveResponse> =
+        retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(params: MessageRetrieveParams): CompletableFuture<MessageRetrieveResponse> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: MessageRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageRetrieveResponse>
+
+    /** List all messages in a conversation with optional filtering. */
+    fun list(chatId: String): CompletableFuture<MessageListResponse> =
+        list(chatId, MessageListParams.none())
+
+    /** @see list */
+    fun list(
+        chatId: String,
+        params: MessageListParams = MessageListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageListResponse> =
+        list(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        chatId: String,
+        params: MessageListParams = MessageListParams.none(),
+    ): CompletableFuture<MessageListResponse> = list(chatId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: MessageListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageListResponse>
+
+    /** @see list */
+    fun list(params: MessageListParams): CompletableFuture<MessageListResponse> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MessageListResponse> =
+        list(chatId, MessageListParams.none(), requestOptions)
+
+    /** Get delivery status for a specific message. */
+    fun getStatus(
+        messageId: String,
+        params: MessageGetStatusParams,
+    ): CompletableFuture<MessageGetStatusResponse> =
+        getStatus(messageId, params, RequestOptions.none())
+
+    /** @see getStatus */
+    fun getStatus(
+        messageId: String,
+        params: MessageGetStatusParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageGetStatusResponse> =
+        getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see getStatus */
+    fun getStatus(params: MessageGetStatusParams): CompletableFuture<MessageGetStatusResponse> =
+        getStatus(params, RequestOptions.none())
+
+    /** @see getStatus */
+    fun getStatus(
+        params: MessageGetStatusParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageGetStatusResponse>
+
+    /**
+     * Add or remove a reaction to a message. Supports classic iMessage tapbacks (love, like,
+     * dislike, laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).
+     *
+     * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
+     * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter
+     * by message direction (inbound/outbound only).
+     *
+     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
+     */
+    fun react(
+        messageId: String,
+        params: MessageReactParams,
+    ): CompletableFuture<MessageReactResponse> = react(messageId, params, RequestOptions.none())
+
+    /** @see react */
+    fun react(
+        messageId: String,
+        params: MessageReactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageReactResponse> =
+        react(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see react */
+    fun react(params: MessageReactParams): CompletableFuture<MessageReactResponse> =
+        react(params, RequestOptions.none())
+
+    /** @see react */
+    fun react(
+        params: MessageReactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageReactResponse>
+
+    /**
+     * Send a message to a chat. The chatId can be: (1) E.164 phone number, (2) email address, (3)
+     * group ID (grp_xxxx), or (4) comma-separated list of phone/email for multi-recipient chats.
+     * For multi-recipient, an unnamed group is automatically created or reused if the exact
+     * participant combination already exists. For explicit groups, the group must be linked to an
+     * existing iMessage chat.
+     */
+    fun send(chatId: String): CompletableFuture<MessageSendResponse> =
+        send(chatId, MessageSendParams.none())
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: MessageSendParams = MessageSendParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageSendResponse> =
+        send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: MessageSendParams = MessageSendParams.none(),
+    ): CompletableFuture<MessageSendResponse> = send(chatId, params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        params: MessageSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MessageSendResponse>
+
+    /** @see send */
+    fun send(params: MessageSendParams): CompletableFuture<MessageSendResponse> =
+        send(params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MessageSendResponse> =
+        send(chatId, MessageSendParams.none(), requestOptions)
+
+    /**
+     * A view of [MessageServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): MessageServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages/{messageId}`, but is
+         * otherwise the same as [MessageServiceAsync.retrieve].
+         */
+        fun retrieve(
+            messageId: String,
+            params: MessageRetrieveParams,
+        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
+            retrieve(messageId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            messageId: String,
+            params: MessageRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
+            retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            params: MessageRetrieveParams
+        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: MessageRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageRetrieveResponse>>
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages`, but is otherwise the same
+         * as [MessageServiceAsync.list].
+         */
+        fun list(chatId: String): CompletableFuture<HttpResponseFor<MessageListResponse>> =
+            list(chatId, MessageListParams.none())
+
+        /** @see list */
+        fun list(
+            chatId: String,
+            params: MessageListParams = MessageListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>> =
+            list(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see list */
+        fun list(
+            chatId: String,
+            params: MessageListParams = MessageListParams.none(),
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>> =
+            list(chatId, params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            params: MessageListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>>
+
+        /** @see list */
+        fun list(
+            params: MessageListParams
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>> =
+            list(chatId, MessageListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages/{messageId}/status`, but is
+         * otherwise the same as [MessageServiceAsync.getStatus].
+         */
+        fun getStatus(
+            messageId: String,
+            params: MessageGetStatusParams,
+        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
+            getStatus(messageId, params, RequestOptions.none())
+
+        /** @see getStatus */
+        fun getStatus(
+            messageId: String,
+            params: MessageGetStatusParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
+            getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see getStatus */
+        fun getStatus(
+            params: MessageGetStatusParams
+        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>> =
+            getStatus(params, RequestOptions.none())
+
+        /** @see getStatus */
+        fun getStatus(
+            params: MessageGetStatusParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageGetStatusResponse>>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/messages/{messageId}/reactions`,
+         * but is otherwise the same as [MessageServiceAsync.react].
+         */
+        fun react(
+            messageId: String,
+            params: MessageReactParams,
+        ): CompletableFuture<HttpResponseFor<MessageReactResponse>> =
+            react(messageId, params, RequestOptions.none())
+
+        /** @see react */
+        fun react(
+            messageId: String,
+            params: MessageReactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageReactResponse>> =
+            react(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see react */
+        fun react(
+            params: MessageReactParams
+        ): CompletableFuture<HttpResponseFor<MessageReactResponse>> =
+            react(params, RequestOptions.none())
+
+        /** @see react */
+        fun react(
+            params: MessageReactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageReactResponse>>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/messages`, but is otherwise the
+         * same as [MessageServiceAsync.send].
+         */
+        fun send(chatId: String): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
+            send(chatId, MessageSendParams.none())
+
+        /** @see send */
+        fun send(
+            chatId: String,
+            params: MessageSendParams = MessageSendParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
+            send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see send */
+        fun send(
+            chatId: String,
+            params: MessageSendParams = MessageSendParams.none(),
+        ): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
+            send(chatId, params, RequestOptions.none())
+
+        /** @see send */
+        fun send(
+            params: MessageSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MessageSendResponse>>
+
+        /** @see send */
+        fun send(
+            params: MessageSendParams
+        ): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
+            send(params, RequestOptions.none())
+
+        /** @see send */
+        fun send(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MessageSendResponse>> =
+            send(chatId, MessageSendParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncImpl.kt
similarity index 64%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncImpl.kt
index d225a4c..e292878 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/MessageServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncImpl.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.services.async
+package com.blooio.api.services.async.chats
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
@@ -16,19 +16,20 @@ import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepareAsync
-import com.blooio.api.models.messages.MessageCancelParams
-import com.blooio.api.models.messages.MessageCancelResponse
-import com.blooio.api.models.messages.MessageGetStatusParams
-import com.blooio.api.models.messages.MessageGetStatusResponse
-import com.blooio.api.models.messages.MessageRetrieveParams
-import com.blooio.api.models.messages.MessageRetrieveResponse
-import com.blooio.api.models.messages.MessageSendParams
-import com.blooio.api.models.messages.MessageSendResponse
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageGetStatusResponse
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageListResponse
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageReactResponse
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageRetrieveResponse
+import com.blooio.api.models.chats.messages.MessageSendParams
+import com.blooio.api.models.chats.messages.MessageSendResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Send and manage individual messages */
 class MessageServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     MessageServiceAsync {
 
@@ -45,28 +46,35 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
         params: MessageRetrieveParams,
         requestOptions: RequestOptions,
     ): CompletableFuture<MessageRetrieveResponse> =
-        // get /v1/api/messages/{messageId}
+        // get /chats/{chatId}/messages/{messageId}
         withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
 
-    override fun cancel(
-        params: MessageCancelParams,
+    override fun list(
+        params: MessageListParams,
         requestOptions: RequestOptions,
-    ): CompletableFuture<MessageCancelResponse> =
-        // delete /v1/api/messages/{messageId}
-        withRawResponse().cancel(params, requestOptions).thenApply { it.parse() }
+    ): CompletableFuture<MessageListResponse> =
+        // get /chats/{chatId}/messages
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
 
     override fun getStatus(
         params: MessageGetStatusParams,
         requestOptions: RequestOptions,
     ): CompletableFuture<MessageGetStatusResponse> =
-        // get /v1/api/messages/{messageId}/status
+        // get /chats/{chatId}/messages/{messageId}/status
         withRawResponse().getStatus(params, requestOptions).thenApply { it.parse() }
 
+    override fun react(
+        params: MessageReactParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MessageReactResponse> =
+        // post /chats/{chatId}/messages/{messageId}/reactions
+        withRawResponse().react(params, requestOptions).thenApply { it.parse() }
+
     override fun send(
         params: MessageSendParams,
         requestOptions: RequestOptions,
     ): CompletableFuture<MessageSendResponse> =
-        // post /v1/api/messages
+        // post /chats/{chatId}/messages
         withRawResponse().send(params, requestOptions).thenApply { it.parse() }
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -96,7 +104,12 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0))
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                    )
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -115,22 +128,21 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 }
         }
 
-        private val cancelHandler: Handler<MessageCancelResponse> =
-            jsonHandler<MessageCancelResponse>(clientOptions.jsonMapper)
+        private val listHandler: Handler<MessageListResponse> =
+            jsonHandler<MessageListResponse>(clientOptions.jsonMapper)
 
-        override fun cancel(
-            params: MessageCancelParams,
+        override fun list(
+            params: MessageListParams,
             requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<MessageCancelResponse>> {
+        ): CompletableFuture<HttpResponseFor<MessageListResponse>> {
             // We check here instead of in the params builder because this can be specified
             // positionally or in the params class.
-            checkRequired("messageId", params.messageId().getOrNull())
+            checkRequired("chatId", params.chatId().getOrNull())
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.DELETE)
+                    .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0))
-                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .addPathSegments("chats", params._pathParam(0), "messages")
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -139,7 +151,7 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 .thenApply { response ->
                     errorHandler.handle(response).parseable {
                         response
-                            .use { cancelHandler.handle(it) }
+                            .use { listHandler.handle(it) }
                             .also {
                                 if (requestOptions.responseValidation!!) {
                                     it.validate()
@@ -163,7 +175,13 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0), "status")
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                        "status",
+                    )
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -182,6 +200,46 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 }
         }
 
+        private val reactHandler: Handler<MessageReactResponse> =
+            jsonHandler<MessageReactResponse>(clientOptions.jsonMapper)
+
+        override fun react(
+            params: MessageReactParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MessageReactResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("messageId", params.messageId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                        "reactions",
+                    )
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { reactHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
         private val sendHandler: Handler<MessageSendResponse> =
             jsonHandler<MessageSendResponse>(clientOptions.jsonMapper)
 
@@ -189,11 +247,14 @@ class MessageServiceAsyncImpl internal constructor(private val clientOptions: Cl
             params: MessageSendParams,
             requestOptions: RequestOptions,
         ): CompletableFuture<HttpResponseFor<MessageSendResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
             val request =
                 HttpRequest.builder()
                     .method(HttpMethod.POST)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages")
+                    .addPathSegments("chats", params._pathParam(0), "messages")
                     .body(json(clientOptions.jsonMapper, params._body()))
                     .build()
                     .prepareAsync(clientOptions, params)
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsync.kt
new file mode 100644
index 0000000..351649f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsync.kt
@@ -0,0 +1,154 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollGetResultsResponse
+import com.blooio.api.models.chats.polls.PollSendParams
+import com.blooio.api.models.chats.polls.PollSendResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/**
+ * Send native iMessage polls and retrieve poll results with vote counts. Poll events are delivered
+ * via separate webhook event types (poll.received, poll.created, poll.voted) and require
+ * webhook_type 'poll' or 'all'.
+ */
+interface PollServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollServiceAsync
+
+    /**
+     * Retrieve a poll's definition and aggregated vote counts. The pollId is the poll_id returned
+     * in the poll.received or poll.created webhook event.
+     */
+    fun getResults(
+        pollId: String,
+        params: PollGetResultsParams,
+    ): CompletableFuture<PollGetResultsResponse> = getResults(pollId, params, RequestOptions.none())
+
+    /** @see getResults */
+    fun getResults(
+        pollId: String,
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PollGetResultsResponse> =
+        getResults(params.toBuilder().pollId(pollId).build(), requestOptions)
+
+    /** @see getResults */
+    fun getResults(params: PollGetResultsParams): CompletableFuture<PollGetResultsResponse> =
+        getResults(params, RequestOptions.none())
+
+    /** @see getResults */
+    fun getResults(
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PollGetResultsResponse>
+
+    /**
+     * Send a native iMessage poll to a chat. The poll appears as an interactive ballot that
+     * recipients can vote on.
+     */
+    fun send(chatId: String, params: PollSendParams): CompletableFuture<PollSendResponse> =
+        send(chatId, params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: PollSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PollSendResponse> =
+        send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see send */
+    fun send(params: PollSendParams): CompletableFuture<PollSendResponse> =
+        send(params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        params: PollSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PollSendResponse>
+
+    /** A view of [PollServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/polls/{pollId}`, but is otherwise
+         * the same as [PollServiceAsync.getResults].
+         */
+        fun getResults(
+            pollId: String,
+            params: PollGetResultsParams,
+        ): CompletableFuture<HttpResponseFor<PollGetResultsResponse>> =
+            getResults(pollId, params, RequestOptions.none())
+
+        /** @see getResults */
+        fun getResults(
+            pollId: String,
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PollGetResultsResponse>> =
+            getResults(params.toBuilder().pollId(pollId).build(), requestOptions)
+
+        /** @see getResults */
+        fun getResults(
+            params: PollGetResultsParams
+        ): CompletableFuture<HttpResponseFor<PollGetResultsResponse>> =
+            getResults(params, RequestOptions.none())
+
+        /** @see getResults */
+        fun getResults(
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PollGetResultsResponse>>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/polls`, but is otherwise the same
+         * as [PollServiceAsync.send].
+         */
+        fun send(
+            chatId: String,
+            params: PollSendParams,
+        ): CompletableFuture<HttpResponseFor<PollSendResponse>> =
+            send(chatId, params, RequestOptions.none())
+
+        /** @see send */
+        fun send(
+            chatId: String,
+            params: PollSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PollSendResponse>> =
+            send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see send */
+        fun send(params: PollSendParams): CompletableFuture<HttpResponseFor<PollSendResponse>> =
+            send(params, RequestOptions.none())
+
+        /** @see send */
+        fun send(
+            params: PollSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PollSendResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncImpl.kt
new file mode 100644
index 0000000..38a3e27
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncImpl.kt
@@ -0,0 +1,138 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollGetResultsResponse
+import com.blooio.api.models.chats.polls.PollSendParams
+import com.blooio.api.models.chats.polls.PollSendResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Send native iMessage polls and retrieve poll results with vote counts. Poll events are delivered
+ * via separate webhook event types (poll.received, poll.created, poll.voted) and require
+ * webhook_type 'poll' or 'all'.
+ */
+class PollServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    PollServiceAsync {
+
+    private val withRawResponse: PollServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): PollServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollServiceAsync =
+        PollServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun getResults(
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<PollGetResultsResponse> =
+        // get /chats/{chatId}/polls/{pollId}
+        withRawResponse().getResults(params, requestOptions).thenApply { it.parse() }
+
+    override fun send(
+        params: PollSendParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<PollSendResponse> =
+        // post /chats/{chatId}/polls
+        withRawResponse().send(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        PollServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PollServiceAsync.WithRawResponse =
+            PollServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val getResultsHandler: Handler<PollGetResultsResponse> =
+            jsonHandler<PollGetResultsResponse>(clientOptions.jsonMapper)
+
+        override fun getResults(
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<PollGetResultsResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("pollId", params.pollId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "polls", params._pathParam(1))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { getResultsHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val sendHandler: Handler<PollSendResponse> =
+            jsonHandler<PollSendResponse>(clientOptions.jsonMapper)
+
+        override fun send(
+            params: PollSendParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<PollSendResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "polls")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { sendHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
new file mode 100644
index 0000000..803a49f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
@@ -0,0 +1,187 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.typing.TypingResponse
+import com.blooio.api.models.chats.typing.TypingStartParams
+import com.blooio.api.models.chats.typing.TypingStopParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Control typing indicators for conversations */
+interface TypingServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): TypingServiceAsync
+
+    /**
+     * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     */
+    fun start(chatId: String): CompletableFuture<TypingResponse> =
+        start(chatId, TypingStartParams.none())
+
+    /** @see start */
+    fun start(
+        chatId: String,
+        params: TypingStartParams = TypingStartParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TypingResponse> =
+        start(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see start */
+    fun start(
+        chatId: String,
+        params: TypingStartParams = TypingStartParams.none(),
+    ): CompletableFuture<TypingResponse> = start(chatId, params, RequestOptions.none())
+
+    /** @see start */
+    fun start(
+        params: TypingStartParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TypingResponse>
+
+    /** @see start */
+    fun start(params: TypingStartParams): CompletableFuture<TypingResponse> =
+        start(params, RequestOptions.none())
+
+    /** @see start */
+    fun start(chatId: String, requestOptions: RequestOptions): CompletableFuture<TypingResponse> =
+        start(chatId, TypingStartParams.none(), requestOptions)
+
+    /** Stop the typing indicator for a chat. */
+    fun stop(chatId: String): CompletableFuture<TypingResponse> =
+        stop(chatId, TypingStopParams.none())
+
+    /** @see stop */
+    fun stop(
+        chatId: String,
+        params: TypingStopParams = TypingStopParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TypingResponse> =
+        stop(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see stop */
+    fun stop(
+        chatId: String,
+        params: TypingStopParams = TypingStopParams.none(),
+    ): CompletableFuture<TypingResponse> = stop(chatId, params, RequestOptions.none())
+
+    /** @see stop */
+    fun stop(
+        params: TypingStopParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TypingResponse>
+
+    /** @see stop */
+    fun stop(params: TypingStopParams): CompletableFuture<TypingResponse> =
+        stop(params, RequestOptions.none())
+
+    /** @see stop */
+    fun stop(chatId: String, requestOptions: RequestOptions): CompletableFuture<TypingResponse> =
+        stop(chatId, TypingStopParams.none(), requestOptions)
+
+    /**
+     * A view of [TypingServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): TypingServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/typing`, but is otherwise the same
+         * as [TypingServiceAsync.start].
+         */
+        fun start(chatId: String): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            start(chatId, TypingStartParams.none())
+
+        /** @see start */
+        fun start(
+            chatId: String,
+            params: TypingStartParams = TypingStartParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            start(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see start */
+        fun start(
+            chatId: String,
+            params: TypingStartParams = TypingStartParams.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            start(chatId, params, RequestOptions.none())
+
+        /** @see start */
+        fun start(
+            params: TypingStartParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>>
+
+        /** @see start */
+        fun start(params: TypingStartParams): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            start(params, RequestOptions.none())
+
+        /** @see start */
+        fun start(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            start(chatId, TypingStartParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /chats/{chatId}/typing`, but is otherwise the
+         * same as [TypingServiceAsync.stop].
+         */
+        fun stop(chatId: String): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            stop(chatId, TypingStopParams.none())
+
+        /** @see stop */
+        fun stop(
+            chatId: String,
+            params: TypingStopParams = TypingStopParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            stop(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see stop */
+        fun stop(
+            chatId: String,
+            params: TypingStopParams = TypingStopParams.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            stop(chatId, params, RequestOptions.none())
+
+        /** @see stop */
+        fun stop(
+            params: TypingStopParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TypingResponse>>
+
+        /** @see stop */
+        fun stop(params: TypingStopParams): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            stop(params, RequestOptions.none())
+
+        /** @see stop */
+        fun stop(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> =
+            stop(chatId, TypingStopParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncImpl.kt
new file mode 100644
index 0000000..0980f52
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncImpl.kt
@@ -0,0 +1,134 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.chats.typing.TypingResponse
+import com.blooio.api.models.chats.typing.TypingStartParams
+import com.blooio.api.models.chats.typing.TypingStopParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Control typing indicators for conversations */
+class TypingServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    TypingServiceAsync {
+
+    private val withRawResponse: TypingServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): TypingServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): TypingServiceAsync =
+        TypingServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun start(
+        params: TypingStartParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<TypingResponse> =
+        // post /chats/{chatId}/typing
+        withRawResponse().start(params, requestOptions).thenApply { it.parse() }
+
+    override fun stop(
+        params: TypingStopParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<TypingResponse> =
+        // delete /chats/{chatId}/typing
+        withRawResponse().stop(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        TypingServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): TypingServiceAsync.WithRawResponse =
+            TypingServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val startHandler: Handler<TypingResponse> =
+            jsonHandler<TypingResponse>(clientOptions.jsonMapper)
+
+        override fun start(
+            params: TypingStartParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "typing")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { startHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val stopHandler: Handler<TypingResponse> =
+            jsonHandler<TypingResponse>(clientOptions.jsonMapper)
+
+        override fun stop(
+            params: TypingStopParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TypingResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "typing")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { stopHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
deleted file mode 100644
index f5e0597..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsync.kt
+++ /dev/null
@@ -1,124 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async.config
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponseFor
-import com.blooio.api.models.config.webhook.WebhookRetrieveParams
-import com.blooio.api.models.config.webhook.WebhookRetrieveResponse
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import com.blooio.api.models.config.webhook.WebhookUpdateResponse
-import java.util.concurrent.CompletableFuture
-import java.util.function.Consumer
-
-/** Account-level configuration */
-interface WebhookServiceAsync {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookServiceAsync
-
-    /** Get the current webhook URL */
-    fun retrieve(): CompletableFuture<WebhookRetrieveResponse> =
-        retrieve(WebhookRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<WebhookRetrieveResponse>
-
-    /** @see retrieve */
-    fun retrieve(
-        params: WebhookRetrieveParams = WebhookRetrieveParams.none()
-    ): CompletableFuture<WebhookRetrieveResponse> = retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(requestOptions: RequestOptions): CompletableFuture<WebhookRetrieveResponse> =
-        retrieve(WebhookRetrieveParams.none(), requestOptions)
-
-    /**
-     * Configure the webhook URL that will receive all message events. Once configured, your
-     * endpoint will receive POST requests with the following event types:
-     * - `message.received` - When you receive an inbound message
-     * - `message.sent` - When your outbound message is sent to the carrier
-     * - `message.delivered` - When your outbound message is delivered to the recipient
-     * - `message.failed` - When your outbound message fails to deliver
-     * - `message.read` - When your outbound message is read by the recipient (iMessage only,
-     *   recipient must have read receipts enabled)
-     *
-     * See the webhook event schemas for detailed payload formats.
-     */
-    fun update(params: WebhookUpdateParams): CompletableFuture<WebhookUpdateResponse> =
-        update(params, RequestOptions.none())
-
-    /** @see update */
-    fun update(
-        params: WebhookUpdateParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): CompletableFuture<WebhookUpdateResponse>
-
-    /**
-     * A view of [WebhookServiceAsync] that provides access to raw HTTP responses for each method.
-     */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): WebhookServiceAsync.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/config/webhook`, but is otherwise the same
-         * as [WebhookServiceAsync.retrieve].
-         */
-        fun retrieve(): CompletableFuture<HttpResponseFor<WebhookRetrieveResponse>> =
-            retrieve(WebhookRetrieveParams.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<WebhookRetrieveResponse>>
-
-        /** @see retrieve */
-        fun retrieve(
-            params: WebhookRetrieveParams = WebhookRetrieveParams.none()
-        ): CompletableFuture<HttpResponseFor<WebhookRetrieveResponse>> =
-            retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        fun retrieve(
-            requestOptions: RequestOptions
-        ): CompletableFuture<HttpResponseFor<WebhookRetrieveResponse>> =
-            retrieve(WebhookRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `put /v1/api/config/webhook`, but is otherwise the same
-         * as [WebhookServiceAsync.update].
-         */
-        fun update(
-            params: WebhookUpdateParams
-        ): CompletableFuture<HttpResponseFor<WebhookUpdateResponse>> =
-            update(params, RequestOptions.none())
-
-        /** @see update */
-        fun update(
-            params: WebhookUpdateParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): CompletableFuture<HttpResponseFor<WebhookUpdateResponse>>
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsync.kt
new file mode 100644
index 0000000..daebec4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsync.kt
@@ -0,0 +1,218 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.contacts
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagAddResponse
+import com.blooio.api.models.contacts.tags.TagListParams
+import com.blooio.api.models.contacts.tags.TagListResponse
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage contacts (phone numbers and emails) */
+interface TagServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagServiceAsync
+
+    /** List all tags assigned to a contact. */
+    fun list(contactId: String): CompletableFuture<TagListResponse> =
+        list(contactId, TagListParams.none())
+
+    /** @see list */
+    fun list(
+        contactId: String,
+        params: TagListParams = TagListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TagListResponse> =
+        list(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        contactId: String,
+        params: TagListParams = TagListParams.none(),
+    ): CompletableFuture<TagListResponse> = list(contactId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: TagListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TagListResponse>
+
+    /** @see list */
+    fun list(params: TagListParams): CompletableFuture<TagListResponse> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        contactId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<TagListResponse> = list(contactId, TagListParams.none(), requestOptions)
+
+    /**
+     * Add one or more tags to a contact. If a tag already exists on the contact, it is re-activated
+     * (idempotent). Tags are free-form strings.
+     */
+    fun add(contactId: String, params: TagAddParams): CompletableFuture<TagAddResponse> =
+        add(contactId, params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        contactId: String,
+        params: TagAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TagAddResponse> =
+        add(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see add */
+    fun add(params: TagAddParams): CompletableFuture<TagAddResponse> =
+        add(params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        params: TagAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<TagAddResponse>
+
+    /** Remove a specific tag from a contact. The tag is soft-deleted and can be re-added later. */
+    fun remove(tag: String, params: TagRemoveParams): CompletableFuture<DeleteResponse> =
+        remove(tag, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        tag: String,
+        params: TagRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<DeleteResponse> =
+        remove(params.toBuilder().tag(tag).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(params: TagRemoveParams): CompletableFuture<DeleteResponse> =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: TagRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<DeleteResponse>
+
+    /** A view of [TagServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /contacts/{contactId}/tags`, but is otherwise the
+         * same as [TagServiceAsync.list].
+         */
+        fun list(contactId: String): CompletableFuture<HttpResponseFor<TagListResponse>> =
+            list(contactId, TagListParams.none())
+
+        /** @see list */
+        fun list(
+            contactId: String,
+            params: TagListParams = TagListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TagListResponse>> =
+            list(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see list */
+        fun list(
+            contactId: String,
+            params: TagListParams = TagListParams.none(),
+        ): CompletableFuture<HttpResponseFor<TagListResponse>> =
+            list(contactId, params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            params: TagListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TagListResponse>>
+
+        /** @see list */
+        fun list(params: TagListParams): CompletableFuture<HttpResponseFor<TagListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TagListResponse>> =
+            list(contactId, TagListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /contacts/{contactId}/tags`, but is otherwise the
+         * same as [TagServiceAsync.add].
+         */
+        fun add(
+            contactId: String,
+            params: TagAddParams,
+        ): CompletableFuture<HttpResponseFor<TagAddResponse>> =
+            add(contactId, params, RequestOptions.none())
+
+        /** @see add */
+        fun add(
+            contactId: String,
+            params: TagAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TagAddResponse>> =
+            add(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see add */
+        fun add(params: TagAddParams): CompletableFuture<HttpResponseFor<TagAddResponse>> =
+            add(params, RequestOptions.none())
+
+        /** @see add */
+        fun add(
+            params: TagAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<TagAddResponse>>
+
+        /**
+         * Returns a raw HTTP response for `delete /contacts/{contactId}/tags/{tag}`, but is
+         * otherwise the same as [TagServiceAsync.remove].
+         */
+        fun remove(
+            tag: String,
+            params: TagRemoveParams,
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            remove(tag, params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            tag: String,
+            params: TagRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            remove(params.toBuilder().tag(tag).build(), requestOptions)
+
+        /** @see remove */
+        fun remove(params: TagRemoveParams): CompletableFuture<HttpResponseFor<DeleteResponse>> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            params: TagRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncImpl.kt
new file mode 100644
index 0000000..8543be6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncImpl.kt
@@ -0,0 +1,177 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.contacts
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagAddResponse
+import com.blooio.api.models.contacts.tags.TagListParams
+import com.blooio.api.models.contacts.tags.TagListResponse
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contacts (phone numbers and emails) */
+class TagServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    TagServiceAsync {
+
+    private val withRawResponse: TagServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): TagServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagServiceAsync =
+        TagServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: TagListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<TagListResponse> =
+        // get /contacts/{contactId}/tags
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun add(
+        params: TagAddParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<TagAddResponse> =
+        // post /contacts/{contactId}/tags
+        withRawResponse().add(params, requestOptions).thenApply { it.parse() }
+
+    override fun remove(
+        params: TagRemoveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<DeleteResponse> =
+        // delete /contacts/{contactId}/tags/{tag}
+        withRawResponse().remove(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        TagServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): TagServiceAsync.WithRawResponse =
+            TagServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<TagListResponse> =
+            jsonHandler<TagListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: TagListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TagListResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val addHandler: Handler<TagAddResponse> =
+            jsonHandler<TagAddResponse>(clientOptions.jsonMapper)
+
+        override fun add(
+            params: TagAddParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<TagAddResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { addHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val removeHandler: Handler<DeleteResponse> =
+            jsonHandler<DeleteResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: TagRemoveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<DeleteResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("tag", params.tag().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags", params._pathParam(1))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { removeHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsync.kt
new file mode 100644
index 0000000..bdb1c03
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsync.kt
@@ -0,0 +1,171 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.icon.GroupIcon
+import com.blooio.api.models.groups.icon.IconRemoveParams
+import com.blooio.api.models.groups.icon.IconSetParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage contact groups */
+interface IconServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconServiceAsync
+
+    /**
+     * Remove the group icon/photo. Requires the group to have a linked chat_guid.
+     *
+     * The icon is removed from both Blooio storage and the linked iMessage chat before the request
+     * returns.
+     */
+    fun remove(groupId: String): CompletableFuture<GroupIcon> =
+        remove(groupId, IconRemoveParams.none())
+
+    /** @see remove */
+    fun remove(
+        groupId: String,
+        params: IconRemoveParams = IconRemoveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupIcon> =
+        remove(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(
+        groupId: String,
+        params: IconRemoveParams = IconRemoveParams.none(),
+    ): CompletableFuture<GroupIcon> = remove(groupId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: IconRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupIcon>
+
+    /** @see remove */
+    fun remove(params: IconRemoveParams): CompletableFuture<GroupIcon> =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(groupId: String, requestOptions: RequestOptions): CompletableFuture<GroupIcon> =
+        remove(groupId, IconRemoveParams.none(), requestOptions)
+
+    /**
+     * Set the group icon/photo. Requires the group to have a linked chat_guid. Uses
+     * multipart/form-data.
+     *
+     * The uploaded image is stored in Blooio storage and synced to the linked iMessage chat before
+     * the request returns.
+     */
+    fun set(groupId: String, params: IconSetParams): CompletableFuture<GroupIcon> =
+        set(groupId, params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        groupId: String,
+        params: IconSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupIcon> =
+        set(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see set */
+    fun set(params: IconSetParams): CompletableFuture<GroupIcon> =
+        set(params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        params: IconSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<GroupIcon>
+
+    /** A view of [IconServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}/icon`, but is otherwise the
+         * same as [IconServiceAsync.remove].
+         */
+        fun remove(groupId: String): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            remove(groupId, IconRemoveParams.none())
+
+        /** @see remove */
+        fun remove(
+            groupId: String,
+            params: IconRemoveParams = IconRemoveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            remove(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see remove */
+        fun remove(
+            groupId: String,
+            params: IconRemoveParams = IconRemoveParams.none(),
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            remove(groupId, params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            params: IconRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupIcon>>
+
+        /** @see remove */
+        fun remove(params: IconRemoveParams): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            remove(groupId, IconRemoveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /groups/{groupId}/icon`, but is otherwise the same
+         * as [IconServiceAsync.set].
+         */
+        fun set(
+            groupId: String,
+            params: IconSetParams,
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            set(groupId, params, RequestOptions.none())
+
+        /** @see set */
+        fun set(
+            groupId: String,
+            params: IconSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            set(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see set */
+        fun set(params: IconSetParams): CompletableFuture<HttpResponseFor<GroupIcon>> =
+            set(params, RequestOptions.none())
+
+        /** @see set */
+        fun set(
+            params: IconSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<GroupIcon>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncImpl.kt
new file mode 100644
index 0000000..e934960
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncImpl.kt
@@ -0,0 +1,135 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.multipartFormData
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.groups.icon.GroupIcon
+import com.blooio.api.models.groups.icon.IconRemoveParams
+import com.blooio.api.models.groups.icon.IconSetParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contact groups */
+class IconServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    IconServiceAsync {
+
+    private val withRawResponse: IconServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): IconServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconServiceAsync =
+        IconServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun remove(
+        params: IconRemoveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupIcon> =
+        // delete /groups/{groupId}/icon
+        withRawResponse().remove(params, requestOptions).thenApply { it.parse() }
+
+    override fun set(
+        params: IconSetParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<GroupIcon> =
+        // post /groups/{groupId}/icon
+        withRawResponse().set(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        IconServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): IconServiceAsync.WithRawResponse =
+            IconServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val removeHandler: Handler<GroupIcon> =
+            jsonHandler<GroupIcon>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: IconRemoveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "icon")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { removeHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val setHandler: Handler<GroupIcon> =
+            jsonHandler<GroupIcon>(clientOptions.jsonMapper)
+
+        override fun set(
+            params: IconSetParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<GroupIcon>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "icon")
+                    .body(multipartFormData(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { setHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsync.kt
new file mode 100644
index 0000000..91a9d88
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsync.kt
@@ -0,0 +1,235 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberAddResponse
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberListResponse
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import com.blooio.api.models.groups.members.MemberRemoveResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage group membership */
+interface MemberServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MemberServiceAsync
+
+    /** List all members of a group. */
+    fun list(groupId: String): CompletableFuture<MemberListResponse> =
+        list(groupId, MemberListParams.none())
+
+    /** @see list */
+    fun list(
+        groupId: String,
+        params: MemberListParams = MemberListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberListResponse> =
+        list(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        groupId: String,
+        params: MemberListParams = MemberListParams.none(),
+    ): CompletableFuture<MemberListResponse> = list(groupId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: MemberListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberListResponse>
+
+    /** @see list */
+    fun list(params: MemberListParams): CompletableFuture<MemberListResponse> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        groupId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MemberListResponse> =
+        list(groupId, MemberListParams.none(), requestOptions)
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Add an existing contact to a group. If the group is linked to an existing iMessage chat, also
+     * adds the participant to that chat.
+     */
+    fun add(groupId: String, params: MemberAddParams): CompletableFuture<MemberAddResponse> =
+        add(groupId, params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        groupId: String,
+        params: MemberAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberAddResponse> =
+        add(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see add */
+    fun add(params: MemberAddParams): CompletableFuture<MemberAddResponse> =
+        add(params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        params: MemberAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberAddResponse>
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Remove a contact from a group. If the group is linked to an existing iMessage chat, also
+     * removes the participant from that chat. If the contact being removed is the organization's
+     * own phone number, leaves the group chat instead.
+     */
+    fun remove(
+        contactId: String,
+        params: MemberRemoveParams,
+    ): CompletableFuture<MemberRemoveResponse> = remove(contactId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        contactId: String,
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberRemoveResponse> =
+        remove(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(params: MemberRemoveParams): CompletableFuture<MemberRemoveResponse> =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<MemberRemoveResponse>
+
+    /**
+     * A view of [MemberServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): MemberServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /groups/{groupId}/members`, but is otherwise the
+         * same as [MemberServiceAsync.list].
+         */
+        fun list(groupId: String): CompletableFuture<HttpResponseFor<MemberListResponse>> =
+            list(groupId, MemberListParams.none())
+
+        /** @see list */
+        fun list(
+            groupId: String,
+            params: MemberListParams = MemberListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberListResponse>> =
+            list(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see list */
+        fun list(
+            groupId: String,
+            params: MemberListParams = MemberListParams.none(),
+        ): CompletableFuture<HttpResponseFor<MemberListResponse>> =
+            list(groupId, params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            params: MemberListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberListResponse>>
+
+        /** @see list */
+        fun list(params: MemberListParams): CompletableFuture<HttpResponseFor<MemberListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MemberListResponse>> =
+            list(groupId, MemberListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /groups/{groupId}/members`, but is otherwise the
+         * same as [MemberServiceAsync.add].
+         */
+        fun add(
+            groupId: String,
+            params: MemberAddParams,
+        ): CompletableFuture<HttpResponseFor<MemberAddResponse>> =
+            add(groupId, params, RequestOptions.none())
+
+        /** @see add */
+        fun add(
+            groupId: String,
+            params: MemberAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberAddResponse>> =
+            add(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see add */
+        fun add(params: MemberAddParams): CompletableFuture<HttpResponseFor<MemberAddResponse>> =
+            add(params, RequestOptions.none())
+
+        /** @see add */
+        fun add(
+            params: MemberAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberAddResponse>>
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}/members/{contactId}`, but is
+         * otherwise the same as [MemberServiceAsync.remove].
+         */
+        fun remove(
+            contactId: String,
+            params: MemberRemoveParams,
+        ): CompletableFuture<HttpResponseFor<MemberRemoveResponse>> =
+            remove(contactId, params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            contactId: String,
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberRemoveResponse>> =
+            remove(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see remove */
+        fun remove(
+            params: MemberRemoveParams
+        ): CompletableFuture<HttpResponseFor<MemberRemoveResponse>> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        fun remove(
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<MemberRemoveResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncImpl.kt
new file mode 100644
index 0000000..9ae8e99
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncImpl.kt
@@ -0,0 +1,182 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberAddResponse
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberListResponse
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import com.blooio.api.models.groups.members.MemberRemoveResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage group membership */
+class MemberServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    MemberServiceAsync {
+
+    private val withRawResponse: MemberServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): MemberServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): MemberServiceAsync =
+        MemberServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: MemberListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MemberListResponse> =
+        // get /groups/{groupId}/members
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun add(
+        params: MemberAddParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MemberAddResponse> =
+        // post /groups/{groupId}/members
+        withRawResponse().add(params, requestOptions).thenApply { it.parse() }
+
+    override fun remove(
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<MemberRemoveResponse> =
+        // delete /groups/{groupId}/members/{contactId}
+        withRawResponse().remove(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        MemberServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): MemberServiceAsync.WithRawResponse =
+            MemberServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<MemberListResponse> =
+            jsonHandler<MemberListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: MemberListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MemberListResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "members")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val addHandler: Handler<MemberAddResponse> =
+            jsonHandler<MemberAddResponse>(clientOptions.jsonMapper)
+
+        override fun add(
+            params: MemberAddParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MemberAddResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "members")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { addHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val removeHandler: Handler<MemberRemoveResponse> =
+            jsonHandler<MemberRemoveResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<MemberRemoveResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "groups",
+                        params._pathParam(0),
+                        "members",
+                        params._pathParam(1),
+                    )
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { removeHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsync.kt
new file mode 100644
index 0000000..c1290d4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsync.kt
@@ -0,0 +1,214 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.location
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.location.contacts.ContactListParams
+import com.blooio.api.models.location.contacts.ContactListResponse
+import com.blooio.api.models.location.contacts.ContactLocation
+import com.blooio.api.models.location.contacts.ContactRefreshParams
+import com.blooio.api.models.location.contacts.ContactRefreshResponse
+import com.blooio.api.models.location.contacts.ContactRetrieveParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** FindMy contact location tracking */
+interface ContactServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactServiceAsync
+
+    /** Returns the cached location for a specific contact identified by phone number or email. */
+    fun retrieve(handle: String): CompletableFuture<ContactLocation> =
+        retrieve(handle, ContactRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        handle: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactLocation> =
+        retrieve(params.toBuilder().handle(handle).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        handle: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+    ): CompletableFuture<ContactLocation> = retrieve(handle, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactLocation>
+
+    /** @see retrieve */
+    fun retrieve(params: ContactRetrieveParams): CompletableFuture<ContactLocation> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        handle: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactLocation> =
+        retrieve(handle, ContactRetrieveParams.none(), requestOptions)
+
+    /**
+     * Returns cached FindMy contact locations available through your blooio account. Each entry
+     * includes the contact's handle (phone/email), coordinates, and last update time.
+     */
+    fun list(): CompletableFuture<ContactListResponse> = list(ContactListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactListResponse>
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none()
+    ): CompletableFuture<ContactListResponse> = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<ContactListResponse> =
+        list(ContactListParams.none(), requestOptions)
+
+    /**
+     * Triggers a refresh of cached FindMy contact locations. Updated results may take 15-20 seconds
+     * to appear.
+     */
+    fun refresh(): CompletableFuture<ContactRefreshResponse> = refresh(ContactRefreshParams.none())
+
+    /** @see refresh */
+    fun refresh(
+        params: ContactRefreshParams = ContactRefreshParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactRefreshResponse>
+
+    /** @see refresh */
+    fun refresh(
+        params: ContactRefreshParams = ContactRefreshParams.none()
+    ): CompletableFuture<ContactRefreshResponse> = refresh(params, RequestOptions.none())
+
+    /** @see refresh */
+    fun refresh(requestOptions: RequestOptions): CompletableFuture<ContactRefreshResponse> =
+        refresh(ContactRefreshParams.none(), requestOptions)
+
+    /**
+     * A view of [ContactServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /location/contacts/{handle}`, but is otherwise the
+         * same as [ContactServiceAsync.retrieve].
+         */
+        fun retrieve(handle: String): CompletableFuture<HttpResponseFor<ContactLocation>> =
+            retrieve(handle, ContactRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            handle: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactLocation>> =
+            retrieve(params.toBuilder().handle(handle).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            handle: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<ContactLocation>> =
+            retrieve(handle, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactLocation>>
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ContactRetrieveParams
+        ): CompletableFuture<HttpResponseFor<ContactLocation>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            handle: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactLocation>> =
+            retrieve(handle, ContactRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /location/contacts`, but is otherwise the same as
+         * [ContactServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(ContactListParams.none())
+
+        /** @see list */
+        fun list(
+            params: ContactListParams = ContactListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>>
+
+        /** @see list */
+        fun list(
+            params: ContactListParams = ContactListParams.none()
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> =
+            list(ContactListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /location/contacts/refresh`, but is otherwise the
+         * same as [ContactServiceAsync.refresh].
+         */
+        fun refresh(): CompletableFuture<HttpResponseFor<ContactRefreshResponse>> =
+            refresh(ContactRefreshParams.none())
+
+        /** @see refresh */
+        fun refresh(
+            params: ContactRefreshParams = ContactRefreshParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactRefreshResponse>>
+
+        /** @see refresh */
+        fun refresh(
+            params: ContactRefreshParams = ContactRefreshParams.none()
+        ): CompletableFuture<HttpResponseFor<ContactRefreshResponse>> =
+            refresh(params, RequestOptions.none())
+
+        /** @see refresh */
+        fun refresh(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<ContactRefreshResponse>> =
+            refresh(ContactRefreshParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncImpl.kt
new file mode 100644
index 0000000..da986fe
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncImpl.kt
@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.location
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.location.contacts.ContactListParams
+import com.blooio.api.models.location.contacts.ContactListResponse
+import com.blooio.api.models.location.contacts.ContactLocation
+import com.blooio.api.models.location.contacts.ContactRefreshParams
+import com.blooio.api.models.location.contacts.ContactRefreshResponse
+import com.blooio.api.models.location.contacts.ContactRetrieveParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** FindMy contact location tracking */
+class ContactServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    ContactServiceAsync {
+
+    private val withRawResponse: ContactServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ContactServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactServiceAsync =
+        ContactServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactLocation> =
+        // get /location/contacts/{handle}
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun list(
+        params: ContactListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactListResponse> =
+        // get /location/contacts
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun refresh(
+        params: ContactRefreshParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactRefreshResponse> =
+        // post /location/contacts/refresh
+        withRawResponse().refresh(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ContactServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactServiceAsync.WithRawResponse =
+            ContactServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ContactLocation> =
+            jsonHandler<ContactLocation>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactLocation>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("handle", params.handle().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts", params._pathParam(0))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val listHandler: Handler<ContactListResponse> =
+            jsonHandler<ContactListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ContactListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val refreshHandler: Handler<ContactRefreshResponse> =
+            jsonHandler<ContactRefreshResponse>(clientOptions.jsonMapper)
+
+        override fun refresh(
+            params: ContactRefreshParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactRefreshResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts", "refresh")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { refreshHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsync.kt
new file mode 100644
index 0000000..430d815
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsync.kt
@@ -0,0 +1,95 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.me.numbers.NumberListParams
+import com.blooio.api.models.me.numbers.NumberListResponse
+import com.blooio.api.services.async.me.numbers.ContactCardServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage phone numbers linked to your account */
+interface NumberServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): NumberServiceAsync
+
+    /** Manage and share your iMessage contact card (Name & Photo) */
+    fun contactCard(): ContactCardServiceAsync
+
+    /**
+     * List all phone numbers bound to this API key with their availability status. Use the returned
+     * phone numbers as the `:number` path parameter for other `/me/numbers/` endpoints.
+     */
+    fun list(): CompletableFuture<NumberListResponse> = list(NumberListParams.none())
+
+    /** @see list */
+    fun list(
+        params: NumberListParams = NumberListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<NumberListResponse>
+
+    /** @see list */
+    fun list(
+        params: NumberListParams = NumberListParams.none()
+    ): CompletableFuture<NumberListResponse> = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): CompletableFuture<NumberListResponse> =
+        list(NumberListParams.none(), requestOptions)
+
+    /**
+     * A view of [NumberServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): NumberServiceAsync.WithRawResponse
+
+        /** Manage and share your iMessage contact card (Name & Photo) */
+        fun contactCard(): ContactCardServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /me/numbers`, but is otherwise the same as
+         * [NumberServiceAsync.list].
+         */
+        fun list(): CompletableFuture<HttpResponseFor<NumberListResponse>> =
+            list(NumberListParams.none())
+
+        /** @see list */
+        fun list(
+            params: NumberListParams = NumberListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<NumberListResponse>>
+
+        /** @see list */
+        fun list(
+            params: NumberListParams = NumberListParams.none()
+        ): CompletableFuture<HttpResponseFor<NumberListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<NumberListResponse>> =
+            list(NumberListParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncImpl.kt
new file mode 100644
index 0000000..7ad9b41
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncImpl.kt
@@ -0,0 +1,101 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.me.numbers.NumberListParams
+import com.blooio.api.models.me.numbers.NumberListResponse
+import com.blooio.api.services.async.me.numbers.ContactCardServiceAsync
+import com.blooio.api.services.async.me.numbers.ContactCardServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage phone numbers linked to your account */
+class NumberServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    NumberServiceAsync {
+
+    private val withRawResponse: NumberServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val contactCard: ContactCardServiceAsync by lazy {
+        ContactCardServiceAsyncImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): NumberServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): NumberServiceAsync =
+        NumberServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage and share your iMessage contact card (Name & Photo) */
+    override fun contactCard(): ContactCardServiceAsync = contactCard
+
+    override fun list(
+        params: NumberListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<NumberListResponse> =
+        // get /me/numbers
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        NumberServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val contactCard: ContactCardServiceAsync.WithRawResponse by lazy {
+            ContactCardServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): NumberServiceAsync.WithRawResponse =
+            NumberServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage and share your iMessage contact card (Name & Photo) */
+        override fun contactCard(): ContactCardServiceAsync.WithRawResponse = contactCard
+
+        private val listHandler: Handler<NumberListResponse> =
+            jsonHandler<NumberListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: NumberListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<NumberListResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
new file mode 100644
index 0000000..2bc1c33
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
@@ -0,0 +1,209 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me.numbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveResponse
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage and share your iMessage contact card (Name & Photo) */
+interface ContactCardServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactCardServiceAsync
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Get the personal contact card (Name & Photo) for the specified phone number. This is the
+     * identity that gets shared with contacts in iMessage.
+     */
+    fun retrieve(number: String): CompletableFuture<ContactCardRetrieveResponse> =
+        retrieve(number, ContactCardRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        number: String,
+        params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactCardRetrieveResponse> =
+        retrieve(params.toBuilder().number(number).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        number: String,
+        params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+    ): CompletableFuture<ContactCardRetrieveResponse> =
+        retrieve(number, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactCardRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactCardRetrieveResponse>
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactCardRetrieveParams
+    ): CompletableFuture<ContactCardRetrieveResponse> = retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        number: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactCardRetrieveResponse> =
+        retrieve(number, ContactCardRetrieveParams.none(), requestOptions)
+
+    /**
+     * Update the personal contact card (Name & Photo) for the specified phone number. All fields
+     * are optional — only provided fields are updated.
+     */
+    fun update(number: String): CompletableFuture<ContactCardUpdateResponse> =
+        update(number, ContactCardUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        number: String,
+        params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactCardUpdateResponse> =
+        update(params.toBuilder().number(number).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        number: String,
+        params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+    ): CompletableFuture<ContactCardUpdateResponse> = update(number, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: ContactCardUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<ContactCardUpdateResponse>
+
+    /** @see update */
+    fun update(params: ContactCardUpdateParams): CompletableFuture<ContactCardUpdateResponse> =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        number: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactCardUpdateResponse> =
+        update(number, ContactCardUpdateParams.none(), requestOptions)
+
+    /**
+     * A view of [ContactCardServiceAsync] that provides access to raw HTTP responses for each
+     * method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactCardServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /me/numbers/{number}/contact-card`, but is otherwise
+         * the same as [ContactCardServiceAsync.retrieve].
+         */
+        fun retrieve(
+            number: String
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> =
+            retrieve(number, ContactCardRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            number: String,
+            params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> =
+            retrieve(params.toBuilder().number(number).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            number: String,
+            params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> =
+            retrieve(number, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ContactCardRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>>
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ContactCardRetrieveParams
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            number: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> =
+            retrieve(number, ContactCardRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `put /me/numbers/{number}/contact-card`, but is otherwise
+         * the same as [ContactCardServiceAsync.update].
+         */
+        fun update(number: String): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> =
+            update(number, ContactCardUpdateParams.none())
+
+        /** @see update */
+        fun update(
+            number: String,
+            params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> =
+            update(params.toBuilder().number(number).build(), requestOptions)
+
+        /** @see update */
+        fun update(
+            number: String,
+            params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> =
+            update(number, params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            params: ContactCardUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>>
+
+        /** @see update */
+        fun update(
+            params: ContactCardUpdateParams
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        fun update(
+            number: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> =
+            update(number, ContactCardUpdateParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncImpl.kt
new file mode 100644
index 0000000..5ca3cdb
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncImpl.kt
@@ -0,0 +1,134 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me.numbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveResponse
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage and share your iMessage contact card (Name & Photo) */
+class ContactCardServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    ContactCardServiceAsync {
+
+    private val withRawResponse: ContactCardServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ContactCardServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactCardServiceAsync =
+        ContactCardServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: ContactCardRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactCardRetrieveResponse> =
+        // get /me/numbers/{number}/contact-card
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun update(
+        params: ContactCardUpdateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<ContactCardUpdateResponse> =
+        // put /me/numbers/{number}/contact-card
+        withRawResponse().update(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ContactCardServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactCardServiceAsync.WithRawResponse =
+            ContactCardServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ContactCardRetrieveResponse> =
+            jsonHandler<ContactCardRetrieveResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactCardRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactCardRetrieveResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("number", params.number().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers", params._pathParam(0), "contact-card")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val updateHandler: Handler<ContactCardUpdateResponse> =
+            jsonHandler<ContactCardUpdateResponse>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: ContactCardUpdateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<ContactCardUpdateResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("number", params.number().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PUT)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers", params._pathParam(0), "contact-card")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { updateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsync.kt
new file mode 100644
index 0000000..238c8ca
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsync.kt
@@ -0,0 +1,109 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.phonenumbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+interface LookupServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LookupServiceAsync
+
+    /**
+     * Same as the GET endpoint, but accepts the phone number in the request body. Useful when the
+     * number contains characters that are difficult to URL-encode.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise).
+     */
+    fun create(params: LookupCreateParams): CompletableFuture<PhoneNumberLookupResult> =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: LookupCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PhoneNumberLookupResult>
+
+    /**
+     * Returns detailed information about a phone number including validation, formatting (E.164,
+     * national, international), number type, and NANPA geocoding (city, state/province) for North
+     * American numbers. The geocoding data is sourced from different database with 240,000+ NPA-NXX
+     * entries.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise). Returns 403 if your organization does
+     * not have an active enterprise subscription.
+     */
+    fun retrieve(params: LookupRetrieveParams): CompletableFuture<PhoneNumberLookupResult> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: LookupRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<PhoneNumberLookupResult>
+
+    /**
+     * A view of [LookupServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): LookupServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /phone-numbers/lookup`, but is otherwise the same
+         * as [LookupServiceAsync.create].
+         */
+        fun create(
+            params: LookupCreateParams
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        fun create(
+            params: LookupCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>>
+
+        /**
+         * Returns a raw HTTP response for `get /phone-numbers/lookup`, but is otherwise the same as
+         * [LookupServiceAsync.retrieve].
+         */
+        fun retrieve(
+            params: LookupRetrieveParams
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: LookupRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncImpl.kt
similarity index 62%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncImpl.kt
index 73a4fa5..ed24d96 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncImpl.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.services.async.config
+package com.blooio.api.services.async.phonenumbers
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
@@ -15,65 +15,68 @@ import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepareAsync
-import com.blooio.api.models.config.webhook.WebhookRetrieveParams
-import com.blooio.api.models.config.webhook.WebhookRetrieveResponse
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import com.blooio.api.models.config.webhook.WebhookUpdateResponse
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
-/** Account-level configuration */
-class WebhookServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
-    WebhookServiceAsync {
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+class LookupServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    LookupServiceAsync {
 
-    private val withRawResponse: WebhookServiceAsync.WithRawResponse by lazy {
+    private val withRawResponse: LookupServiceAsync.WithRawResponse by lazy {
         WithRawResponseImpl(clientOptions)
     }
 
-    override fun withRawResponse(): WebhookServiceAsync.WithRawResponse = withRawResponse
+    override fun withRawResponse(): LookupServiceAsync.WithRawResponse = withRawResponse
 
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookServiceAsync =
-        WebhookServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LookupServiceAsync =
+        LookupServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    override fun retrieve(
-        params: WebhookRetrieveParams,
+    override fun create(
+        params: LookupCreateParams,
         requestOptions: RequestOptions,
-    ): CompletableFuture<WebhookRetrieveResponse> =
-        // get /v1/api/config/webhook
-        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+    ): CompletableFuture<PhoneNumberLookupResult> =
+        // post /phone-numbers/lookup
+        withRawResponse().create(params, requestOptions).thenApply { it.parse() }
 
-    override fun update(
-        params: WebhookUpdateParams,
+    override fun retrieve(
+        params: LookupRetrieveParams,
         requestOptions: RequestOptions,
-    ): CompletableFuture<WebhookUpdateResponse> =
-        // put /v1/api/config/webhook
-        withRawResponse().update(params, requestOptions).thenApply { it.parse() }
+    ): CompletableFuture<PhoneNumberLookupResult> =
+        // get /phone-numbers/lookup
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        WebhookServiceAsync.WithRawResponse {
+        LookupServiceAsync.WithRawResponse {
 
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
-        ): WebhookServiceAsync.WithRawResponse =
-            WebhookServiceAsyncImpl.WithRawResponseImpl(
+        ): LookupServiceAsync.WithRawResponse =
+            LookupServiceAsyncImpl.WithRawResponseImpl(
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        private val retrieveHandler: Handler<WebhookRetrieveResponse> =
-            jsonHandler<WebhookRetrieveResponse>(clientOptions.jsonMapper)
+        private val createHandler: Handler<PhoneNumberLookupResult> =
+            jsonHandler<PhoneNumberLookupResult>(clientOptions.jsonMapper)
 
-        override fun retrieve(
-            params: WebhookRetrieveParams,
+        override fun create(
+            params: LookupCreateParams,
             requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<WebhookRetrieveResponse>> {
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>> {
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.GET)
+                    .method(HttpMethod.POST)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "config", "webhook")
+                    .addPathSegments("phone-numbers", "lookup")
+                    .body(json(clientOptions.jsonMapper, params._body()))
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -82,7 +85,7 @@ class WebhookServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 .thenApply { response ->
                     errorHandler.handle(response).parseable {
                         response
-                            .use { retrieveHandler.handle(it) }
+                            .use { createHandler.handle(it) }
                             .also {
                                 if (requestOptions.responseValidation!!) {
                                     it.validate()
@@ -92,19 +95,18 @@ class WebhookServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 }
         }
 
-        private val updateHandler: Handler<WebhookUpdateResponse> =
-            jsonHandler<WebhookUpdateResponse>(clientOptions.jsonMapper)
+        private val retrieveHandler: Handler<PhoneNumberLookupResult> =
+            jsonHandler<PhoneNumberLookupResult>(clientOptions.jsonMapper)
 
-        override fun update(
-            params: WebhookUpdateParams,
+        override fun retrieve(
+            params: LookupRetrieveParams,
             requestOptions: RequestOptions,
-        ): CompletableFuture<HttpResponseFor<WebhookUpdateResponse>> {
+        ): CompletableFuture<HttpResponseFor<PhoneNumberLookupResult>> {
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.PUT)
+                    .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "config", "webhook")
-                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .addPathSegments("phone-numbers", "lookup")
                     .build()
                     .prepareAsync(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -113,7 +115,7 @@ class WebhookServiceAsyncImpl internal constructor(private val clientOptions: Cl
                 .thenApply { response ->
                     errorHandler.handle(response).parseable {
                         response
-                            .use { updateHandler.handle(it) }
+                            .use { retrieveHandler.handle(it) }
                             .also {
                                 if (requestOptions.responseValidation!!) {
                                     it.validate()
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsync.kt
new file mode 100644
index 0000000..89df1b6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsync.kt
@@ -0,0 +1,163 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogListResponse
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import com.blooio.api.models.webhooks.logs.LogReplayResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** View and replay webhook deliveries */
+interface LogServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogServiceAsync
+
+    /** List delivery logs for a specific webhook. */
+    fun list(webhookId: String): CompletableFuture<LogListResponse> =
+        list(webhookId, LogListParams.none())
+
+    /** @see list */
+    fun list(
+        webhookId: String,
+        params: LogListParams = LogListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<LogListResponse> =
+        list(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        webhookId: String,
+        params: LogListParams = LogListParams.none(),
+    ): CompletableFuture<LogListResponse> = list(webhookId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: LogListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<LogListResponse>
+
+    /** @see list */
+    fun list(params: LogListParams): CompletableFuture<LogListResponse> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        webhookId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<LogListResponse> = list(webhookId, LogListParams.none(), requestOptions)
+
+    /** Re-send a webhook event to the configured URL. */
+    fun replay(eventId: String, params: LogReplayParams): CompletableFuture<LogReplayResponse> =
+        replay(eventId, params, RequestOptions.none())
+
+    /** @see replay */
+    fun replay(
+        eventId: String,
+        params: LogReplayParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<LogReplayResponse> =
+        replay(params.toBuilder().eventId(eventId).build(), requestOptions)
+
+    /** @see replay */
+    fun replay(params: LogReplayParams): CompletableFuture<LogReplayResponse> =
+        replay(params, RequestOptions.none())
+
+    /** @see replay */
+    fun replay(
+        params: LogReplayParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<LogReplayResponse>
+
+    /** A view of [LogServiceAsync] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks/{webhookId}/logs`, but is otherwise the
+         * same as [LogServiceAsync.list].
+         */
+        fun list(webhookId: String): CompletableFuture<HttpResponseFor<LogListResponse>> =
+            list(webhookId, LogListParams.none())
+
+        /** @see list */
+        fun list(
+            webhookId: String,
+            params: LogListParams = LogListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<LogListResponse>> =
+            list(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see list */
+        fun list(
+            webhookId: String,
+            params: LogListParams = LogListParams.none(),
+        ): CompletableFuture<HttpResponseFor<LogListResponse>> =
+            list(webhookId, params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            params: LogListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<LogListResponse>>
+
+        /** @see list */
+        fun list(params: LogListParams): CompletableFuture<HttpResponseFor<LogListResponse>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<LogListResponse>> =
+            list(webhookId, LogListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks/{webhookId}/logs/{eventId}/replay`, but
+         * is otherwise the same as [LogServiceAsync.replay].
+         */
+        fun replay(
+            eventId: String,
+            params: LogReplayParams,
+        ): CompletableFuture<HttpResponseFor<LogReplayResponse>> =
+            replay(eventId, params, RequestOptions.none())
+
+        /** @see replay */
+        fun replay(
+            eventId: String,
+            params: LogReplayParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<LogReplayResponse>> =
+            replay(params.toBuilder().eventId(eventId).build(), requestOptions)
+
+        /** @see replay */
+        fun replay(params: LogReplayParams): CompletableFuture<HttpResponseFor<LogReplayResponse>> =
+            replay(params, RequestOptions.none())
+
+        /** @see replay */
+        fun replay(
+            params: LogReplayParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<LogReplayResponse>>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncImpl.kt
new file mode 100644
index 0000000..1fab236
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncImpl.kt
@@ -0,0 +1,140 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogListResponse
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import com.blooio.api.models.webhooks.logs.LogReplayResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** View and replay webhook deliveries */
+class LogServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    LogServiceAsync {
+
+    private val withRawResponse: LogServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): LogServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogServiceAsync =
+        LogServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: LogListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<LogListResponse> =
+        // get /webhooks/{webhookId}/logs
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    override fun replay(
+        params: LogReplayParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<LogReplayResponse> =
+        // post /webhooks/{webhookId}/logs/{eventId}/replay
+        withRawResponse().replay(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        LogServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): LogServiceAsync.WithRawResponse =
+            LogServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<LogListResponse> =
+            jsonHandler<LogListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: LogListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<LogListResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0), "logs")
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val replayHandler: Handler<LogReplayResponse> =
+            jsonHandler<LogReplayResponse>(clientOptions.jsonMapper)
+
+        override fun replay(
+            params: LogReplayParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<LogReplayResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("eventId", params.eventId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "webhooks",
+                        params._pathParam(0),
+                        "logs",
+                        params._pathParam(1),
+                        "replay",
+                    )
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { replayHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsync.kt
new file mode 100644
index 0000000..d63716a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsync.kt
@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.secret.SecretRotateParams
+import com.blooio.api.models.webhooks.secret.SecretRotateResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+/** Manage webhook subscriptions */
+interface SecretServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): SecretServiceAsync
+
+    /**
+     * Generate a new signing secret for the webhook. The new secret is returned only once in this
+     * response - store it securely. The old secret becomes invalid immediately.
+     */
+    fun rotate(webhookId: String): CompletableFuture<SecretRotateResponse> =
+        rotate(webhookId, SecretRotateParams.none())
+
+    /** @see rotate */
+    fun rotate(
+        webhookId: String,
+        params: SecretRotateParams = SecretRotateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<SecretRotateResponse> =
+        rotate(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see rotate */
+    fun rotate(
+        webhookId: String,
+        params: SecretRotateParams = SecretRotateParams.none(),
+    ): CompletableFuture<SecretRotateResponse> = rotate(webhookId, params, RequestOptions.none())
+
+    /** @see rotate */
+    fun rotate(
+        params: SecretRotateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<SecretRotateResponse>
+
+    /** @see rotate */
+    fun rotate(params: SecretRotateParams): CompletableFuture<SecretRotateResponse> =
+        rotate(params, RequestOptions.none())
+
+    /** @see rotate */
+    fun rotate(
+        webhookId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<SecretRotateResponse> =
+        rotate(webhookId, SecretRotateParams.none(), requestOptions)
+
+    /**
+     * A view of [SecretServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): SecretServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks/{webhookId}/secret/rotate`, but is
+         * otherwise the same as [SecretServiceAsync.rotate].
+         */
+        fun rotate(webhookId: String): CompletableFuture<HttpResponseFor<SecretRotateResponse>> =
+            rotate(webhookId, SecretRotateParams.none())
+
+        /** @see rotate */
+        fun rotate(
+            webhookId: String,
+            params: SecretRotateParams = SecretRotateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>> =
+            rotate(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see rotate */
+        fun rotate(
+            webhookId: String,
+            params: SecretRotateParams = SecretRotateParams.none(),
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>> =
+            rotate(webhookId, params, RequestOptions.none())
+
+        /** @see rotate */
+        fun rotate(
+            params: SecretRotateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>>
+
+        /** @see rotate */
+        fun rotate(
+            params: SecretRotateParams
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>> =
+            rotate(params, RequestOptions.none())
+
+        /** @see rotate */
+        fun rotate(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>> =
+            rotate(webhookId, SecretRotateParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncImpl.kt
new file mode 100644
index 0000000..861e8e7
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncImpl.kt
@@ -0,0 +1,92 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepareAsync
+import com.blooio.api.models.webhooks.secret.SecretRotateParams
+import com.blooio.api.models.webhooks.secret.SecretRotateResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage webhook subscriptions */
+class SecretServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    SecretServiceAsync {
+
+    private val withRawResponse: SecretServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): SecretServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): SecretServiceAsync =
+        SecretServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun rotate(
+        params: SecretRotateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<SecretRotateResponse> =
+        // post /webhooks/{webhookId}/secret/rotate
+        withRawResponse().rotate(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        SecretServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): SecretServiceAsync.WithRawResponse =
+            SecretServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val rotateHandler: Handler<SecretRotateResponse> =
+            jsonHandler<SecretRotateResponse>(clientOptions.jsonMapper)
+
+        override fun rotate(
+            params: SecretRotateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<SecretRotateResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0), "secret", "rotate")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { rotateHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
deleted file mode 100644
index 778416c..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchService.kt
+++ /dev/null
@@ -1,285 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponse
-import com.blooio.api.models.batches.BatchCreateParams
-import com.blooio.api.models.batches.BatchListMessagesParams
-import com.blooio.api.models.batches.BatchRetrieveParams
-import com.blooio.api.models.batches.BatchRetrieveStatusParams
-import com.google.errorprone.annotations.MustBeClosed
-import java.util.function.Consumer
-
-/** Bulk/batch operations (stubbed) */
-interface BatchService {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): BatchService
-
-    /** Create a batch of messages (stub) */
-    fun create() = create(BatchCreateParams.none())
-
-    /** @see create */
-    fun create(
-        params: BatchCreateParams = BatchCreateParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    )
-
-    /** @see create */
-    fun create(params: BatchCreateParams = BatchCreateParams.none()) =
-        create(params, RequestOptions.none())
-
-    /** @see create */
-    fun create(requestOptions: RequestOptions) = create(BatchCreateParams.none(), requestOptions)
-
-    /** Get batch details (stub) */
-    fun retrieve(batchId: String) = retrieve(batchId, BatchRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        batchId: String,
-        params: BatchRetrieveParams = BatchRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ) = retrieve(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see retrieve */
-    fun retrieve(batchId: String, params: BatchRetrieveParams = BatchRetrieveParams.none()) =
-        retrieve(batchId, params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: BatchRetrieveParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    )
-
-    /** @see retrieve */
-    fun retrieve(params: BatchRetrieveParams) = retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(batchId: String, requestOptions: RequestOptions) =
-        retrieve(batchId, BatchRetrieveParams.none(), requestOptions)
-
-    /** List messages in a batch (stub) */
-    fun listMessages(batchId: String) = listMessages(batchId, BatchListMessagesParams.none())
-
-    /** @see listMessages */
-    fun listMessages(
-        batchId: String,
-        params: BatchListMessagesParams = BatchListMessagesParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ) = listMessages(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see listMessages */
-    fun listMessages(
-        batchId: String,
-        params: BatchListMessagesParams = BatchListMessagesParams.none(),
-    ) = listMessages(batchId, params, RequestOptions.none())
-
-    /** @see listMessages */
-    fun listMessages(
-        params: BatchListMessagesParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    )
-
-    /** @see listMessages */
-    fun listMessages(params: BatchListMessagesParams) = listMessages(params, RequestOptions.none())
-
-    /** @see listMessages */
-    fun listMessages(batchId: String, requestOptions: RequestOptions) =
-        listMessages(batchId, BatchListMessagesParams.none(), requestOptions)
-
-    /** Get batch status (stub) */
-    fun retrieveStatus(batchId: String) = retrieveStatus(batchId, BatchRetrieveStatusParams.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        batchId: String,
-        params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ) = retrieveStatus(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        batchId: String,
-        params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-    ) = retrieveStatus(batchId, params, RequestOptions.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(
-        params: BatchRetrieveStatusParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    )
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(params: BatchRetrieveStatusParams) =
-        retrieveStatus(params, RequestOptions.none())
-
-    /** @see retrieveStatus */
-    fun retrieveStatus(batchId: String, requestOptions: RequestOptions) =
-        retrieveStatus(batchId, BatchRetrieveStatusParams.none(), requestOptions)
-
-    /** A view of [BatchService] that provides access to raw HTTP responses for each method. */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(modifier: Consumer<ClientOptions.Builder>): BatchService.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `post /v1/api/batches`, but is otherwise the same as
-         * [BatchService.create].
-         */
-        @MustBeClosed fun create(): HttpResponse = create(BatchCreateParams.none())
-
-        /** @see create */
-        @MustBeClosed
-        fun create(
-            params: BatchCreateParams = BatchCreateParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse
-
-        /** @see create */
-        @MustBeClosed
-        fun create(params: BatchCreateParams = BatchCreateParams.none()): HttpResponse =
-            create(params, RequestOptions.none())
-
-        /** @see create */
-        @MustBeClosed
-        fun create(requestOptions: RequestOptions): HttpResponse =
-            create(BatchCreateParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}`, but is otherwise the
-         * same as [BatchService.retrieve].
-         */
-        @MustBeClosed
-        fun retrieve(batchId: String): HttpResponse = retrieve(batchId, BatchRetrieveParams.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            batchId: String,
-            params: BatchRetrieveParams = BatchRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse = retrieve(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            batchId: String,
-            params: BatchRetrieveParams = BatchRetrieveParams.none(),
-        ): HttpResponse = retrieve(batchId, params, RequestOptions.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            params: BatchRetrieveParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(params: BatchRetrieveParams): HttpResponse =
-            retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(batchId: String, requestOptions: RequestOptions): HttpResponse =
-            retrieve(batchId, BatchRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}/messages`, but is
-         * otherwise the same as [BatchService.listMessages].
-         */
-        @MustBeClosed
-        fun listMessages(batchId: String): HttpResponse =
-            listMessages(batchId, BatchListMessagesParams.none())
-
-        /** @see listMessages */
-        @MustBeClosed
-        fun listMessages(
-            batchId: String,
-            params: BatchListMessagesParams = BatchListMessagesParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse = listMessages(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see listMessages */
-        @MustBeClosed
-        fun listMessages(
-            batchId: String,
-            params: BatchListMessagesParams = BatchListMessagesParams.none(),
-        ): HttpResponse = listMessages(batchId, params, RequestOptions.none())
-
-        /** @see listMessages */
-        @MustBeClosed
-        fun listMessages(
-            params: BatchListMessagesParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse
-
-        /** @see listMessages */
-        @MustBeClosed
-        fun listMessages(params: BatchListMessagesParams): HttpResponse =
-            listMessages(params, RequestOptions.none())
-
-        /** @see listMessages */
-        @MustBeClosed
-        fun listMessages(batchId: String, requestOptions: RequestOptions): HttpResponse =
-            listMessages(batchId, BatchListMessagesParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/batches/{batchId}/status`, but is otherwise
-         * the same as [BatchService.retrieveStatus].
-         */
-        @MustBeClosed
-        fun retrieveStatus(batchId: String): HttpResponse =
-            retrieveStatus(batchId, BatchRetrieveStatusParams.none())
-
-        /** @see retrieveStatus */
-        @MustBeClosed
-        fun retrieveStatus(
-            batchId: String,
-            params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse =
-            retrieveStatus(params.toBuilder().batchId(batchId).build(), requestOptions)
-
-        /** @see retrieveStatus */
-        @MustBeClosed
-        fun retrieveStatus(
-            batchId: String,
-            params: BatchRetrieveStatusParams = BatchRetrieveStatusParams.none(),
-        ): HttpResponse = retrieveStatus(batchId, params, RequestOptions.none())
-
-        /** @see retrieveStatus */
-        @MustBeClosed
-        fun retrieveStatus(
-            params: BatchRetrieveStatusParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponse
-
-        /** @see retrieveStatus */
-        @MustBeClosed
-        fun retrieveStatus(params: BatchRetrieveStatusParams): HttpResponse =
-            retrieveStatus(params, RequestOptions.none())
-
-        /** @see retrieveStatus */
-        @MustBeClosed
-        fun retrieveStatus(batchId: String, requestOptions: RequestOptions): HttpResponse =
-            retrieveStatus(batchId, BatchRetrieveStatusParams.none(), requestOptions)
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
deleted file mode 100644
index 45b8d5e..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/BatchServiceImpl.kt
+++ /dev/null
@@ -1,161 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.checkRequired
-import com.blooio.api.core.handlers.emptyHandler
-import com.blooio.api.core.handlers.errorBodyHandler
-import com.blooio.api.core.handlers.errorHandler
-import com.blooio.api.core.http.HttpMethod
-import com.blooio.api.core.http.HttpRequest
-import com.blooio.api.core.http.HttpResponse
-import com.blooio.api.core.http.HttpResponse.Handler
-import com.blooio.api.core.http.json
-import com.blooio.api.core.http.parseable
-import com.blooio.api.core.prepare
-import com.blooio.api.models.batches.BatchCreateParams
-import com.blooio.api.models.batches.BatchListMessagesParams
-import com.blooio.api.models.batches.BatchRetrieveParams
-import com.blooio.api.models.batches.BatchRetrieveStatusParams
-import java.util.function.Consumer
-import kotlin.jvm.optionals.getOrNull
-
-/** Bulk/batch operations (stubbed) */
-class BatchServiceImpl internal constructor(private val clientOptions: ClientOptions) :
-    BatchService {
-
-    private val withRawResponse: BatchService.WithRawResponse by lazy {
-        WithRawResponseImpl(clientOptions)
-    }
-
-    override fun withRawResponse(): BatchService.WithRawResponse = withRawResponse
-
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BatchService =
-        BatchServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
-
-    override fun create(params: BatchCreateParams, requestOptions: RequestOptions) {
-        // post /v1/api/batches
-        withRawResponse().create(params, requestOptions)
-    }
-
-    override fun retrieve(params: BatchRetrieveParams, requestOptions: RequestOptions) {
-        // get /v1/api/batches/{batchId}
-        withRawResponse().retrieve(params, requestOptions)
-    }
-
-    override fun listMessages(params: BatchListMessagesParams, requestOptions: RequestOptions) {
-        // get /v1/api/batches/{batchId}/messages
-        withRawResponse().listMessages(params, requestOptions)
-    }
-
-    override fun retrieveStatus(params: BatchRetrieveStatusParams, requestOptions: RequestOptions) {
-        // get /v1/api/batches/{batchId}/status
-        withRawResponse().retrieveStatus(params, requestOptions)
-    }
-
-    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        BatchService.WithRawResponse {
-
-        private val errorHandler: Handler<HttpResponse> =
-            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
-
-        override fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): BatchService.WithRawResponse =
-            BatchServiceImpl.WithRawResponseImpl(
-                clientOptions.toBuilder().apply(modifier::accept).build()
-            )
-
-        private val createHandler: Handler<Void?> = emptyHandler()
-
-        override fun create(
-            params: BatchCreateParams,
-            requestOptions: RequestOptions,
-        ): HttpResponse {
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.POST)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches")
-                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
-                    .build()
-                    .prepare(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            val response = clientOptions.httpClient.execute(request, requestOptions)
-            return errorHandler.handle(response).parseable {
-                response.use { createHandler.handle(it) }
-            }
-        }
-
-        private val retrieveHandler: Handler<Void?> = emptyHandler()
-
-        override fun retrieve(
-            params: BatchRetrieveParams,
-            requestOptions: RequestOptions,
-        ): HttpResponse {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0))
-                    .build()
-                    .prepare(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            val response = clientOptions.httpClient.execute(request, requestOptions)
-            return errorHandler.handle(response).parseable {
-                response.use { retrieveHandler.handle(it) }
-            }
-        }
-
-        private val listMessagesHandler: Handler<Void?> = emptyHandler()
-
-        override fun listMessages(
-            params: BatchListMessagesParams,
-            requestOptions: RequestOptions,
-        ): HttpResponse {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0), "messages")
-                    .build()
-                    .prepare(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            val response = clientOptions.httpClient.execute(request, requestOptions)
-            return errorHandler.handle(response).parseable {
-                response.use { listMessagesHandler.handle(it) }
-            }
-        }
-
-        private val retrieveStatusHandler: Handler<Void?> = emptyHandler()
-
-        override fun retrieveStatus(
-            params: BatchRetrieveStatusParams,
-            requestOptions: RequestOptions,
-        ): HttpResponse {
-            // We check here instead of in the params builder because this can be specified
-            // positionally or in the params class.
-            checkRequired("batchId", params.batchId().getOrNull())
-            val request =
-                HttpRequest.builder()
-                    .method(HttpMethod.GET)
-                    .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "batches", params._pathParam(0), "status")
-                    .build()
-                    .prepare(clientOptions, params)
-            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
-            val response = clientOptions.httpClient.execute(request, requestOptions)
-            return errorHandler.handle(response).parseable {
-                response.use { retrieveStatusHandler.handle(it) }
-            }
-        }
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
new file mode 100644
index 0000000..9d3b430
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
@@ -0,0 +1,355 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.ChatListParams
+import com.blooio.api.models.chats.ChatListResponse
+import com.blooio.api.models.chats.ChatMarkAsReadParams
+import com.blooio.api.models.chats.ChatMarkAsReadResponse
+import com.blooio.api.models.chats.ChatRetrieveParams
+import com.blooio.api.models.chats.ChatRetrieveResponse
+import com.blooio.api.models.chats.ChatShareContactCardParams
+import com.blooio.api.models.chats.ChatShareContactCardResponse
+import com.blooio.api.services.blocking.chats.BackgroundService
+import com.blooio.api.services.blocking.chats.MessageService
+import com.blooio.api.services.blocking.chats.PollService
+import com.blooio.api.services.blocking.chats.TypingService
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+interface ChatService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatService
+
+    fun messages(): MessageService
+
+    /**
+     * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+     * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+     * require webhook_type 'poll' or 'all'.
+     */
+    fun polls(): PollService
+
+    /** Control typing indicators for conversations */
+    fun typing(): TypingService
+
+    /** Set, get, and remove conversation backgrounds */
+    fun background(): BackgroundService
+
+    /** Get details for a specific conversation. */
+    fun retrieve(chatId: String): ChatRetrieveResponse = retrieve(chatId, ChatRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: ChatRetrieveParams = ChatRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatRetrieveResponse = retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: ChatRetrieveParams = ChatRetrieveParams.none(),
+    ): ChatRetrieveResponse = retrieve(chatId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ChatRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatRetrieveResponse
+
+    /** @see retrieve */
+    fun retrieve(params: ChatRetrieveParams): ChatRetrieveResponse =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(chatId: String, requestOptions: RequestOptions): ChatRetrieveResponse =
+        retrieve(chatId, ChatRetrieveParams.none(), requestOptions)
+
+    /** List all unique conversations for the organization, sorted by most recent message. */
+    fun list(): ChatListResponse = list(ChatListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ChatListParams = ChatListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatListResponse
+
+    /** @see list */
+    fun list(params: ChatListParams = ChatListParams.none()): ChatListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): ChatListResponse =
+        list(ChatListParams.none(), requestOptions)
+
+    /** Mark all messages in a chat as read. This sends a read receipt to the sender. */
+    fun markAsRead(chatId: String): ChatMarkAsReadResponse =
+        markAsRead(chatId, ChatMarkAsReadParams.none())
+
+    /** @see markAsRead */
+    fun markAsRead(
+        chatId: String,
+        params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatMarkAsReadResponse =
+        markAsRead(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see markAsRead */
+    fun markAsRead(
+        chatId: String,
+        params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+    ): ChatMarkAsReadResponse = markAsRead(chatId, params, RequestOptions.none())
+
+    /** @see markAsRead */
+    fun markAsRead(
+        params: ChatMarkAsReadParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatMarkAsReadResponse
+
+    /** @see markAsRead */
+    fun markAsRead(params: ChatMarkAsReadParams): ChatMarkAsReadResponse =
+        markAsRead(params, RequestOptions.none())
+
+    /** @see markAsRead */
+    fun markAsRead(chatId: String, requestOptions: RequestOptions): ChatMarkAsReadResponse =
+        markAsRead(chatId, ChatMarkAsReadParams.none(), requestOptions)
+
+    /**
+     * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be
+     * piggybacked onto the next outgoing message (text or attachment) sent to this chat. This is
+     * idempotent — calling it multiple times is harmless.
+     */
+    fun shareContactCard(chatId: String): ChatShareContactCardResponse =
+        shareContactCard(chatId, ChatShareContactCardParams.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatShareContactCardResponse =
+        shareContactCard(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+    ): ChatShareContactCardResponse = shareContactCard(chatId, params, RequestOptions.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        params: ChatShareContactCardParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatShareContactCardResponse
+
+    /** @see shareContactCard */
+    fun shareContactCard(params: ChatShareContactCardParams): ChatShareContactCardResponse =
+        shareContactCard(params, RequestOptions.none())
+
+    /** @see shareContactCard */
+    fun shareContactCard(
+        chatId: String,
+        requestOptions: RequestOptions,
+    ): ChatShareContactCardResponse =
+        shareContactCard(chatId, ChatShareContactCardParams.none(), requestOptions)
+
+    /** A view of [ChatService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatService.WithRawResponse
+
+        fun messages(): MessageService.WithRawResponse
+
+        /**
+         * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+         * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+         * require webhook_type 'poll' or 'all'.
+         */
+        fun polls(): PollService.WithRawResponse
+
+        /** Control typing indicators for conversations */
+        fun typing(): TypingService.WithRawResponse
+
+        /** Set, get, and remove conversation backgrounds */
+        fun background(): BackgroundService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}`, but is otherwise the same as
+         * [ChatService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(chatId: String): HttpResponseFor<ChatRetrieveResponse> =
+            retrieve(chatId, ChatRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            params: ChatRetrieveParams = ChatRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatRetrieveResponse> =
+            retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            params: ChatRetrieveParams = ChatRetrieveParams.none(),
+        ): HttpResponseFor<ChatRetrieveResponse> = retrieve(chatId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ChatRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatRetrieveResponse>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: ChatRetrieveParams): HttpResponseFor<ChatRetrieveResponse> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatRetrieveResponse> =
+            retrieve(chatId, ChatRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /chats`, but is otherwise the same as
+         * [ChatService.list].
+         */
+        @MustBeClosed fun list(): HttpResponseFor<ChatListResponse> = list(ChatListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ChatListParams = ChatListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ChatListParams = ChatListParams.none()
+        ): HttpResponseFor<ChatListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<ChatListResponse> =
+            list(ChatListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/read`, but is otherwise the same as
+         * [ChatService.markAsRead].
+         */
+        @MustBeClosed
+        fun markAsRead(chatId: String): HttpResponseFor<ChatMarkAsReadResponse> =
+            markAsRead(chatId, ChatMarkAsReadParams.none())
+
+        /** @see markAsRead */
+        @MustBeClosed
+        fun markAsRead(
+            chatId: String,
+            params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatMarkAsReadResponse> =
+            markAsRead(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see markAsRead */
+        @MustBeClosed
+        fun markAsRead(
+            chatId: String,
+            params: ChatMarkAsReadParams = ChatMarkAsReadParams.none(),
+        ): HttpResponseFor<ChatMarkAsReadResponse> =
+            markAsRead(chatId, params, RequestOptions.none())
+
+        /** @see markAsRead */
+        @MustBeClosed
+        fun markAsRead(
+            params: ChatMarkAsReadParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatMarkAsReadResponse>
+
+        /** @see markAsRead */
+        @MustBeClosed
+        fun markAsRead(params: ChatMarkAsReadParams): HttpResponseFor<ChatMarkAsReadResponse> =
+            markAsRead(params, RequestOptions.none())
+
+        /** @see markAsRead */
+        @MustBeClosed
+        fun markAsRead(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatMarkAsReadResponse> =
+            markAsRead(chatId, ChatMarkAsReadParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/contact-card`, but is otherwise the
+         * same as [ChatService.shareContactCard].
+         */
+        @MustBeClosed
+        fun shareContactCard(chatId: String): HttpResponseFor<ChatShareContactCardResponse> =
+            shareContactCard(chatId, ChatShareContactCardParams.none())
+
+        /** @see shareContactCard */
+        @MustBeClosed
+        fun shareContactCard(
+            chatId: String,
+            params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatShareContactCardResponse> =
+            shareContactCard(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see shareContactCard */
+        @MustBeClosed
+        fun shareContactCard(
+            chatId: String,
+            params: ChatShareContactCardParams = ChatShareContactCardParams.none(),
+        ): HttpResponseFor<ChatShareContactCardResponse> =
+            shareContactCard(chatId, params, RequestOptions.none())
+
+        /** @see shareContactCard */
+        @MustBeClosed
+        fun shareContactCard(
+            params: ChatShareContactCardParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatShareContactCardResponse>
+
+        /** @see shareContactCard */
+        @MustBeClosed
+        fun shareContactCard(
+            params: ChatShareContactCardParams
+        ): HttpResponseFor<ChatShareContactCardResponse> =
+            shareContactCard(params, RequestOptions.none())
+
+        /** @see shareContactCard */
+        @MustBeClosed
+        fun shareContactCard(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatShareContactCardResponse> =
+            shareContactCard(chatId, ChatShareContactCardParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
new file mode 100644
index 0000000..9d5d510
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
@@ -0,0 +1,260 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.chats.ChatListParams
+import com.blooio.api.models.chats.ChatListResponse
+import com.blooio.api.models.chats.ChatMarkAsReadParams
+import com.blooio.api.models.chats.ChatMarkAsReadResponse
+import com.blooio.api.models.chats.ChatRetrieveParams
+import com.blooio.api.models.chats.ChatRetrieveResponse
+import com.blooio.api.models.chats.ChatShareContactCardParams
+import com.blooio.api.models.chats.ChatShareContactCardResponse
+import com.blooio.api.services.blocking.chats.BackgroundService
+import com.blooio.api.services.blocking.chats.BackgroundServiceImpl
+import com.blooio.api.services.blocking.chats.MessageService
+import com.blooio.api.services.blocking.chats.MessageServiceImpl
+import com.blooio.api.services.blocking.chats.PollService
+import com.blooio.api.services.blocking.chats.PollServiceImpl
+import com.blooio.api.services.blocking.chats.TypingService
+import com.blooio.api.services.blocking.chats.TypingServiceImpl
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class ChatServiceImpl internal constructor(private val clientOptions: ClientOptions) : ChatService {
+
+    private val withRawResponse: ChatService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val messages: MessageService by lazy { MessageServiceImpl(clientOptions) }
+
+    private val polls: PollService by lazy { PollServiceImpl(clientOptions) }
+
+    private val typing: TypingService by lazy { TypingServiceImpl(clientOptions) }
+
+    private val background: BackgroundService by lazy { BackgroundServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): ChatService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ChatService =
+        ChatServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun messages(): MessageService = messages
+
+    /**
+     * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+     * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+     * require webhook_type 'poll' or 'all'.
+     */
+    override fun polls(): PollService = polls
+
+    /** Control typing indicators for conversations */
+    override fun typing(): TypingService = typing
+
+    /** Set, get, and remove conversation backgrounds */
+    override fun background(): BackgroundService = background
+
+    override fun retrieve(
+        params: ChatRetrieveParams,
+        requestOptions: RequestOptions,
+    ): ChatRetrieveResponse =
+        // get /chats/{chatId}
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun list(params: ChatListParams, requestOptions: RequestOptions): ChatListResponse =
+        // get /chats
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun markAsRead(
+        params: ChatMarkAsReadParams,
+        requestOptions: RequestOptions,
+    ): ChatMarkAsReadResponse =
+        // post /chats/{chatId}/read
+        withRawResponse().markAsRead(params, requestOptions).parse()
+
+    override fun shareContactCard(
+        params: ChatShareContactCardParams,
+        requestOptions: RequestOptions,
+    ): ChatShareContactCardResponse =
+        // post /chats/{chatId}/contact-card
+        withRawResponse().shareContactCard(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ChatService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val messages: MessageService.WithRawResponse by lazy {
+            MessageServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val polls: PollService.WithRawResponse by lazy {
+            PollServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val typing: TypingService.WithRawResponse by lazy {
+            TypingServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val background: BackgroundService.WithRawResponse by lazy {
+            BackgroundServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ChatService.WithRawResponse =
+            ChatServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        override fun messages(): MessageService.WithRawResponse = messages
+
+        /**
+         * Send native iMessage polls and retrieve poll results with vote counts. Poll events are
+         * delivered via separate webhook event types (poll.received, poll.created, poll.voted) and
+         * require webhook_type 'poll' or 'all'.
+         */
+        override fun polls(): PollService.WithRawResponse = polls
+
+        /** Control typing indicators for conversations */
+        override fun typing(): TypingService.WithRawResponse = typing
+
+        /** Set, get, and remove conversation backgrounds */
+        override fun background(): BackgroundService.WithRawResponse = background
+
+        private val retrieveHandler: Handler<ChatRetrieveResponse> =
+            jsonHandler<ChatRetrieveResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ChatRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatRetrieveResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val listHandler: Handler<ChatListResponse> =
+            jsonHandler<ChatListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ChatListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val markAsReadHandler: Handler<ChatMarkAsReadResponse> =
+            jsonHandler<ChatMarkAsReadResponse>(clientOptions.jsonMapper)
+
+        override fun markAsRead(
+            params: ChatMarkAsReadParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatMarkAsReadResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "read")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { markAsReadHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val shareContactCardHandler: Handler<ChatShareContactCardResponse> =
+            jsonHandler<ChatShareContactCardResponse>(clientOptions.jsonMapper)
+
+        override fun shareContactCard(
+            params: ChatShareContactCardParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatShareContactCardResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "contact-card")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { shareContactCardHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
deleted file mode 100644
index 23e0c52..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigServiceImpl.kt
+++ /dev/null
@@ -1,44 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.blocking.config.WebhookService
-import com.blooio.api.services.blocking.config.WebhookServiceImpl
-import java.util.function.Consumer
-
-class ConfigServiceImpl internal constructor(private val clientOptions: ClientOptions) :
-    ConfigService {
-
-    private val withRawResponse: ConfigService.WithRawResponse by lazy {
-        WithRawResponseImpl(clientOptions)
-    }
-
-    private val webhook: WebhookService by lazy { WebhookServiceImpl(clientOptions) }
-
-    override fun withRawResponse(): ConfigService.WithRawResponse = withRawResponse
-
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService =
-        ConfigServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
-
-    /** Account-level configuration */
-    override fun webhook(): WebhookService = webhook
-
-    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        ConfigService.WithRawResponse {
-
-        private val webhook: WebhookService.WithRawResponse by lazy {
-            WebhookServiceImpl.WithRawResponseImpl(clientOptions)
-        }
-
-        override fun withOptions(
-            modifier: Consumer<ClientOptions.Builder>
-        ): ConfigService.WithRawResponse =
-            ConfigServiceImpl.WithRawResponseImpl(
-                clientOptions.toBuilder().apply(modifier::accept).build()
-            )
-
-        /** Account-level configuration */
-        override fun webhook(): WebhookService.WithRawResponse = webhook
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
index 5ccedcb..18675fe 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactService.kt
@@ -5,12 +5,21 @@ package com.blooio.api.services.blocking
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
 import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.contacts.Contact
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesParams
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactDeleteParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactListResponse
+import com.blooio.api.models.contacts.ContactRetrieveParams
+import com.blooio.api.models.contacts.ContactUpdateParams
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.services.blocking.contacts.TagService
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
-/** Contact-related operations */
+/** Manage contacts (phone numbers and emails) */
 interface ContactService {
 
     /**
@@ -25,26 +34,140 @@ interface ContactService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService
 
-    /**
-     * Check if a phone number or email address supports iMessage, SMS, RCS, and other messaging
-     * capabilities.
-     */
-    fun checkCapabilities(contact: String): ContactCheckCapabilitiesResponse =
-        checkCapabilities(contact, ContactCheckCapabilitiesParams.none())
+    /** Manage contacts (phone numbers and emails) */
+    fun tags(): TagService
+
+    /** Create a new contact with a phone number (E.164 format) or email address. */
+    fun create(params: ContactCreateParams): Contact = create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: ContactCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Contact
+
+    /** Get details for a specific contact by phone number or email. */
+    fun retrieve(contactId: String): Contact = retrieve(contactId, ContactRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        contactId: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Contact = retrieve(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        contactId: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+    ): Contact = retrieve(contactId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Contact
+
+    /** @see retrieve */
+    fun retrieve(params: ContactRetrieveParams): Contact = retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(contactId: String, requestOptions: RequestOptions): Contact =
+        retrieve(contactId, ContactRetrieveParams.none(), requestOptions)
+
+    /** Update a contact's name. */
+    fun update(contactId: String): Contact = update(contactId, ContactUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        contactId: String,
+        params: ContactUpdateParams = ContactUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Contact = update(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        contactId: String,
+        params: ContactUpdateParams = ContactUpdateParams.none(),
+    ): Contact = update(contactId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: ContactUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Contact
+
+    /** @see update */
+    fun update(params: ContactUpdateParams): Contact = update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(contactId: String, requestOptions: RequestOptions): Contact =
+        update(contactId, ContactUpdateParams.none(), requestOptions)
+
+    /** List all contacts for the organization with optional search and pagination. */
+    fun list(): ContactListResponse = list(ContactListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactListResponse
+
+    /** @see list */
+    fun list(params: ContactListParams = ContactListParams.none()): ContactListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): ContactListResponse =
+        list(ContactListParams.none(), requestOptions)
+
+    /** Soft-delete a contact. */
+    fun delete(contactId: String): DeleteResponse = delete(contactId, ContactDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        contactId: String,
+        params: ContactDeleteParams = ContactDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): DeleteResponse = delete(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        contactId: String,
+        params: ContactDeleteParams = ContactDeleteParams.none(),
+    ): DeleteResponse = delete(contactId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: ContactDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): DeleteResponse
+
+    /** @see delete */
+    fun delete(params: ContactDeleteParams): DeleteResponse = delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(contactId: String, requestOptions: RequestOptions): DeleteResponse =
+        delete(contactId, ContactDeleteParams.none(), requestOptions)
+
+    /** Check if a contact supports iMessage and/or SMS. */
+    fun checkCapabilities(contactId: String): ContactCheckCapabilitiesResponse =
+        checkCapabilities(contactId, ContactCheckCapabilitiesParams.none())
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
         requestOptions: RequestOptions = RequestOptions.none(),
     ): ContactCheckCapabilitiesResponse =
-        checkCapabilities(params.toBuilder().contact(contact).build(), requestOptions)
+        checkCapabilities(params.toBuilder().contactId(contactId).build(), requestOptions)
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
-    ): ContactCheckCapabilitiesResponse = checkCapabilities(contact, params, RequestOptions.none())
+    ): ContactCheckCapabilitiesResponse =
+        checkCapabilities(contactId, params, RequestOptions.none())
 
     /** @see checkCapabilities */
     fun checkCapabilities(
@@ -59,10 +182,10 @@ interface ContactService {
 
     /** @see checkCapabilities */
     fun checkCapabilities(
-        contact: String,
+        contactId: String,
         requestOptions: RequestOptions,
     ): ContactCheckCapabilitiesResponse =
-        checkCapabilities(contact, ContactCheckCapabilitiesParams.none(), requestOptions)
+        checkCapabilities(contactId, ContactCheckCapabilitiesParams.none(), requestOptions)
 
     /** A view of [ContactService] that provides access to raw HTTP responses for each method. */
     interface WithRawResponse {
@@ -74,30 +197,201 @@ interface ContactService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService.WithRawResponse
 
+        /** Manage contacts (phone numbers and emails) */
+        fun tags(): TagService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /contacts`, but is otherwise the same as
+         * [ContactService.create].
+         */
+        @MustBeClosed
+        fun create(params: ContactCreateParams): HttpResponseFor<Contact> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: ContactCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Contact>
+
+        /**
+         * Returns a raw HTTP response for `get /contacts/{contactId}`, but is otherwise the same as
+         * [ContactService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(contactId: String): HttpResponseFor<Contact> =
+            retrieve(contactId, ContactRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            contactId: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Contact> =
+            retrieve(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            contactId: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        ): HttpResponseFor<Contact> = retrieve(contactId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Contact>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: ContactRetrieveParams): HttpResponseFor<Contact> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(contactId: String, requestOptions: RequestOptions): HttpResponseFor<Contact> =
+            retrieve(contactId, ContactRetrieveParams.none(), requestOptions)
+
         /**
-         * Returns a raw HTTP response for `get /v1/api/contacts/{contact}/capabilities`, but is
+         * Returns a raw HTTP response for `patch /contacts/{contactId}`, but is otherwise the same
+         * as [ContactService.update].
+         */
+        @MustBeClosed
+        fun update(contactId: String): HttpResponseFor<Contact> =
+            update(contactId, ContactUpdateParams.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            contactId: String,
+            params: ContactUpdateParams = ContactUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Contact> =
+            update(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            contactId: String,
+            params: ContactUpdateParams = ContactUpdateParams.none(),
+        ): HttpResponseFor<Contact> = update(contactId, params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            params: ContactUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Contact>
+
+        /** @see update */
+        @MustBeClosed
+        fun update(params: ContactUpdateParams): HttpResponseFor<Contact> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(contactId: String, requestOptions: RequestOptions): HttpResponseFor<Contact> =
+            update(contactId, ContactUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /contacts`, but is otherwise the same as
+         * [ContactService.list].
+         */
+        @MustBeClosed
+        fun list(): HttpResponseFor<ContactListResponse> = list(ContactListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ContactListParams = ContactListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ContactListParams = ContactListParams.none()
+        ): HttpResponseFor<ContactListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<ContactListResponse> =
+            list(ContactListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /contacts/{contactId}`, but is otherwise the same
+         * as [ContactService.delete].
+         */
+        @MustBeClosed
+        fun delete(contactId: String): HttpResponseFor<DeleteResponse> =
+            delete(contactId, ContactDeleteParams.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            contactId: String,
+            params: ContactDeleteParams = ContactDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<DeleteResponse> =
+            delete(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            contactId: String,
+            params: ContactDeleteParams = ContactDeleteParams.none(),
+        ): HttpResponseFor<DeleteResponse> = delete(contactId, params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            params: ContactDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<DeleteResponse>
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(params: ContactDeleteParams): HttpResponseFor<DeleteResponse> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<DeleteResponse> =
+            delete(contactId, ContactDeleteParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /contacts/{contactId}/capabilities`, but is
          * otherwise the same as [ContactService.checkCapabilities].
          */
         @MustBeClosed
-        fun checkCapabilities(contact: String): HttpResponseFor<ContactCheckCapabilitiesResponse> =
-            checkCapabilities(contact, ContactCheckCapabilitiesParams.none())
+        fun checkCapabilities(
+            contactId: String
+        ): HttpResponseFor<ContactCheckCapabilitiesResponse> =
+            checkCapabilities(contactId, ContactCheckCapabilitiesParams.none())
 
         /** @see checkCapabilities */
         @MustBeClosed
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<ContactCheckCapabilitiesResponse> =
-            checkCapabilities(params.toBuilder().contact(contact).build(), requestOptions)
+            checkCapabilities(params.toBuilder().contactId(contactId).build(), requestOptions)
 
         /** @see checkCapabilities */
         @MustBeClosed
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             params: ContactCheckCapabilitiesParams = ContactCheckCapabilitiesParams.none(),
         ): HttpResponseFor<ContactCheckCapabilitiesResponse> =
-            checkCapabilities(contact, params, RequestOptions.none())
+            checkCapabilities(contactId, params, RequestOptions.none())
 
         /** @see checkCapabilities */
         @MustBeClosed
@@ -116,9 +410,9 @@ interface ContactService {
         /** @see checkCapabilities */
         @MustBeClosed
         fun checkCapabilities(
-            contact: String,
+            contactId: String,
             requestOptions: RequestOptions,
         ): HttpResponseFor<ContactCheckCapabilitiesResponse> =
-            checkCapabilities(contact, ContactCheckCapabilitiesParams.none(), requestOptions)
+            checkCapabilities(contactId, ContactCheckCapabilitiesParams.none(), requestOptions)
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
index 8ddffc6..672d191 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ContactServiceImpl.kt
@@ -13,14 +13,25 @@ import com.blooio.api.core.http.HttpRequest
 import com.blooio.api.core.http.HttpResponse
 import com.blooio.api.core.http.HttpResponse.Handler
 import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepare
+import com.blooio.api.models.contacts.Contact
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesParams
 import com.blooio.api.models.contacts.ContactCheckCapabilitiesResponse
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactDeleteParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactListResponse
+import com.blooio.api.models.contacts.ContactRetrieveParams
+import com.blooio.api.models.contacts.ContactUpdateParams
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.services.blocking.contacts.TagService
+import com.blooio.api.services.blocking.contacts.TagServiceImpl
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Contact-related operations */
+/** Manage contacts (phone numbers and emails) */
 class ContactServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     ContactService {
 
@@ -28,16 +39,47 @@ class ContactServiceImpl internal constructor(private val clientOptions: ClientO
         WithRawResponseImpl(clientOptions)
     }
 
+    private val tags: TagService by lazy { TagServiceImpl(clientOptions) }
+
     override fun withRawResponse(): ContactService.WithRawResponse = withRawResponse
 
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService =
         ContactServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Manage contacts (phone numbers and emails) */
+    override fun tags(): TagService = tags
+
+    override fun create(params: ContactCreateParams, requestOptions: RequestOptions): Contact =
+        // post /contacts
+        withRawResponse().create(params, requestOptions).parse()
+
+    override fun retrieve(params: ContactRetrieveParams, requestOptions: RequestOptions): Contact =
+        // get /contacts/{contactId}
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun update(params: ContactUpdateParams, requestOptions: RequestOptions): Contact =
+        // patch /contacts/{contactId}
+        withRawResponse().update(params, requestOptions).parse()
+
+    override fun list(
+        params: ContactListParams,
+        requestOptions: RequestOptions,
+    ): ContactListResponse =
+        // get /contacts
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun delete(
+        params: ContactDeleteParams,
+        requestOptions: RequestOptions,
+    ): DeleteResponse =
+        // delete /contacts/{contactId}
+        withRawResponse().delete(params, requestOptions).parse()
+
     override fun checkCapabilities(
         params: ContactCheckCapabilitiesParams,
         requestOptions: RequestOptions,
     ): ContactCheckCapabilitiesResponse =
-        // get /v1/api/contacts/{contact}/capabilities
+        // get /contacts/{contactId}/capabilities
         withRawResponse().checkCapabilities(params, requestOptions).parse()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -46,6 +88,10 @@ class ContactServiceImpl internal constructor(private val clientOptions: ClientO
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
+        private val tags: TagService.WithRawResponse by lazy {
+            TagServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): ContactService.WithRawResponse =
@@ -53,6 +99,154 @@ class ContactServiceImpl internal constructor(private val clientOptions: ClientO
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Manage contacts (phone numbers and emails) */
+        override fun tags(): TagService.WithRawResponse = tags
+
+        private val createHandler: Handler<Contact> = jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: ContactCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Contact> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { createHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val retrieveHandler: Handler<Contact> =
+            jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Contact> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val updateHandler: Handler<Contact> = jsonHandler<Contact>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: ContactUpdateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Contact> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { updateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val listHandler: Handler<ContactListResponse> =
+            jsonHandler<ContactListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ContactListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val deleteHandler: Handler<DeleteResponse> =
+            jsonHandler<DeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: ContactDeleteParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<DeleteResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { deleteHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
         private val checkCapabilitiesHandler: Handler<ContactCheckCapabilitiesResponse> =
             jsonHandler<ContactCheckCapabilitiesResponse>(clientOptions.jsonMapper)
 
@@ -62,12 +256,12 @@ class ContactServiceImpl internal constructor(private val clientOptions: ClientO
         ): HttpResponseFor<ContactCheckCapabilitiesResponse> {
             // We check here instead of in the params builder because this can be specified
             // positionally or in the params class.
-            checkRequired("contact", params.contact().getOrNull())
+            checkRequired("contactId", params.contactId().getOrNull())
             val request =
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "contacts", params._pathParam(0), "capabilities")
+                    .addPathSegments("contacts", params._pathParam(0), "capabilities")
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeService.kt
new file mode 100644
index 0000000..ef67d1d
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeService.kt
@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import com.blooio.api.models.facetime.FacetimeInitiateCallResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Initiate FaceTime calls */
+interface FacetimeService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): FacetimeService
+
+    /**
+     * **Coming Soon** -- This endpoint is temporarily disabled while we stabilize the FaceTime call
+     * flow.
+     *
+     * Initiates a FaceTime call to the specified phone number or email address. Returns a shareable
+     * FaceTime link that anyone can use to join the call. The call will ring the contact and
+     * auto-admit the first person who joins via the link.
+     */
+    fun initiateCall(params: FacetimeInitiateCallParams): FacetimeInitiateCallResponse =
+        initiateCall(params, RequestOptions.none())
+
+    /** @see initiateCall */
+    fun initiateCall(
+        params: FacetimeInitiateCallParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): FacetimeInitiateCallResponse
+
+    /** A view of [FacetimeService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): FacetimeService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /facetime/calls`, but is otherwise the same as
+         * [FacetimeService.initiateCall].
+         */
+        @MustBeClosed
+        fun initiateCall(
+            params: FacetimeInitiateCallParams
+        ): HttpResponseFor<FacetimeInitiateCallResponse> =
+            initiateCall(params, RequestOptions.none())
+
+        /** @see initiateCall */
+        @MustBeClosed
+        fun initiateCall(
+            params: FacetimeInitiateCallParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<FacetimeInitiateCallResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeServiceImpl.kt
new file mode 100644
index 0000000..4b85ff1
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/FacetimeServiceImpl.kt
@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import com.blooio.api.models.facetime.FacetimeInitiateCallResponse
+import java.util.function.Consumer
+
+/** Initiate FaceTime calls */
+class FacetimeServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    FacetimeService {
+
+    private val withRawResponse: FacetimeService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): FacetimeService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): FacetimeService =
+        FacetimeServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun initiateCall(
+        params: FacetimeInitiateCallParams,
+        requestOptions: RequestOptions,
+    ): FacetimeInitiateCallResponse =
+        // post /facetime/calls
+        withRawResponse().initiateCall(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        FacetimeService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): FacetimeService.WithRawResponse =
+            FacetimeServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val initiateCallHandler: Handler<FacetimeInitiateCallResponse> =
+            jsonHandler<FacetimeInitiateCallResponse>(clientOptions.jsonMapper)
+
+        override fun initiateCall(
+            params: FacetimeInitiateCallParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<FacetimeInitiateCallResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("facetime", "calls")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { initiateCallHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupService.kt
new file mode 100644
index 0000000..e033acf
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupService.kt
@@ -0,0 +1,360 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.Group
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupCreateResponse
+import com.blooio.api.models.groups.GroupDeleteParams
+import com.blooio.api.models.groups.GroupDeleteResponse
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupListResponse
+import com.blooio.api.models.groups.GroupRetrieveParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import com.blooio.api.models.groups.GroupUpdateResponse
+import com.blooio.api.services.blocking.groups.IconService
+import com.blooio.api.services.blocking.groups.MemberService
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage contact groups */
+interface GroupService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): GroupService
+
+    /** Manage group membership */
+    fun members(): MemberService
+
+    /** Manage contact groups */
+    fun icon(): IconService
+
+    /**
+     * Create a new group. There are two modes:
+     *
+     * **1. Link to existing iMessage chat:** Provide `chat_guid` to join an existing group chat
+     * that was created outside the API. The `members` list records who is in the group but does NOT
+     * add them to the linked iMessage chat. Multiple groups can have the same participants if they
+     * have different `chat_guid`s.
+     *
+     * **2. Create new group:** Omit `chat_guid` to create a new group. When you send the first
+     * message, a new iMessage chat will be created. Note: iMessage only allows one chat per unique
+     * participant set when created via API.
+     */
+    fun create(params: GroupCreateParams): GroupCreateResponse =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: GroupCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupCreateResponse
+
+    /** Get details for a specific group. */
+    fun retrieve(groupId: String): Group = retrieve(groupId, GroupRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        groupId: String,
+        params: GroupRetrieveParams = GroupRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Group = retrieve(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(groupId: String, params: GroupRetrieveParams = GroupRetrieveParams.none()): Group =
+        retrieve(groupId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: GroupRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Group
+
+    /** @see retrieve */
+    fun retrieve(params: GroupRetrieveParams): Group = retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(groupId: String, requestOptions: RequestOptions): Group =
+        retrieve(groupId, GroupRetrieveParams.none(), requestOptions)
+
+    /**
+     * Update a group's name. If the group has a linked `chat_guid`, the display name will also be
+     * updated in the linked iMessage chat. Note: iMessage only allows one chat per unique
+     * participant set, so renaming simply changes the display name on the existing chat thread.
+     */
+    fun update(groupId: String): GroupUpdateResponse = update(groupId, GroupUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        groupId: String,
+        params: GroupUpdateParams = GroupUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupUpdateResponse = update(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        groupId: String,
+        params: GroupUpdateParams = GroupUpdateParams.none(),
+    ): GroupUpdateResponse = update(groupId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: GroupUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupUpdateResponse
+
+    /** @see update */
+    fun update(params: GroupUpdateParams): GroupUpdateResponse =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(groupId: String, requestOptions: RequestOptions): GroupUpdateResponse =
+        update(groupId, GroupUpdateParams.none(), requestOptions)
+
+    /** List all groups for the organization with optional search and pagination. */
+    fun list(): GroupListResponse = list(GroupListParams.none())
+
+    /** @see list */
+    fun list(
+        params: GroupListParams = GroupListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupListResponse
+
+    /** @see list */
+    fun list(params: GroupListParams = GroupListParams.none()): GroupListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): GroupListResponse =
+        list(GroupListParams.none(), requestOptions)
+
+    /**
+     * Soft-delete a group. Members are automatically removed. If the group is linked to an existing
+     * iMessage chat, the number also leaves that chat.
+     */
+    fun delete(groupId: String): GroupDeleteResponse = delete(groupId, GroupDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        groupId: String,
+        params: GroupDeleteParams = GroupDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupDeleteResponse = delete(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        groupId: String,
+        params: GroupDeleteParams = GroupDeleteParams.none(),
+    ): GroupDeleteResponse = delete(groupId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: GroupDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupDeleteResponse
+
+    /** @see delete */
+    fun delete(params: GroupDeleteParams): GroupDeleteResponse =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(groupId: String, requestOptions: RequestOptions): GroupDeleteResponse =
+        delete(groupId, GroupDeleteParams.none(), requestOptions)
+
+    /** A view of [GroupService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): GroupService.WithRawResponse
+
+        /** Manage group membership */
+        fun members(): MemberService.WithRawResponse
+
+        /** Manage contact groups */
+        fun icon(): IconService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /groups`, but is otherwise the same as
+         * [GroupService.create].
+         */
+        @MustBeClosed
+        fun create(params: GroupCreateParams): HttpResponseFor<GroupCreateResponse> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: GroupCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupCreateResponse>
+
+        /**
+         * Returns a raw HTTP response for `get /groups/{groupId}`, but is otherwise the same as
+         * [GroupService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(groupId: String): HttpResponseFor<Group> =
+            retrieve(groupId, GroupRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            groupId: String,
+            params: GroupRetrieveParams = GroupRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Group> =
+            retrieve(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            groupId: String,
+            params: GroupRetrieveParams = GroupRetrieveParams.none(),
+        ): HttpResponseFor<Group> = retrieve(groupId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: GroupRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Group>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: GroupRetrieveParams): HttpResponseFor<Group> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(groupId: String, requestOptions: RequestOptions): HttpResponseFor<Group> =
+            retrieve(groupId, GroupRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `patch /groups/{groupId}`, but is otherwise the same as
+         * [GroupService.update].
+         */
+        @MustBeClosed
+        fun update(groupId: String): HttpResponseFor<GroupUpdateResponse> =
+            update(groupId, GroupUpdateParams.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            groupId: String,
+            params: GroupUpdateParams = GroupUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupUpdateResponse> =
+            update(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            groupId: String,
+            params: GroupUpdateParams = GroupUpdateParams.none(),
+        ): HttpResponseFor<GroupUpdateResponse> = update(groupId, params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            params: GroupUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupUpdateResponse>
+
+        /** @see update */
+        @MustBeClosed
+        fun update(params: GroupUpdateParams): HttpResponseFor<GroupUpdateResponse> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupUpdateResponse> =
+            update(groupId, GroupUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /groups`, but is otherwise the same as
+         * [GroupService.list].
+         */
+        @MustBeClosed fun list(): HttpResponseFor<GroupListResponse> = list(GroupListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: GroupListParams = GroupListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: GroupListParams = GroupListParams.none()
+        ): HttpResponseFor<GroupListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<GroupListResponse> =
+            list(GroupListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}`, but is otherwise the same as
+         * [GroupService.delete].
+         */
+        @MustBeClosed
+        fun delete(groupId: String): HttpResponseFor<GroupDeleteResponse> =
+            delete(groupId, GroupDeleteParams.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            groupId: String,
+            params: GroupDeleteParams = GroupDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupDeleteResponse> =
+            delete(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            groupId: String,
+            params: GroupDeleteParams = GroupDeleteParams.none(),
+        ): HttpResponseFor<GroupDeleteResponse> = delete(groupId, params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            params: GroupDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupDeleteResponse>
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(params: GroupDeleteParams): HttpResponseFor<GroupDeleteResponse> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupDeleteResponse> =
+            delete(groupId, GroupDeleteParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupServiceImpl.kt
new file mode 100644
index 0000000..fe2f47b
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/GroupServiceImpl.kt
@@ -0,0 +1,261 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.groups.Group
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupCreateResponse
+import com.blooio.api.models.groups.GroupDeleteParams
+import com.blooio.api.models.groups.GroupDeleteResponse
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupListResponse
+import com.blooio.api.models.groups.GroupRetrieveParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import com.blooio.api.models.groups.GroupUpdateResponse
+import com.blooio.api.services.blocking.groups.IconService
+import com.blooio.api.services.blocking.groups.IconServiceImpl
+import com.blooio.api.services.blocking.groups.MemberService
+import com.blooio.api.services.blocking.groups.MemberServiceImpl
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contact groups */
+class GroupServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    GroupService {
+
+    private val withRawResponse: GroupService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val members: MemberService by lazy { MemberServiceImpl(clientOptions) }
+
+    private val icon: IconService by lazy { IconServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): GroupService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): GroupService =
+        GroupServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage group membership */
+    override fun members(): MemberService = members
+
+    /** Manage contact groups */
+    override fun icon(): IconService = icon
+
+    override fun create(
+        params: GroupCreateParams,
+        requestOptions: RequestOptions,
+    ): GroupCreateResponse =
+        // post /groups
+        withRawResponse().create(params, requestOptions).parse()
+
+    override fun retrieve(params: GroupRetrieveParams, requestOptions: RequestOptions): Group =
+        // get /groups/{groupId}
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun update(
+        params: GroupUpdateParams,
+        requestOptions: RequestOptions,
+    ): GroupUpdateResponse =
+        // patch /groups/{groupId}
+        withRawResponse().update(params, requestOptions).parse()
+
+    override fun list(params: GroupListParams, requestOptions: RequestOptions): GroupListResponse =
+        // get /groups
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun delete(
+        params: GroupDeleteParams,
+        requestOptions: RequestOptions,
+    ): GroupDeleteResponse =
+        // delete /groups/{groupId}
+        withRawResponse().delete(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        GroupService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val members: MemberService.WithRawResponse by lazy {
+            MemberServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val icon: IconService.WithRawResponse by lazy {
+            IconServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): GroupService.WithRawResponse =
+            GroupServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage group membership */
+        override fun members(): MemberService.WithRawResponse = members
+
+        /** Manage contact groups */
+        override fun icon(): IconService.WithRawResponse = icon
+
+        private val createHandler: Handler<GroupCreateResponse> =
+            jsonHandler<GroupCreateResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: GroupCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupCreateResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { createHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val retrieveHandler: Handler<Group> = jsonHandler<Group>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: GroupRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Group> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val updateHandler: Handler<GroupUpdateResponse> =
+            jsonHandler<GroupUpdateResponse>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: GroupUpdateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupUpdateResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { updateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val listHandler: Handler<GroupListResponse> =
+            jsonHandler<GroupListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: GroupListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val deleteHandler: Handler<GroupDeleteResponse> =
+            jsonHandler<GroupDeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: GroupDeleteParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupDeleteResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { deleteHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationService.kt
similarity index 66%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationService.kt
index e0a612c..b1b4b2b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ConfigService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationService.kt
@@ -3,10 +3,10 @@
 package com.blooio.api.services.blocking
 
 import com.blooio.api.core.ClientOptions
-import com.blooio.api.services.blocking.config.WebhookService
+import com.blooio.api.services.blocking.location.ContactService
 import java.util.function.Consumer
 
-interface ConfigService {
+interface LocationService {
 
     /**
      * Returns a view of this service that provides access to raw HTTP responses for each method.
@@ -18,12 +18,12 @@ interface ConfigService {
      *
      * The original service is not modified.
      */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LocationService
 
-    /** Account-level configuration */
-    fun webhook(): WebhookService
+    /** FindMy contact location tracking */
+    fun contacts(): ContactService
 
-    /** A view of [ConfigService] that provides access to raw HTTP responses for each method. */
+    /** A view of [LocationService] that provides access to raw HTTP responses for each method. */
     interface WithRawResponse {
 
         /**
@@ -31,9 +31,9 @@ interface ConfigService {
          *
          * The original service is not modified.
          */
-        fun withOptions(modifier: Consumer<ClientOptions.Builder>): ConfigService.WithRawResponse
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): LocationService.WithRawResponse
 
-        /** Account-level configuration */
-        fun webhook(): WebhookService.WithRawResponse
+        /** FindMy contact location tracking */
+        fun contacts(): ContactService.WithRawResponse
     }
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationServiceImpl.kt
new file mode 100644
index 0000000..777290a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/LocationServiceImpl.kt
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.services.blocking.location.ContactService
+import com.blooio.api.services.blocking.location.ContactServiceImpl
+import java.util.function.Consumer
+
+class LocationServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    LocationService {
+
+    private val withRawResponse: LocationService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val contacts: ContactService by lazy { ContactServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): LocationService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LocationService =
+        LocationServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** FindMy contact location tracking */
+    override fun contacts(): ContactService = contacts
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        LocationService.WithRawResponse {
+
+        private val contacts: ContactService.WithRawResponse by lazy {
+            ContactServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): LocationService.WithRawResponse =
+            LocationServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** FindMy contact location tracking */
+        override fun contacts(): ContactService.WithRawResponse = contacts
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
index a1b2172..75f98e9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeService.kt
@@ -7,10 +7,11 @@ import com.blooio.api.core.RequestOptions
 import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.models.me.MeRetrieveParams
 import com.blooio.api.models.me.MeRetrieveResponse
+import com.blooio.api.services.blocking.me.NumberService
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
-/** Account and API key information */
+/** Authentication and account information */
 interface MeService {
 
     /**
@@ -25,9 +26,12 @@ interface MeService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeService
 
+    /** Manage phone numbers linked to your account */
+    fun numbers(): NumberService
+
     /**
-     * Returns information about the authenticated API key including plan, devices, usage
-     * statistics, and integration details.
+     * Returns details about the authenticated API key or dashboard user, including organization
+     * info, devices, and usage statistics.
      */
     fun retrieve(): MeRetrieveResponse = retrieve(MeRetrieveParams.none())
 
@@ -55,8 +59,11 @@ interface MeService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeService.WithRawResponse
 
+        /** Manage phone numbers linked to your account */
+        fun numbers(): NumberService.WithRawResponse
+
         /**
-         * Returns a raw HTTP response for `get /v1/api/me`, but is otherwise the same as
+         * Returns a raw HTTP response for `get /me`, but is otherwise the same as
          * [MeService.retrieve].
          */
         @MustBeClosed
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
index 5776732..48e6688 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MeServiceImpl.kt
@@ -16,25 +16,32 @@ import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepare
 import com.blooio.api.models.me.MeRetrieveParams
 import com.blooio.api.models.me.MeRetrieveResponse
+import com.blooio.api.services.blocking.me.NumberService
+import com.blooio.api.services.blocking.me.NumberServiceImpl
 import java.util.function.Consumer
 
-/** Account and API key information */
+/** Authentication and account information */
 class MeServiceImpl internal constructor(private val clientOptions: ClientOptions) : MeService {
 
     private val withRawResponse: MeService.WithRawResponse by lazy {
         WithRawResponseImpl(clientOptions)
     }
 
+    private val numbers: NumberService by lazy { NumberServiceImpl(clientOptions) }
+
     override fun withRawResponse(): MeService.WithRawResponse = withRawResponse
 
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): MeService =
         MeServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    /** Manage phone numbers linked to your account */
+    override fun numbers(): NumberService = numbers
+
     override fun retrieve(
         params: MeRetrieveParams,
         requestOptions: RequestOptions,
     ): MeRetrieveResponse =
-        // get /v1/api/me
+        // get /me
         withRawResponse().retrieve(params, requestOptions).parse()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -43,6 +50,10 @@ class MeServiceImpl internal constructor(private val clientOptions: ClientOption
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
+        private val numbers: NumberService.WithRawResponse by lazy {
+            NumberServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
         ): MeService.WithRawResponse =
@@ -50,6 +61,9 @@ class MeServiceImpl internal constructor(private val clientOptions: ClientOption
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        /** Manage phone numbers linked to your account */
+        override fun numbers(): NumberService.WithRawResponse = numbers
+
         private val retrieveHandler: Handler<MeRetrieveResponse> =
             jsonHandler<MeRetrieveResponse>(clientOptions.jsonMapper)
 
@@ -61,7 +75,7 @@ class MeServiceImpl internal constructor(private val clientOptions: ClientOption
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "me")
+                    .addPathSegments("me")
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
deleted file mode 100644
index 17012f1..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageService.kt
+++ /dev/null
@@ -1,312 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponseFor
-import com.blooio.api.models.messages.MessageCancelParams
-import com.blooio.api.models.messages.MessageCancelResponse
-import com.blooio.api.models.messages.MessageGetStatusParams
-import com.blooio.api.models.messages.MessageGetStatusResponse
-import com.blooio.api.models.messages.MessageRetrieveParams
-import com.blooio.api.models.messages.MessageRetrieveResponse
-import com.blooio.api.models.messages.MessageSendParams
-import com.blooio.api.models.messages.MessageSendResponse
-import com.google.errorprone.annotations.MustBeClosed
-import java.util.function.Consumer
-
-/** Send and manage individual messages */
-interface MessageService {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageService
-
-    /**
-     * Retrieve full message metadata including direction, protocol, text length, attachments count,
-     * timestamps, current status, and original metadata.
-     */
-    fun retrieve(messageId: String): MessageRetrieveResponse =
-        retrieve(messageId, MessageRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        messageId: String,
-        params: MessageRetrieveParams = MessageRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageRetrieveResponse =
-        retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see retrieve */
-    fun retrieve(
-        messageId: String,
-        params: MessageRetrieveParams = MessageRetrieveParams.none(),
-    ): MessageRetrieveResponse = retrieve(messageId, params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: MessageRetrieveParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageRetrieveResponse
-
-    /** @see retrieve */
-    fun retrieve(params: MessageRetrieveParams): MessageRetrieveResponse =
-        retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(messageId: String, requestOptions: RequestOptions): MessageRetrieveResponse =
-        retrieve(messageId, MessageRetrieveParams.none(), requestOptions)
-
-    /**
-     * Request cancellation for a queued or scheduled message. If the message is already in a
-     * non-cancellable state (e.g., sent), the response indicates the current status. Note: response
-     * may include deprecated `current_status`; use `status` instead.
-     */
-    fun cancel(messageId: String): MessageCancelResponse =
-        cancel(messageId, MessageCancelParams.none())
-
-    /** @see cancel */
-    fun cancel(
-        messageId: String,
-        params: MessageCancelParams = MessageCancelParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageCancelResponse =
-        cancel(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see cancel */
-    fun cancel(
-        messageId: String,
-        params: MessageCancelParams = MessageCancelParams.none(),
-    ): MessageCancelResponse = cancel(messageId, params, RequestOptions.none())
-
-    /** @see cancel */
-    fun cancel(
-        params: MessageCancelParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageCancelResponse
-
-    /** @see cancel */
-    fun cancel(params: MessageCancelParams): MessageCancelResponse =
-        cancel(params, RequestOptions.none())
-
-    /** @see cancel */
-    fun cancel(messageId: String, requestOptions: RequestOptions): MessageCancelResponse =
-        cancel(messageId, MessageCancelParams.none(), requestOptions)
-
-    /** Get current delivery status only */
-    fun getStatus(messageId: String): MessageGetStatusResponse =
-        getStatus(messageId, MessageGetStatusParams.none())
-
-    /** @see getStatus */
-    fun getStatus(
-        messageId: String,
-        params: MessageGetStatusParams = MessageGetStatusParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageGetStatusResponse =
-        getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-    /** @see getStatus */
-    fun getStatus(
-        messageId: String,
-        params: MessageGetStatusParams = MessageGetStatusParams.none(),
-    ): MessageGetStatusResponse = getStatus(messageId, params, RequestOptions.none())
-
-    /** @see getStatus */
-    fun getStatus(
-        params: MessageGetStatusParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageGetStatusResponse
-
-    /** @see getStatus */
-    fun getStatus(params: MessageGetStatusParams): MessageGetStatusResponse =
-        getStatus(params, RequestOptions.none())
-
-    /** @see getStatus */
-    fun getStatus(messageId: String, requestOptions: RequestOptions): MessageGetStatusResponse =
-        getStatus(messageId, MessageGetStatusParams.none(), requestOptions)
-
-    /**
-     * Queues an outbound iMessage/SMS to the specified phone number.
-     *
-     * Supports optional media attachments via public URLs, and arbitrary metadata for correlation.
-     *
-     * For safe retries, provide an `Idempotency-Key` header. If the same key is used twice, the
-     * original message will be returned with 200; otherwise a new message is queued with 202.
-     */
-    fun send(params: MessageSendParams): MessageSendResponse = send(params, RequestOptions.none())
-
-    /** @see send */
-    fun send(
-        params: MessageSendParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): MessageSendResponse
-
-    /** A view of [MessageService] that provides access to raw HTTP responses for each method. */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageService.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/messages/{messageId}`, but is otherwise the
-         * same as [MessageService.retrieve].
-         */
-        @MustBeClosed
-        fun retrieve(messageId: String): HttpResponseFor<MessageRetrieveResponse> =
-            retrieve(messageId, MessageRetrieveParams.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            messageId: String,
-            params: MessageRetrieveParams = MessageRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageRetrieveResponse> =
-            retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            messageId: String,
-            params: MessageRetrieveParams = MessageRetrieveParams.none(),
-        ): HttpResponseFor<MessageRetrieveResponse> =
-            retrieve(messageId, params, RequestOptions.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            params: MessageRetrieveParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageRetrieveResponse>
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(params: MessageRetrieveParams): HttpResponseFor<MessageRetrieveResponse> =
-            retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): HttpResponseFor<MessageRetrieveResponse> =
-            retrieve(messageId, MessageRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `delete /v1/api/messages/{messageId}`, but is otherwise
-         * the same as [MessageService.cancel].
-         */
-        @MustBeClosed
-        fun cancel(messageId: String): HttpResponseFor<MessageCancelResponse> =
-            cancel(messageId, MessageCancelParams.none())
-
-        /** @see cancel */
-        @MustBeClosed
-        fun cancel(
-            messageId: String,
-            params: MessageCancelParams = MessageCancelParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageCancelResponse> =
-            cancel(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see cancel */
-        @MustBeClosed
-        fun cancel(
-            messageId: String,
-            params: MessageCancelParams = MessageCancelParams.none(),
-        ): HttpResponseFor<MessageCancelResponse> = cancel(messageId, params, RequestOptions.none())
-
-        /** @see cancel */
-        @MustBeClosed
-        fun cancel(
-            params: MessageCancelParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageCancelResponse>
-
-        /** @see cancel */
-        @MustBeClosed
-        fun cancel(params: MessageCancelParams): HttpResponseFor<MessageCancelResponse> =
-            cancel(params, RequestOptions.none())
-
-        /** @see cancel */
-        @MustBeClosed
-        fun cancel(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): HttpResponseFor<MessageCancelResponse> =
-            cancel(messageId, MessageCancelParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/messages/{messageId}/status`, but is
-         * otherwise the same as [MessageService.getStatus].
-         */
-        @MustBeClosed
-        fun getStatus(messageId: String): HttpResponseFor<MessageGetStatusResponse> =
-            getStatus(messageId, MessageGetStatusParams.none())
-
-        /** @see getStatus */
-        @MustBeClosed
-        fun getStatus(
-            messageId: String,
-            params: MessageGetStatusParams = MessageGetStatusParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageGetStatusResponse> =
-            getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
-
-        /** @see getStatus */
-        @MustBeClosed
-        fun getStatus(
-            messageId: String,
-            params: MessageGetStatusParams = MessageGetStatusParams.none(),
-        ): HttpResponseFor<MessageGetStatusResponse> =
-            getStatus(messageId, params, RequestOptions.none())
-
-        /** @see getStatus */
-        @MustBeClosed
-        fun getStatus(
-            params: MessageGetStatusParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageGetStatusResponse>
-
-        /** @see getStatus */
-        @MustBeClosed
-        fun getStatus(params: MessageGetStatusParams): HttpResponseFor<MessageGetStatusResponse> =
-            getStatus(params, RequestOptions.none())
-
-        /** @see getStatus */
-        @MustBeClosed
-        fun getStatus(
-            messageId: String,
-            requestOptions: RequestOptions,
-        ): HttpResponseFor<MessageGetStatusResponse> =
-            getStatus(messageId, MessageGetStatusParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `post /v1/api/messages`, but is otherwise the same as
-         * [MessageService.send].
-         */
-        @MustBeClosed
-        fun send(params: MessageSendParams): HttpResponseFor<MessageSendResponse> =
-            send(params, RequestOptions.none())
-
-        /** @see send */
-        @MustBeClosed
-        fun send(
-            params: MessageSendParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<MessageSendResponse>
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberService.kt
new file mode 100644
index 0000000..d4e7c89
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberService.kt
@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateResponse
+import com.blooio.api.services.blocking.phonenumbers.LookupService
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+interface PhoneNumberService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): PhoneNumberService
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    fun lookup(): LookupService
+
+    /**
+     * Look up multiple phone numbers in a single request. Returns the same detailed information as
+     * the single lookup endpoint for each number. Maximum 100 numbers per request.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise).
+     */
+    fun batchCreate(params: PhoneNumberBatchCreateParams): PhoneNumberBatchCreateResponse =
+        batchCreate(params, RequestOptions.none())
+
+    /** @see batchCreate */
+    fun batchCreate(
+        params: PhoneNumberBatchCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PhoneNumberBatchCreateResponse
+
+    /**
+     * A view of [PhoneNumberService] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PhoneNumberService.WithRawResponse
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        fun lookup(): LookupService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /phone-numbers/batch`, but is otherwise the same as
+         * [PhoneNumberService.batchCreate].
+         */
+        @MustBeClosed
+        fun batchCreate(
+            params: PhoneNumberBatchCreateParams
+        ): HttpResponseFor<PhoneNumberBatchCreateResponse> =
+            batchCreate(params, RequestOptions.none())
+
+        /** @see batchCreate */
+        @MustBeClosed
+        fun batchCreate(
+            params: PhoneNumberBatchCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PhoneNumberBatchCreateResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceImpl.kt
new file mode 100644
index 0000000..5863a93
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceImpl.kt
@@ -0,0 +1,106 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateResponse
+import com.blooio.api.services.blocking.phonenumbers.LookupService
+import com.blooio.api.services.blocking.phonenumbers.LookupServiceImpl
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+class PhoneNumberServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    PhoneNumberService {
+
+    private val withRawResponse: PhoneNumberService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val lookup: LookupService by lazy { LookupServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): PhoneNumberService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): PhoneNumberService =
+        PhoneNumberServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /**
+     * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+     * (Dedicated Enterprise).
+     */
+    override fun lookup(): LookupService = lookup
+
+    override fun batchCreate(
+        params: PhoneNumberBatchCreateParams,
+        requestOptions: RequestOptions,
+    ): PhoneNumberBatchCreateResponse =
+        // post /phone-numbers/batch
+        withRawResponse().batchCreate(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        PhoneNumberService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val lookup: LookupService.WithRawResponse by lazy {
+            LookupServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PhoneNumberService.WithRawResponse =
+            PhoneNumberServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /**
+         * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan
+         * (Dedicated Enterprise).
+         */
+        override fun lookup(): LookupService.WithRawResponse = lookup
+
+        private val batchCreateHandler: Handler<PhoneNumberBatchCreateResponse> =
+            jsonHandler<PhoneNumberBatchCreateResponse>(clientOptions.jsonMapper)
+
+        override fun batchCreate(
+            params: PhoneNumberBatchCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<PhoneNumberBatchCreateResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("phone-numbers", "batch")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { batchCreateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookService.kt
new file mode 100644
index 0000000..be2818c
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookService.kt
@@ -0,0 +1,342 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.Webhook
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookCreateResponse
+import com.blooio.api.models.webhooks.WebhookDeleteParams
+import com.blooio.api.models.webhooks.WebhookDeleteResponse
+import com.blooio.api.models.webhooks.WebhookListParams
+import com.blooio.api.models.webhooks.WebhookListResponse
+import com.blooio.api.models.webhooks.WebhookRetrieveParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import com.blooio.api.services.blocking.webhooks.LogService
+import com.blooio.api.services.blocking.webhooks.SecretService
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage webhook subscriptions */
+interface WebhookService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService
+
+    /** Manage webhook subscriptions */
+    fun secret(): SecretService
+
+    /** View and replay webhook deliveries */
+    fun logs(): LogService
+
+    /** Create a new webhook subscription. */
+    fun create(params: WebhookCreateParams): WebhookCreateResponse =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: WebhookCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): WebhookCreateResponse
+
+    /** Get details for a specific webhook. */
+    fun retrieve(webhookId: String): Webhook = retrieve(webhookId, WebhookRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        webhookId: String,
+        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Webhook = retrieve(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        webhookId: String,
+        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+    ): Webhook = retrieve(webhookId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: WebhookRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Webhook
+
+    /** @see retrieve */
+    fun retrieve(params: WebhookRetrieveParams): Webhook = retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(webhookId: String, requestOptions: RequestOptions): Webhook =
+        retrieve(webhookId, WebhookRetrieveParams.none(), requestOptions)
+
+    /** Update a webhook's configuration. */
+    fun update(webhookId: String): Webhook = update(webhookId, WebhookUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        webhookId: String,
+        params: WebhookUpdateParams = WebhookUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Webhook = update(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        webhookId: String,
+        params: WebhookUpdateParams = WebhookUpdateParams.none(),
+    ): Webhook = update(webhookId, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: WebhookUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): Webhook
+
+    /** @see update */
+    fun update(params: WebhookUpdateParams): Webhook = update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(webhookId: String, requestOptions: RequestOptions): Webhook =
+        update(webhookId, WebhookUpdateParams.none(), requestOptions)
+
+    /** List all webhooks for the organization. */
+    fun list(): WebhookListResponse = list(WebhookListParams.none())
+
+    /** @see list */
+    fun list(
+        params: WebhookListParams = WebhookListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): WebhookListResponse
+
+    /** @see list */
+    fun list(params: WebhookListParams = WebhookListParams.none()): WebhookListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): WebhookListResponse =
+        list(WebhookListParams.none(), requestOptions)
+
+    /** Permanently delete a webhook. */
+    fun delete(webhookId: String): WebhookDeleteResponse =
+        delete(webhookId, WebhookDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        webhookId: String,
+        params: WebhookDeleteParams = WebhookDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): WebhookDeleteResponse =
+        delete(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        webhookId: String,
+        params: WebhookDeleteParams = WebhookDeleteParams.none(),
+    ): WebhookDeleteResponse = delete(webhookId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: WebhookDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): WebhookDeleteResponse
+
+    /** @see delete */
+    fun delete(params: WebhookDeleteParams): WebhookDeleteResponse =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(webhookId: String, requestOptions: RequestOptions): WebhookDeleteResponse =
+        delete(webhookId, WebhookDeleteParams.none(), requestOptions)
+
+    /** A view of [WebhookService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService.WithRawResponse
+
+        /** Manage webhook subscriptions */
+        fun secret(): SecretService.WithRawResponse
+
+        /** View and replay webhook deliveries */
+        fun logs(): LogService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks`, but is otherwise the same as
+         * [WebhookService.create].
+         */
+        @MustBeClosed
+        fun create(params: WebhookCreateParams): HttpResponseFor<WebhookCreateResponse> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: WebhookCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<WebhookCreateResponse>
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks/{webhookId}`, but is otherwise the same as
+         * [WebhookService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(webhookId: String): HttpResponseFor<Webhook> =
+            retrieve(webhookId, WebhookRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            webhookId: String,
+            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Webhook> =
+            retrieve(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            webhookId: String,
+            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
+        ): HttpResponseFor<Webhook> = retrieve(webhookId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: WebhookRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Webhook>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: WebhookRetrieveParams): HttpResponseFor<Webhook> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(webhookId: String, requestOptions: RequestOptions): HttpResponseFor<Webhook> =
+            retrieve(webhookId, WebhookRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `patch /webhooks/{webhookId}`, but is otherwise the same
+         * as [WebhookService.update].
+         */
+        @MustBeClosed
+        fun update(webhookId: String): HttpResponseFor<Webhook> =
+            update(webhookId, WebhookUpdateParams.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            webhookId: String,
+            params: WebhookUpdateParams = WebhookUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Webhook> =
+            update(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            webhookId: String,
+            params: WebhookUpdateParams = WebhookUpdateParams.none(),
+        ): HttpResponseFor<Webhook> = update(webhookId, params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            params: WebhookUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<Webhook>
+
+        /** @see update */
+        @MustBeClosed
+        fun update(params: WebhookUpdateParams): HttpResponseFor<Webhook> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(webhookId: String, requestOptions: RequestOptions): HttpResponseFor<Webhook> =
+            update(webhookId, WebhookUpdateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks`, but is otherwise the same as
+         * [WebhookService.list].
+         */
+        @MustBeClosed
+        fun list(): HttpResponseFor<WebhookListResponse> = list(WebhookListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: WebhookListParams = WebhookListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<WebhookListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: WebhookListParams = WebhookListParams.none()
+        ): HttpResponseFor<WebhookListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<WebhookListResponse> =
+            list(WebhookListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /webhooks/{webhookId}`, but is otherwise the same
+         * as [WebhookService.delete].
+         */
+        @MustBeClosed
+        fun delete(webhookId: String): HttpResponseFor<WebhookDeleteResponse> =
+            delete(webhookId, WebhookDeleteParams.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            webhookId: String,
+            params: WebhookDeleteParams = WebhookDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<WebhookDeleteResponse> =
+            delete(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            webhookId: String,
+            params: WebhookDeleteParams = WebhookDeleteParams.none(),
+        ): HttpResponseFor<WebhookDeleteResponse> = delete(webhookId, params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            params: WebhookDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<WebhookDeleteResponse>
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(params: WebhookDeleteParams): HttpResponseFor<WebhookDeleteResponse> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<WebhookDeleteResponse> =
+            delete(webhookId, WebhookDeleteParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookServiceImpl.kt
new file mode 100644
index 0000000..b62224e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/WebhookServiceImpl.kt
@@ -0,0 +1,260 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.webhooks.Webhook
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookCreateResponse
+import com.blooio.api.models.webhooks.WebhookDeleteParams
+import com.blooio.api.models.webhooks.WebhookDeleteResponse
+import com.blooio.api.models.webhooks.WebhookListParams
+import com.blooio.api.models.webhooks.WebhookListResponse
+import com.blooio.api.models.webhooks.WebhookRetrieveParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import com.blooio.api.services.blocking.webhooks.LogService
+import com.blooio.api.services.blocking.webhooks.LogServiceImpl
+import com.blooio.api.services.blocking.webhooks.SecretService
+import com.blooio.api.services.blocking.webhooks.SecretServiceImpl
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage webhook subscriptions */
+class WebhookServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    WebhookService {
+
+    private val withRawResponse: WebhookService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val secret: SecretService by lazy { SecretServiceImpl(clientOptions) }
+
+    private val logs: LogService by lazy { LogServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): WebhookService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService =
+        WebhookServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage webhook subscriptions */
+    override fun secret(): SecretService = secret
+
+    /** View and replay webhook deliveries */
+    override fun logs(): LogService = logs
+
+    override fun create(
+        params: WebhookCreateParams,
+        requestOptions: RequestOptions,
+    ): WebhookCreateResponse =
+        // post /webhooks
+        withRawResponse().create(params, requestOptions).parse()
+
+    override fun retrieve(params: WebhookRetrieveParams, requestOptions: RequestOptions): Webhook =
+        // get /webhooks/{webhookId}
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun update(params: WebhookUpdateParams, requestOptions: RequestOptions): Webhook =
+        // patch /webhooks/{webhookId}
+        withRawResponse().update(params, requestOptions).parse()
+
+    override fun list(
+        params: WebhookListParams,
+        requestOptions: RequestOptions,
+    ): WebhookListResponse =
+        // get /webhooks
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun delete(
+        params: WebhookDeleteParams,
+        requestOptions: RequestOptions,
+    ): WebhookDeleteResponse =
+        // delete /webhooks/{webhookId}
+        withRawResponse().delete(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        WebhookService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val secret: SecretService.WithRawResponse by lazy {
+            SecretServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val logs: LogService.WithRawResponse by lazy {
+            LogServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): WebhookService.WithRawResponse =
+            WebhookServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage webhook subscriptions */
+        override fun secret(): SecretService.WithRawResponse = secret
+
+        /** View and replay webhook deliveries */
+        override fun logs(): LogService.WithRawResponse = logs
+
+        private val createHandler: Handler<WebhookCreateResponse> =
+            jsonHandler<WebhookCreateResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: WebhookCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<WebhookCreateResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { createHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val retrieveHandler: Handler<Webhook> =
+            jsonHandler<Webhook>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: WebhookRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Webhook> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val updateHandler: Handler<Webhook> = jsonHandler<Webhook>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: WebhookUpdateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<Webhook> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PATCH)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { updateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val listHandler: Handler<WebhookListResponse> =
+            jsonHandler<WebhookListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: WebhookListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<WebhookListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val deleteHandler: Handler<WebhookDeleteResponse> =
+            jsonHandler<WebhookDeleteResponse>(clientOptions.jsonMapper)
+
+        override fun delete(
+            params: WebhookDeleteParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<WebhookDeleteResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { deleteHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
new file mode 100644
index 0000000..47f2e55
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
@@ -0,0 +1,253 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.background.BackgroundRemoveParams
+import com.blooio.api.models.chats.background.BackgroundRetrieveParams
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import com.blooio.api.models.chats.background.ChatBackgroundResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Set, get, and remove conversation backgrounds */
+interface BackgroundService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): BackgroundService
+
+    /**
+     * Get the current background image metadata for a conversation. Works for both 1-on-1 and group
+     * chats.
+     */
+    fun retrieve(chatId: String): ChatBackgroundResponse =
+        retrieve(chatId, BackgroundRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse = retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        chatId: String,
+        params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+    ): ChatBackgroundResponse = retrieve(chatId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: BackgroundRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse
+
+    /** @see retrieve */
+    fun retrieve(params: BackgroundRetrieveParams): ChatBackgroundResponse =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(chatId: String, requestOptions: RequestOptions): ChatBackgroundResponse =
+        retrieve(chatId, BackgroundRetrieveParams.none(), requestOptions)
+
+    /** Remove the background image from a conversation, reverting to the default appearance. */
+    fun remove(chatId: String): ChatBackgroundResponse =
+        remove(chatId, BackgroundRemoveParams.none())
+
+    /** @see remove */
+    fun remove(
+        chatId: String,
+        params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse = remove(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(
+        chatId: String,
+        params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+    ): ChatBackgroundResponse = remove(chatId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: BackgroundRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse
+
+    /** @see remove */
+    fun remove(params: BackgroundRemoveParams): ChatBackgroundResponse =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(chatId: String, requestOptions: RequestOptions): ChatBackgroundResponse =
+        remove(chatId, BackgroundRemoveParams.none(), requestOptions)
+
+    /**
+     * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
+     *
+     * The uploaded image is converted into a PosterKit-compatible archive and applied to the
+     * iMessage conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP,
+     * HEIC/HEIF. Maximum file size: 10 MB.
+     */
+    fun set(chatId: String, params: BackgroundSetParams): ChatBackgroundResponse =
+        set(chatId, params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        chatId: String,
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse = set(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see set */
+    fun set(params: BackgroundSetParams): ChatBackgroundResponse =
+        set(params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ChatBackgroundResponse
+
+    /** A view of [BackgroundService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): BackgroundService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(chatId: String): HttpResponseFor<ChatBackgroundResponse> =
+            retrieve(chatId, BackgroundRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse> =
+            retrieve(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            params: BackgroundRetrieveParams = BackgroundRetrieveParams.none(),
+        ): HttpResponseFor<ChatBackgroundResponse> = retrieve(chatId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: BackgroundRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: BackgroundRetrieveParams): HttpResponseFor<ChatBackgroundResponse> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatBackgroundResponse> =
+            retrieve(chatId, BackgroundRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundService.remove].
+         */
+        @MustBeClosed
+        fun remove(chatId: String): HttpResponseFor<ChatBackgroundResponse> =
+            remove(chatId, BackgroundRemoveParams.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            chatId: String,
+            params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse> =
+            remove(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            chatId: String,
+            params: BackgroundRemoveParams = BackgroundRemoveParams.none(),
+        ): HttpResponseFor<ChatBackgroundResponse> = remove(chatId, params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            params: BackgroundRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse>
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(params: BackgroundRemoveParams): HttpResponseFor<ChatBackgroundResponse> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatBackgroundResponse> =
+            remove(chatId, BackgroundRemoveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `put /chats/{chatId}/background`, but is otherwise the
+         * same as [BackgroundService.set].
+         */
+        @MustBeClosed
+        fun set(
+            chatId: String,
+            params: BackgroundSetParams,
+        ): HttpResponseFor<ChatBackgroundResponse> = set(chatId, params, RequestOptions.none())
+
+        /** @see set */
+        @MustBeClosed
+        fun set(
+            chatId: String,
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse> =
+            set(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see set */
+        @MustBeClosed
+        fun set(params: BackgroundSetParams): HttpResponseFor<ChatBackgroundResponse> =
+            set(params, RequestOptions.none())
+
+        /** @see set */
+        @MustBeClosed
+        fun set(
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ChatBackgroundResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
new file mode 100644
index 0000000..5411d8a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
@@ -0,0 +1,166 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.multipartFormData
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.chats.background.BackgroundRemoveParams
+import com.blooio.api.models.chats.background.BackgroundRetrieveParams
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import com.blooio.api.models.chats.background.ChatBackgroundResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Set, get, and remove conversation backgrounds */
+class BackgroundServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    BackgroundService {
+
+    private val withRawResponse: BackgroundService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): BackgroundService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BackgroundService =
+        BackgroundServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: BackgroundRetrieveParams,
+        requestOptions: RequestOptions,
+    ): ChatBackgroundResponse =
+        // get /chats/{chatId}/background
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun remove(
+        params: BackgroundRemoveParams,
+        requestOptions: RequestOptions,
+    ): ChatBackgroundResponse =
+        // delete /chats/{chatId}/background
+        withRawResponse().remove(params, requestOptions).parse()
+
+    override fun set(
+        params: BackgroundSetParams,
+        requestOptions: RequestOptions,
+    ): ChatBackgroundResponse =
+        // put /chats/{chatId}/background
+        withRawResponse().set(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        BackgroundService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): BackgroundService.WithRawResponse =
+            BackgroundServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: BackgroundRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatBackgroundResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val removeHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: BackgroundRemoveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatBackgroundResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { removeHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val setHandler: Handler<ChatBackgroundResponse> =
+            jsonHandler<ChatBackgroundResponse>(clientOptions.jsonMapper)
+
+        override fun set(
+            params: BackgroundSetParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ChatBackgroundResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PUT)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "background")
+                    .body(multipartFormData(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { setHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
new file mode 100644
index 0000000..b5e883d
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -0,0 +1,366 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageGetStatusResponse
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageListResponse
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageReactResponse
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageRetrieveResponse
+import com.blooio.api.models.chats.messages.MessageSendParams
+import com.blooio.api.models.chats.messages.MessageSendResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+interface MessageService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageService
+
+    /** Get details for a specific message. */
+    fun retrieve(messageId: String, params: MessageRetrieveParams): MessageRetrieveResponse =
+        retrieve(messageId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        messageId: String,
+        params: MessageRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageRetrieveResponse =
+        retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(params: MessageRetrieveParams): MessageRetrieveResponse =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: MessageRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageRetrieveResponse
+
+    /** List all messages in a conversation with optional filtering. */
+    fun list(chatId: String): MessageListResponse = list(chatId, MessageListParams.none())
+
+    /** @see list */
+    fun list(
+        chatId: String,
+        params: MessageListParams = MessageListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageListResponse = list(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        chatId: String,
+        params: MessageListParams = MessageListParams.none(),
+    ): MessageListResponse = list(chatId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: MessageListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageListResponse
+
+    /** @see list */
+    fun list(params: MessageListParams): MessageListResponse = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(chatId: String, requestOptions: RequestOptions): MessageListResponse =
+        list(chatId, MessageListParams.none(), requestOptions)
+
+    /** Get delivery status for a specific message. */
+    fun getStatus(messageId: String, params: MessageGetStatusParams): MessageGetStatusResponse =
+        getStatus(messageId, params, RequestOptions.none())
+
+    /** @see getStatus */
+    fun getStatus(
+        messageId: String,
+        params: MessageGetStatusParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageGetStatusResponse =
+        getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see getStatus */
+    fun getStatus(params: MessageGetStatusParams): MessageGetStatusResponse =
+        getStatus(params, RequestOptions.none())
+
+    /** @see getStatus */
+    fun getStatus(
+        params: MessageGetStatusParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageGetStatusResponse
+
+    /**
+     * Add or remove a reaction to a message. Supports classic iMessage tapbacks (love, like,
+     * dislike, laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).
+     *
+     * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
+     * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter
+     * by message direction (inbound/outbound only).
+     *
+     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
+     */
+    fun react(messageId: String, params: MessageReactParams): MessageReactResponse =
+        react(messageId, params, RequestOptions.none())
+
+    /** @see react */
+    fun react(
+        messageId: String,
+        params: MessageReactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageReactResponse = react(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+    /** @see react */
+    fun react(params: MessageReactParams): MessageReactResponse =
+        react(params, RequestOptions.none())
+
+    /** @see react */
+    fun react(
+        params: MessageReactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageReactResponse
+
+    /**
+     * Send a message to a chat. The chatId can be: (1) E.164 phone number, (2) email address, (3)
+     * group ID (grp_xxxx), or (4) comma-separated list of phone/email for multi-recipient chats.
+     * For multi-recipient, an unnamed group is automatically created or reused if the exact
+     * participant combination already exists. For explicit groups, the group must be linked to an
+     * existing iMessage chat.
+     */
+    fun send(chatId: String): MessageSendResponse = send(chatId, MessageSendParams.none())
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: MessageSendParams = MessageSendParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageSendResponse = send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: MessageSendParams = MessageSendParams.none(),
+    ): MessageSendResponse = send(chatId, params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        params: MessageSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MessageSendResponse
+
+    /** @see send */
+    fun send(params: MessageSendParams): MessageSendResponse = send(params, RequestOptions.none())
+
+    /** @see send */
+    fun send(chatId: String, requestOptions: RequestOptions): MessageSendResponse =
+        send(chatId, MessageSendParams.none(), requestOptions)
+
+    /** A view of [MessageService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): MessageService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages/{messageId}`, but is
+         * otherwise the same as [MessageService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(
+            messageId: String,
+            params: MessageRetrieveParams,
+        ): HttpResponseFor<MessageRetrieveResponse> =
+            retrieve(messageId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            messageId: String,
+            params: MessageRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageRetrieveResponse> =
+            retrieve(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: MessageRetrieveParams): HttpResponseFor<MessageRetrieveResponse> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: MessageRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageRetrieveResponse>
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages`, but is otherwise the same
+         * as [MessageService.list].
+         */
+        @MustBeClosed
+        fun list(chatId: String): HttpResponseFor<MessageListResponse> =
+            list(chatId, MessageListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            chatId: String,
+            params: MessageListParams = MessageListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageListResponse> =
+            list(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            chatId: String,
+            params: MessageListParams = MessageListParams.none(),
+        ): HttpResponseFor<MessageListResponse> = list(chatId, params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: MessageListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(params: MessageListParams): HttpResponseFor<MessageListResponse> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MessageListResponse> =
+            list(chatId, MessageListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/messages/{messageId}/status`, but is
+         * otherwise the same as [MessageService.getStatus].
+         */
+        @MustBeClosed
+        fun getStatus(
+            messageId: String,
+            params: MessageGetStatusParams,
+        ): HttpResponseFor<MessageGetStatusResponse> =
+            getStatus(messageId, params, RequestOptions.none())
+
+        /** @see getStatus */
+        @MustBeClosed
+        fun getStatus(
+            messageId: String,
+            params: MessageGetStatusParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageGetStatusResponse> =
+            getStatus(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see getStatus */
+        @MustBeClosed
+        fun getStatus(params: MessageGetStatusParams): HttpResponseFor<MessageGetStatusResponse> =
+            getStatus(params, RequestOptions.none())
+
+        /** @see getStatus */
+        @MustBeClosed
+        fun getStatus(
+            params: MessageGetStatusParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageGetStatusResponse>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/messages/{messageId}/reactions`,
+         * but is otherwise the same as [MessageService.react].
+         */
+        @MustBeClosed
+        fun react(
+            messageId: String,
+            params: MessageReactParams,
+        ): HttpResponseFor<MessageReactResponse> = react(messageId, params, RequestOptions.none())
+
+        /** @see react */
+        @MustBeClosed
+        fun react(
+            messageId: String,
+            params: MessageReactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageReactResponse> =
+            react(params.toBuilder().messageId(messageId).build(), requestOptions)
+
+        /** @see react */
+        @MustBeClosed
+        fun react(params: MessageReactParams): HttpResponseFor<MessageReactResponse> =
+            react(params, RequestOptions.none())
+
+        /** @see react */
+        @MustBeClosed
+        fun react(
+            params: MessageReactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageReactResponse>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/messages`, but is otherwise the
+         * same as [MessageService.send].
+         */
+        @MustBeClosed
+        fun send(chatId: String): HttpResponseFor<MessageSendResponse> =
+            send(chatId, MessageSendParams.none())
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            chatId: String,
+            params: MessageSendParams = MessageSendParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageSendResponse> =
+            send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            chatId: String,
+            params: MessageSendParams = MessageSendParams.none(),
+        ): HttpResponseFor<MessageSendResponse> = send(chatId, params, RequestOptions.none())
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            params: MessageSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MessageSendResponse>
+
+        /** @see send */
+        @MustBeClosed
+        fun send(params: MessageSendParams): HttpResponseFor<MessageSendResponse> =
+            send(params, RequestOptions.none())
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            chatId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MessageSendResponse> =
+            send(chatId, MessageSendParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageServiceImpl.kt
similarity index 63%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageServiceImpl.kt
index a2056a6..01f5574 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/MessageServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageServiceImpl.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.services.blocking
+package com.blooio.api.services.blocking.chats
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
@@ -16,18 +16,19 @@ import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepare
-import com.blooio.api.models.messages.MessageCancelParams
-import com.blooio.api.models.messages.MessageCancelResponse
-import com.blooio.api.models.messages.MessageGetStatusParams
-import com.blooio.api.models.messages.MessageGetStatusResponse
-import com.blooio.api.models.messages.MessageRetrieveParams
-import com.blooio.api.models.messages.MessageRetrieveResponse
-import com.blooio.api.models.messages.MessageSendParams
-import com.blooio.api.models.messages.MessageSendResponse
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageGetStatusResponse
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageListResponse
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageReactResponse
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageRetrieveResponse
+import com.blooio.api.models.chats.messages.MessageSendParams
+import com.blooio.api.models.chats.messages.MessageSendResponse
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Send and manage individual messages */
 class MessageServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     MessageService {
 
@@ -44,28 +45,35 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
         params: MessageRetrieveParams,
         requestOptions: RequestOptions,
     ): MessageRetrieveResponse =
-        // get /v1/api/messages/{messageId}
+        // get /chats/{chatId}/messages/{messageId}
         withRawResponse().retrieve(params, requestOptions).parse()
 
-    override fun cancel(
-        params: MessageCancelParams,
+    override fun list(
+        params: MessageListParams,
         requestOptions: RequestOptions,
-    ): MessageCancelResponse =
-        // delete /v1/api/messages/{messageId}
-        withRawResponse().cancel(params, requestOptions).parse()
+    ): MessageListResponse =
+        // get /chats/{chatId}/messages
+        withRawResponse().list(params, requestOptions).parse()
 
     override fun getStatus(
         params: MessageGetStatusParams,
         requestOptions: RequestOptions,
     ): MessageGetStatusResponse =
-        // get /v1/api/messages/{messageId}/status
+        // get /chats/{chatId}/messages/{messageId}/status
         withRawResponse().getStatus(params, requestOptions).parse()
 
+    override fun react(
+        params: MessageReactParams,
+        requestOptions: RequestOptions,
+    ): MessageReactResponse =
+        // post /chats/{chatId}/messages/{messageId}/reactions
+        withRawResponse().react(params, requestOptions).parse()
+
     override fun send(
         params: MessageSendParams,
         requestOptions: RequestOptions,
     ): MessageSendResponse =
-        // post /v1/api/messages
+        // post /chats/{chatId}/messages
         withRawResponse().send(params, requestOptions).parse()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -95,7 +103,12 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0))
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                    )
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -111,29 +124,28 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
             }
         }
 
-        private val cancelHandler: Handler<MessageCancelResponse> =
-            jsonHandler<MessageCancelResponse>(clientOptions.jsonMapper)
+        private val listHandler: Handler<MessageListResponse> =
+            jsonHandler<MessageListResponse>(clientOptions.jsonMapper)
 
-        override fun cancel(
-            params: MessageCancelParams,
+        override fun list(
+            params: MessageListParams,
             requestOptions: RequestOptions,
-        ): HttpResponseFor<MessageCancelResponse> {
+        ): HttpResponseFor<MessageListResponse> {
             // We check here instead of in the params builder because this can be specified
             // positionally or in the params class.
-            checkRequired("messageId", params.messageId().getOrNull())
+            checkRequired("chatId", params.chatId().getOrNull())
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.DELETE)
+                    .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0))
-                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .addPathSegments("chats", params._pathParam(0), "messages")
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
             val response = clientOptions.httpClient.execute(request, requestOptions)
             return errorHandler.handle(response).parseable {
                 response
-                    .use { cancelHandler.handle(it) }
+                    .use { listHandler.handle(it) }
                     .also {
                         if (requestOptions.responseValidation!!) {
                             it.validate()
@@ -156,7 +168,13 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
                 HttpRequest.builder()
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages", params._pathParam(0), "status")
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                        "status",
+                    )
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
@@ -172,6 +190,43 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
             }
         }
 
+        private val reactHandler: Handler<MessageReactResponse> =
+            jsonHandler<MessageReactResponse>(clientOptions.jsonMapper)
+
+        override fun react(
+            params: MessageReactParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MessageReactResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("messageId", params.messageId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "chats",
+                        params._pathParam(0),
+                        "messages",
+                        params._pathParam(1),
+                        "reactions",
+                    )
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { reactHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
         private val sendHandler: Handler<MessageSendResponse> =
             jsonHandler<MessageSendResponse>(clientOptions.jsonMapper)
 
@@ -179,11 +234,14 @@ class MessageServiceImpl internal constructor(private val clientOptions: ClientO
             params: MessageSendParams,
             requestOptions: RequestOptions,
         ): HttpResponseFor<MessageSendResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
             val request =
                 HttpRequest.builder()
                     .method(HttpMethod.POST)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "messages")
+                    .addPathSegments("chats", params._pathParam(0), "messages")
                     .body(json(clientOptions.jsonMapper, params._body()))
                     .build()
                     .prepare(clientOptions, params)
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollService.kt
new file mode 100644
index 0000000..0cb7da9
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollService.kt
@@ -0,0 +1,153 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollGetResultsResponse
+import com.blooio.api.models.chats.polls.PollSendParams
+import com.blooio.api.models.chats.polls.PollSendResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/**
+ * Send native iMessage polls and retrieve poll results with vote counts. Poll events are delivered
+ * via separate webhook event types (poll.received, poll.created, poll.voted) and require
+ * webhook_type 'poll' or 'all'.
+ */
+interface PollService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollService
+
+    /**
+     * Retrieve a poll's definition and aggregated vote counts. The pollId is the poll_id returned
+     * in the poll.received or poll.created webhook event.
+     */
+    fun getResults(pollId: String, params: PollGetResultsParams): PollGetResultsResponse =
+        getResults(pollId, params, RequestOptions.none())
+
+    /** @see getResults */
+    fun getResults(
+        pollId: String,
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PollGetResultsResponse =
+        getResults(params.toBuilder().pollId(pollId).build(), requestOptions)
+
+    /** @see getResults */
+    fun getResults(params: PollGetResultsParams): PollGetResultsResponse =
+        getResults(params, RequestOptions.none())
+
+    /** @see getResults */
+    fun getResults(
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PollGetResultsResponse
+
+    /**
+     * Send a native iMessage poll to a chat. The poll appears as an interactive ballot that
+     * recipients can vote on.
+     */
+    fun send(chatId: String, params: PollSendParams): PollSendResponse =
+        send(chatId, params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        chatId: String,
+        params: PollSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PollSendResponse = send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see send */
+    fun send(params: PollSendParams): PollSendResponse = send(params, RequestOptions.none())
+
+    /** @see send */
+    fun send(
+        params: PollSendParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PollSendResponse
+
+    /** A view of [PollService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /chats/{chatId}/polls/{pollId}`, but is otherwise
+         * the same as [PollService.getResults].
+         */
+        @MustBeClosed
+        fun getResults(
+            pollId: String,
+            params: PollGetResultsParams,
+        ): HttpResponseFor<PollGetResultsResponse> =
+            getResults(pollId, params, RequestOptions.none())
+
+        /** @see getResults */
+        @MustBeClosed
+        fun getResults(
+            pollId: String,
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PollGetResultsResponse> =
+            getResults(params.toBuilder().pollId(pollId).build(), requestOptions)
+
+        /** @see getResults */
+        @MustBeClosed
+        fun getResults(params: PollGetResultsParams): HttpResponseFor<PollGetResultsResponse> =
+            getResults(params, RequestOptions.none())
+
+        /** @see getResults */
+        @MustBeClosed
+        fun getResults(
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PollGetResultsResponse>
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/polls`, but is otherwise the same
+         * as [PollService.send].
+         */
+        @MustBeClosed
+        fun send(chatId: String, params: PollSendParams): HttpResponseFor<PollSendResponse> =
+            send(chatId, params, RequestOptions.none())
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            chatId: String,
+            params: PollSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PollSendResponse> =
+            send(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see send */
+        @MustBeClosed
+        fun send(params: PollSendParams): HttpResponseFor<PollSendResponse> =
+            send(params, RequestOptions.none())
+
+        /** @see send */
+        @MustBeClosed
+        fun send(
+            params: PollSendParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PollSendResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollServiceImpl.kt
new file mode 100644
index 0000000..ec630c6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/PollServiceImpl.kt
@@ -0,0 +1,127 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollGetResultsResponse
+import com.blooio.api.models.chats.polls.PollSendParams
+import com.blooio.api.models.chats.polls.PollSendResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Send native iMessage polls and retrieve poll results with vote counts. Poll events are delivered
+ * via separate webhook event types (poll.received, poll.created, poll.voted) and require
+ * webhook_type 'poll' or 'all'.
+ */
+class PollServiceImpl internal constructor(private val clientOptions: ClientOptions) : PollService {
+
+    private val withRawResponse: PollService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): PollService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): PollService =
+        PollServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun getResults(
+        params: PollGetResultsParams,
+        requestOptions: RequestOptions,
+    ): PollGetResultsResponse =
+        // get /chats/{chatId}/polls/{pollId}
+        withRawResponse().getResults(params, requestOptions).parse()
+
+    override fun send(params: PollSendParams, requestOptions: RequestOptions): PollSendResponse =
+        // post /chats/{chatId}/polls
+        withRawResponse().send(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        PollService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): PollService.WithRawResponse =
+            PollServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val getResultsHandler: Handler<PollGetResultsResponse> =
+            jsonHandler<PollGetResultsResponse>(clientOptions.jsonMapper)
+
+        override fun getResults(
+            params: PollGetResultsParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<PollGetResultsResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("pollId", params.pollId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "polls", params._pathParam(1))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { getResultsHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val sendHandler: Handler<PollSendResponse> =
+            jsonHandler<PollSendResponse>(clientOptions.jsonMapper)
+
+        override fun send(
+            params: PollSendParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<PollSendResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "polls")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { sendHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
new file mode 100644
index 0000000..c3b37a2
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
@@ -0,0 +1,179 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.chats.typing.TypingResponse
+import com.blooio.api.models.chats.typing.TypingStartParams
+import com.blooio.api.models.chats.typing.TypingStopParams
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Control typing indicators for conversations */
+interface TypingService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): TypingService
+
+    /**
+     * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     */
+    fun start(chatId: String): TypingResponse = start(chatId, TypingStartParams.none())
+
+    /** @see start */
+    fun start(
+        chatId: String,
+        params: TypingStartParams = TypingStartParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TypingResponse = start(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see start */
+    fun start(
+        chatId: String,
+        params: TypingStartParams = TypingStartParams.none(),
+    ): TypingResponse = start(chatId, params, RequestOptions.none())
+
+    /** @see start */
+    fun start(
+        params: TypingStartParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TypingResponse
+
+    /** @see start */
+    fun start(params: TypingStartParams): TypingResponse = start(params, RequestOptions.none())
+
+    /** @see start */
+    fun start(chatId: String, requestOptions: RequestOptions): TypingResponse =
+        start(chatId, TypingStartParams.none(), requestOptions)
+
+    /** Stop the typing indicator for a chat. */
+    fun stop(chatId: String): TypingResponse = stop(chatId, TypingStopParams.none())
+
+    /** @see stop */
+    fun stop(
+        chatId: String,
+        params: TypingStopParams = TypingStopParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TypingResponse = stop(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+    /** @see stop */
+    fun stop(chatId: String, params: TypingStopParams = TypingStopParams.none()): TypingResponse =
+        stop(chatId, params, RequestOptions.none())
+
+    /** @see stop */
+    fun stop(
+        params: TypingStopParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TypingResponse
+
+    /** @see stop */
+    fun stop(params: TypingStopParams): TypingResponse = stop(params, RequestOptions.none())
+
+    /** @see stop */
+    fun stop(chatId: String, requestOptions: RequestOptions): TypingResponse =
+        stop(chatId, TypingStopParams.none(), requestOptions)
+
+    /** A view of [TypingService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): TypingService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /chats/{chatId}/typing`, but is otherwise the same
+         * as [TypingService.start].
+         */
+        @MustBeClosed
+        fun start(chatId: String): HttpResponseFor<TypingResponse> =
+            start(chatId, TypingStartParams.none())
+
+        /** @see start */
+        @MustBeClosed
+        fun start(
+            chatId: String,
+            params: TypingStartParams = TypingStartParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TypingResponse> =
+            start(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see start */
+        @MustBeClosed
+        fun start(
+            chatId: String,
+            params: TypingStartParams = TypingStartParams.none(),
+        ): HttpResponseFor<TypingResponse> = start(chatId, params, RequestOptions.none())
+
+        /** @see start */
+        @MustBeClosed
+        fun start(
+            params: TypingStartParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TypingResponse>
+
+        /** @see start */
+        @MustBeClosed
+        fun start(params: TypingStartParams): HttpResponseFor<TypingResponse> =
+            start(params, RequestOptions.none())
+
+        /** @see start */
+        @MustBeClosed
+        fun start(chatId: String, requestOptions: RequestOptions): HttpResponseFor<TypingResponse> =
+            start(chatId, TypingStartParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /chats/{chatId}/typing`, but is otherwise the
+         * same as [TypingService.stop].
+         */
+        @MustBeClosed
+        fun stop(chatId: String): HttpResponseFor<TypingResponse> =
+            stop(chatId, TypingStopParams.none())
+
+        /** @see stop */
+        @MustBeClosed
+        fun stop(
+            chatId: String,
+            params: TypingStopParams = TypingStopParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TypingResponse> =
+            stop(params.toBuilder().chatId(chatId).build(), requestOptions)
+
+        /** @see stop */
+        @MustBeClosed
+        fun stop(
+            chatId: String,
+            params: TypingStopParams = TypingStopParams.none(),
+        ): HttpResponseFor<TypingResponse> = stop(chatId, params, RequestOptions.none())
+
+        /** @see stop */
+        @MustBeClosed
+        fun stop(
+            params: TypingStopParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TypingResponse>
+
+        /** @see stop */
+        @MustBeClosed
+        fun stop(params: TypingStopParams): HttpResponseFor<TypingResponse> =
+            stop(params, RequestOptions.none())
+
+        /** @see stop */
+        @MustBeClosed
+        fun stop(chatId: String, requestOptions: RequestOptions): HttpResponseFor<TypingResponse> =
+            stop(chatId, TypingStopParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingServiceImpl.kt
new file mode 100644
index 0000000..df59465
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingServiceImpl.kt
@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.chats.typing.TypingResponse
+import com.blooio.api.models.chats.typing.TypingStartParams
+import com.blooio.api.models.chats.typing.TypingStopParams
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Control typing indicators for conversations */
+class TypingServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    TypingService {
+
+    private val withRawResponse: TypingService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): TypingService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): TypingService =
+        TypingServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun start(params: TypingStartParams, requestOptions: RequestOptions): TypingResponse =
+        // post /chats/{chatId}/typing
+        withRawResponse().start(params, requestOptions).parse()
+
+    override fun stop(params: TypingStopParams, requestOptions: RequestOptions): TypingResponse =
+        // delete /chats/{chatId}/typing
+        withRawResponse().stop(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        TypingService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): TypingService.WithRawResponse =
+            TypingServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val startHandler: Handler<TypingResponse> =
+            jsonHandler<TypingResponse>(clientOptions.jsonMapper)
+
+        override fun start(
+            params: TypingStartParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<TypingResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "typing")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { startHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val stopHandler: Handler<TypingResponse> =
+            jsonHandler<TypingResponse>(clientOptions.jsonMapper)
+
+        override fun stop(
+            params: TypingStopParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<TypingResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("chatId", params.chatId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("chats", params._pathParam(0), "typing")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { stopHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
deleted file mode 100644
index f5eb09d..0000000
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookService.kt
+++ /dev/null
@@ -1,120 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking.config
-
-import com.blooio.api.core.ClientOptions
-import com.blooio.api.core.RequestOptions
-import com.blooio.api.core.http.HttpResponseFor
-import com.blooio.api.models.config.webhook.WebhookRetrieveParams
-import com.blooio.api.models.config.webhook.WebhookRetrieveResponse
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import com.blooio.api.models.config.webhook.WebhookUpdateResponse
-import com.google.errorprone.annotations.MustBeClosed
-import java.util.function.Consumer
-
-/** Account-level configuration */
-interface WebhookService {
-
-    /**
-     * Returns a view of this service that provides access to raw HTTP responses for each method.
-     */
-    fun withRawResponse(): WithRawResponse
-
-    /**
-     * Returns a view of this service with the given option modifications applied.
-     *
-     * The original service is not modified.
-     */
-    fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService
-
-    /** Get the current webhook URL */
-    fun retrieve(): WebhookRetrieveResponse = retrieve(WebhookRetrieveParams.none())
-
-    /** @see retrieve */
-    fun retrieve(
-        params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): WebhookRetrieveResponse
-
-    /** @see retrieve */
-    fun retrieve(
-        params: WebhookRetrieveParams = WebhookRetrieveParams.none()
-    ): WebhookRetrieveResponse = retrieve(params, RequestOptions.none())
-
-    /** @see retrieve */
-    fun retrieve(requestOptions: RequestOptions): WebhookRetrieveResponse =
-        retrieve(WebhookRetrieveParams.none(), requestOptions)
-
-    /**
-     * Configure the webhook URL that will receive all message events. Once configured, your
-     * endpoint will receive POST requests with the following event types:
-     * - `message.received` - When you receive an inbound message
-     * - `message.sent` - When your outbound message is sent to the carrier
-     * - `message.delivered` - When your outbound message is delivered to the recipient
-     * - `message.failed` - When your outbound message fails to deliver
-     * - `message.read` - When your outbound message is read by the recipient (iMessage only,
-     *   recipient must have read receipts enabled)
-     *
-     * See the webhook event schemas for detailed payload formats.
-     */
-    fun update(params: WebhookUpdateParams): WebhookUpdateResponse =
-        update(params, RequestOptions.none())
-
-    /** @see update */
-    fun update(
-        params: WebhookUpdateParams,
-        requestOptions: RequestOptions = RequestOptions.none(),
-    ): WebhookUpdateResponse
-
-    /** A view of [WebhookService] that provides access to raw HTTP responses for each method. */
-    interface WithRawResponse {
-
-        /**
-         * Returns a view of this service with the given option modifications applied.
-         *
-         * The original service is not modified.
-         */
-        fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService.WithRawResponse
-
-        /**
-         * Returns a raw HTTP response for `get /v1/api/config/webhook`, but is otherwise the same
-         * as [WebhookService.retrieve].
-         */
-        @MustBeClosed
-        fun retrieve(): HttpResponseFor<WebhookRetrieveResponse> =
-            retrieve(WebhookRetrieveParams.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            params: WebhookRetrieveParams = WebhookRetrieveParams.none(),
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<WebhookRetrieveResponse>
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(
-            params: WebhookRetrieveParams = WebhookRetrieveParams.none()
-        ): HttpResponseFor<WebhookRetrieveResponse> = retrieve(params, RequestOptions.none())
-
-        /** @see retrieve */
-        @MustBeClosed
-        fun retrieve(requestOptions: RequestOptions): HttpResponseFor<WebhookRetrieveResponse> =
-            retrieve(WebhookRetrieveParams.none(), requestOptions)
-
-        /**
-         * Returns a raw HTTP response for `put /v1/api/config/webhook`, but is otherwise the same
-         * as [WebhookService.update].
-         */
-        @MustBeClosed
-        fun update(params: WebhookUpdateParams): HttpResponseFor<WebhookUpdateResponse> =
-            update(params, RequestOptions.none())
-
-        /** @see update */
-        @MustBeClosed
-        fun update(
-            params: WebhookUpdateParams,
-            requestOptions: RequestOptions = RequestOptions.none(),
-        ): HttpResponseFor<WebhookUpdateResponse>
-    }
-}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagService.kt
new file mode 100644
index 0000000..3aa4cee
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagService.kt
@@ -0,0 +1,213 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.contacts
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagAddResponse
+import com.blooio.api.models.contacts.tags.TagListParams
+import com.blooio.api.models.contacts.tags.TagListResponse
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage contacts (phone numbers and emails) */
+interface TagService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagService
+
+    /** List all tags assigned to a contact. */
+    fun list(contactId: String): TagListResponse = list(contactId, TagListParams.none())
+
+    /** @see list */
+    fun list(
+        contactId: String,
+        params: TagListParams = TagListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TagListResponse = list(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see list */
+    fun list(contactId: String, params: TagListParams = TagListParams.none()): TagListResponse =
+        list(contactId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: TagListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TagListResponse
+
+    /** @see list */
+    fun list(params: TagListParams): TagListResponse = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(contactId: String, requestOptions: RequestOptions): TagListResponse =
+        list(contactId, TagListParams.none(), requestOptions)
+
+    /**
+     * Add one or more tags to a contact. If a tag already exists on the contact, it is re-activated
+     * (idempotent). Tags are free-form strings.
+     */
+    fun add(contactId: String, params: TagAddParams): TagAddResponse =
+        add(contactId, params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        contactId: String,
+        params: TagAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TagAddResponse = add(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see add */
+    fun add(params: TagAddParams): TagAddResponse = add(params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        params: TagAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): TagAddResponse
+
+    /** Remove a specific tag from a contact. The tag is soft-deleted and can be re-added later. */
+    fun remove(tag: String, params: TagRemoveParams): DeleteResponse =
+        remove(tag, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        tag: String,
+        params: TagRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): DeleteResponse = remove(params.toBuilder().tag(tag).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(params: TagRemoveParams): DeleteResponse = remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: TagRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): DeleteResponse
+
+    /** A view of [TagService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /contacts/{contactId}/tags`, but is otherwise the
+         * same as [TagService.list].
+         */
+        @MustBeClosed
+        fun list(contactId: String): HttpResponseFor<TagListResponse> =
+            list(contactId, TagListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            contactId: String,
+            params: TagListParams = TagListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TagListResponse> =
+            list(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            contactId: String,
+            params: TagListParams = TagListParams.none(),
+        ): HttpResponseFor<TagListResponse> = list(contactId, params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: TagListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TagListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(params: TagListParams): HttpResponseFor<TagListResponse> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            contactId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<TagListResponse> = list(contactId, TagListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /contacts/{contactId}/tags`, but is otherwise the
+         * same as [TagService.add].
+         */
+        @MustBeClosed
+        fun add(contactId: String, params: TagAddParams): HttpResponseFor<TagAddResponse> =
+            add(contactId, params, RequestOptions.none())
+
+        /** @see add */
+        @MustBeClosed
+        fun add(
+            contactId: String,
+            params: TagAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TagAddResponse> =
+            add(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see add */
+        @MustBeClosed
+        fun add(params: TagAddParams): HttpResponseFor<TagAddResponse> =
+            add(params, RequestOptions.none())
+
+        /** @see add */
+        @MustBeClosed
+        fun add(
+            params: TagAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<TagAddResponse>
+
+        /**
+         * Returns a raw HTTP response for `delete /contacts/{contactId}/tags/{tag}`, but is
+         * otherwise the same as [TagService.remove].
+         */
+        @MustBeClosed
+        fun remove(tag: String, params: TagRemoveParams): HttpResponseFor<DeleteResponse> =
+            remove(tag, params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            tag: String,
+            params: TagRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<DeleteResponse> =
+            remove(params.toBuilder().tag(tag).build(), requestOptions)
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(params: TagRemoveParams): HttpResponseFor<DeleteResponse> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            params: TagRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<DeleteResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagServiceImpl.kt
new file mode 100644
index 0000000..c21571c
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/contacts/TagServiceImpl.kt
@@ -0,0 +1,157 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.contacts
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.contacts.DeleteResponse
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagAddResponse
+import com.blooio.api.models.contacts.tags.TagListParams
+import com.blooio.api.models.contacts.tags.TagListResponse
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contacts (phone numbers and emails) */
+class TagServiceImpl internal constructor(private val clientOptions: ClientOptions) : TagService {
+
+    private val withRawResponse: TagService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): TagService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): TagService =
+        TagServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(params: TagListParams, requestOptions: RequestOptions): TagListResponse =
+        // get /contacts/{contactId}/tags
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun add(params: TagAddParams, requestOptions: RequestOptions): TagAddResponse =
+        // post /contacts/{contactId}/tags
+        withRawResponse().add(params, requestOptions).parse()
+
+    override fun remove(params: TagRemoveParams, requestOptions: RequestOptions): DeleteResponse =
+        // delete /contacts/{contactId}/tags/{tag}
+        withRawResponse().remove(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        TagService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): TagService.WithRawResponse =
+            TagServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<TagListResponse> =
+            jsonHandler<TagListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: TagListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<TagListResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val addHandler: Handler<TagAddResponse> =
+            jsonHandler<TagAddResponse>(clientOptions.jsonMapper)
+
+        override fun add(
+            params: TagAddParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<TagAddResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { addHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val removeHandler: Handler<DeleteResponse> =
+            jsonHandler<DeleteResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: TagRemoveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<DeleteResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("tag", params.tag().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("contacts", params._pathParam(0), "tags", params._pathParam(1))
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { removeHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconService.kt
new file mode 100644
index 0000000..ba6c8e6
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconService.kt
@@ -0,0 +1,167 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.icon.GroupIcon
+import com.blooio.api.models.groups.icon.IconRemoveParams
+import com.blooio.api.models.groups.icon.IconSetParams
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage contact groups */
+interface IconService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconService
+
+    /**
+     * Remove the group icon/photo. Requires the group to have a linked chat_guid.
+     *
+     * The icon is removed from both Blooio storage and the linked iMessage chat before the request
+     * returns.
+     */
+    fun remove(groupId: String): GroupIcon = remove(groupId, IconRemoveParams.none())
+
+    /** @see remove */
+    fun remove(
+        groupId: String,
+        params: IconRemoveParams = IconRemoveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupIcon = remove(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(groupId: String, params: IconRemoveParams = IconRemoveParams.none()): GroupIcon =
+        remove(groupId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: IconRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupIcon
+
+    /** @see remove */
+    fun remove(params: IconRemoveParams): GroupIcon = remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(groupId: String, requestOptions: RequestOptions): GroupIcon =
+        remove(groupId, IconRemoveParams.none(), requestOptions)
+
+    /**
+     * Set the group icon/photo. Requires the group to have a linked chat_guid. Uses
+     * multipart/form-data.
+     *
+     * The uploaded image is stored in Blooio storage and synced to the linked iMessage chat before
+     * the request returns.
+     */
+    fun set(groupId: String, params: IconSetParams): GroupIcon =
+        set(groupId, params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        groupId: String,
+        params: IconSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupIcon = set(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see set */
+    fun set(params: IconSetParams): GroupIcon = set(params, RequestOptions.none())
+
+    /** @see set */
+    fun set(
+        params: IconSetParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): GroupIcon
+
+    /** A view of [IconService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}/icon`, but is otherwise the
+         * same as [IconService.remove].
+         */
+        @MustBeClosed
+        fun remove(groupId: String): HttpResponseFor<GroupIcon> =
+            remove(groupId, IconRemoveParams.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            groupId: String,
+            params: IconRemoveParams = IconRemoveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupIcon> =
+            remove(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            groupId: String,
+            params: IconRemoveParams = IconRemoveParams.none(),
+        ): HttpResponseFor<GroupIcon> = remove(groupId, params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            params: IconRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupIcon>
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(params: IconRemoveParams): HttpResponseFor<GroupIcon> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(groupId: String, requestOptions: RequestOptions): HttpResponseFor<GroupIcon> =
+            remove(groupId, IconRemoveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /groups/{groupId}/icon`, but is otherwise the same
+         * as [IconService.set].
+         */
+        @MustBeClosed
+        fun set(groupId: String, params: IconSetParams): HttpResponseFor<GroupIcon> =
+            set(groupId, params, RequestOptions.none())
+
+        /** @see set */
+        @MustBeClosed
+        fun set(
+            groupId: String,
+            params: IconSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupIcon> =
+            set(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see set */
+        @MustBeClosed
+        fun set(params: IconSetParams): HttpResponseFor<GroupIcon> =
+            set(params, RequestOptions.none())
+
+        /** @see set */
+        @MustBeClosed
+        fun set(
+            params: IconSetParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<GroupIcon>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconServiceImpl.kt
new file mode 100644
index 0000000..a4d3917
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/IconServiceImpl.kt
@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.multipartFormData
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.groups.icon.GroupIcon
+import com.blooio.api.models.groups.icon.IconRemoveParams
+import com.blooio.api.models.groups.icon.IconSetParams
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage contact groups */
+class IconServiceImpl internal constructor(private val clientOptions: ClientOptions) : IconService {
+
+    private val withRawResponse: IconService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): IconService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): IconService =
+        IconServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun remove(params: IconRemoveParams, requestOptions: RequestOptions): GroupIcon =
+        // delete /groups/{groupId}/icon
+        withRawResponse().remove(params, requestOptions).parse()
+
+    override fun set(params: IconSetParams, requestOptions: RequestOptions): GroupIcon =
+        // post /groups/{groupId}/icon
+        withRawResponse().set(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        IconService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): IconService.WithRawResponse =
+            IconServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val removeHandler: Handler<GroupIcon> =
+            jsonHandler<GroupIcon>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: IconRemoveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupIcon> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "icon")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { removeHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val setHandler: Handler<GroupIcon> =
+            jsonHandler<GroupIcon>(clientOptions.jsonMapper)
+
+        override fun set(
+            params: IconSetParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<GroupIcon> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "icon")
+                    .body(multipartFormData(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { setHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberService.kt
new file mode 100644
index 0000000..c564444
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberService.kt
@@ -0,0 +1,228 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberAddResponse
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberListResponse
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import com.blooio.api.models.groups.members.MemberRemoveResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage group membership */
+interface MemberService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): MemberService
+
+    /** List all members of a group. */
+    fun list(groupId: String): MemberListResponse = list(groupId, MemberListParams.none())
+
+    /** @see list */
+    fun list(
+        groupId: String,
+        params: MemberListParams = MemberListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberListResponse = list(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        groupId: String,
+        params: MemberListParams = MemberListParams.none(),
+    ): MemberListResponse = list(groupId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: MemberListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberListResponse
+
+    /** @see list */
+    fun list(params: MemberListParams): MemberListResponse = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(groupId: String, requestOptions: RequestOptions): MemberListResponse =
+        list(groupId, MemberListParams.none(), requestOptions)
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Add an existing contact to a group. If the group is linked to an existing iMessage chat, also
+     * adds the participant to that chat.
+     */
+    fun add(groupId: String, params: MemberAddParams): MemberAddResponse =
+        add(groupId, params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        groupId: String,
+        params: MemberAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberAddResponse = add(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+    /** @see add */
+    fun add(params: MemberAddParams): MemberAddResponse = add(params, RequestOptions.none())
+
+    /** @see add */
+    fun add(
+        params: MemberAddParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberAddResponse
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Remove a contact from a group. If the group is linked to an existing iMessage chat, also
+     * removes the participant from that chat. If the contact being removed is the organization's
+     * own phone number, leaves the group chat instead.
+     */
+    fun remove(contactId: String, params: MemberRemoveParams): MemberRemoveResponse =
+        remove(contactId, params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        contactId: String,
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberRemoveResponse =
+        remove(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+    /** @see remove */
+    fun remove(params: MemberRemoveParams): MemberRemoveResponse =
+        remove(params, RequestOptions.none())
+
+    /** @see remove */
+    fun remove(
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): MemberRemoveResponse
+
+    /** A view of [MemberService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): MemberService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /groups/{groupId}/members`, but is otherwise the
+         * same as [MemberService.list].
+         */
+        @MustBeClosed
+        fun list(groupId: String): HttpResponseFor<MemberListResponse> =
+            list(groupId, MemberListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            groupId: String,
+            params: MemberListParams = MemberListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberListResponse> =
+            list(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            groupId: String,
+            params: MemberListParams = MemberListParams.none(),
+        ): HttpResponseFor<MemberListResponse> = list(groupId, params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: MemberListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(params: MemberListParams): HttpResponseFor<MemberListResponse> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            groupId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MemberListResponse> =
+            list(groupId, MemberListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /groups/{groupId}/members`, but is otherwise the
+         * same as [MemberService.add].
+         */
+        @MustBeClosed
+        fun add(groupId: String, params: MemberAddParams): HttpResponseFor<MemberAddResponse> =
+            add(groupId, params, RequestOptions.none())
+
+        /** @see add */
+        @MustBeClosed
+        fun add(
+            groupId: String,
+            params: MemberAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberAddResponse> =
+            add(params.toBuilder().groupId(groupId).build(), requestOptions)
+
+        /** @see add */
+        @MustBeClosed
+        fun add(params: MemberAddParams): HttpResponseFor<MemberAddResponse> =
+            add(params, RequestOptions.none())
+
+        /** @see add */
+        @MustBeClosed
+        fun add(
+            params: MemberAddParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberAddResponse>
+
+        /**
+         * Returns a raw HTTP response for `delete /groups/{groupId}/members/{contactId}`, but is
+         * otherwise the same as [MemberService.remove].
+         */
+        @MustBeClosed
+        fun remove(
+            contactId: String,
+            params: MemberRemoveParams,
+        ): HttpResponseFor<MemberRemoveResponse> = remove(contactId, params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            contactId: String,
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberRemoveResponse> =
+            remove(params.toBuilder().contactId(contactId).build(), requestOptions)
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(params: MemberRemoveParams): HttpResponseFor<MemberRemoveResponse> =
+            remove(params, RequestOptions.none())
+
+        /** @see remove */
+        @MustBeClosed
+        fun remove(
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<MemberRemoveResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberServiceImpl.kt
new file mode 100644
index 0000000..cedb4a9
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/groups/MemberServiceImpl.kt
@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberAddResponse
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberListResponse
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import com.blooio.api.models.groups.members.MemberRemoveResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage group membership */
+class MemberServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    MemberService {
+
+    private val withRawResponse: MemberService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): MemberService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): MemberService =
+        MemberServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: MemberListParams,
+        requestOptions: RequestOptions,
+    ): MemberListResponse =
+        // get /groups/{groupId}/members
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun add(params: MemberAddParams, requestOptions: RequestOptions): MemberAddResponse =
+        // post /groups/{groupId}/members
+        withRawResponse().add(params, requestOptions).parse()
+
+    override fun remove(
+        params: MemberRemoveParams,
+        requestOptions: RequestOptions,
+    ): MemberRemoveResponse =
+        // delete /groups/{groupId}/members/{contactId}
+        withRawResponse().remove(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        MemberService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): MemberService.WithRawResponse =
+            MemberServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<MemberListResponse> =
+            jsonHandler<MemberListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: MemberListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MemberListResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "members")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val addHandler: Handler<MemberAddResponse> =
+            jsonHandler<MemberAddResponse>(clientOptions.jsonMapper)
+
+        override fun add(
+            params: MemberAddParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MemberAddResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("groupId", params.groupId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("groups", params._pathParam(0), "members")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { addHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val removeHandler: Handler<MemberRemoveResponse> =
+            jsonHandler<MemberRemoveResponse>(clientOptions.jsonMapper)
+
+        override fun remove(
+            params: MemberRemoveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<MemberRemoveResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("contactId", params.contactId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "groups",
+                        params._pathParam(0),
+                        "members",
+                        params._pathParam(1),
+                    )
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { removeHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactService.kt
new file mode 100644
index 0000000..8935132
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactService.kt
@@ -0,0 +1,208 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.location
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.location.contacts.ContactListParams
+import com.blooio.api.models.location.contacts.ContactListResponse
+import com.blooio.api.models.location.contacts.ContactLocation
+import com.blooio.api.models.location.contacts.ContactRefreshParams
+import com.blooio.api.models.location.contacts.ContactRefreshResponse
+import com.blooio.api.models.location.contacts.ContactRetrieveParams
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** FindMy contact location tracking */
+interface ContactService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService
+
+    /** Returns the cached location for a specific contact identified by phone number or email. */
+    fun retrieve(handle: String): ContactLocation = retrieve(handle, ContactRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        handle: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactLocation = retrieve(params.toBuilder().handle(handle).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        handle: String,
+        params: ContactRetrieveParams = ContactRetrieveParams.none(),
+    ): ContactLocation = retrieve(handle, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactLocation
+
+    /** @see retrieve */
+    fun retrieve(params: ContactRetrieveParams): ContactLocation =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(handle: String, requestOptions: RequestOptions): ContactLocation =
+        retrieve(handle, ContactRetrieveParams.none(), requestOptions)
+
+    /**
+     * Returns cached FindMy contact locations available through your blooio account. Each entry
+     * includes the contact's handle (phone/email), coordinates, and last update time.
+     */
+    fun list(): ContactListResponse = list(ContactListParams.none())
+
+    /** @see list */
+    fun list(
+        params: ContactListParams = ContactListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactListResponse
+
+    /** @see list */
+    fun list(params: ContactListParams = ContactListParams.none()): ContactListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): ContactListResponse =
+        list(ContactListParams.none(), requestOptions)
+
+    /**
+     * Triggers a refresh of cached FindMy contact locations. Updated results may take 15-20 seconds
+     * to appear.
+     */
+    fun refresh(): ContactRefreshResponse = refresh(ContactRefreshParams.none())
+
+    /** @see refresh */
+    fun refresh(
+        params: ContactRefreshParams = ContactRefreshParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactRefreshResponse
+
+    /** @see refresh */
+    fun refresh(
+        params: ContactRefreshParams = ContactRefreshParams.none()
+    ): ContactRefreshResponse = refresh(params, RequestOptions.none())
+
+    /** @see refresh */
+    fun refresh(requestOptions: RequestOptions): ContactRefreshResponse =
+        refresh(ContactRefreshParams.none(), requestOptions)
+
+    /** A view of [ContactService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /location/contacts/{handle}`, but is otherwise the
+         * same as [ContactService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(handle: String): HttpResponseFor<ContactLocation> =
+            retrieve(handle, ContactRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            handle: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactLocation> =
+            retrieve(params.toBuilder().handle(handle).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            handle: String,
+            params: ContactRetrieveParams = ContactRetrieveParams.none(),
+        ): HttpResponseFor<ContactLocation> = retrieve(handle, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactLocation>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: ContactRetrieveParams): HttpResponseFor<ContactLocation> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            handle: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactLocation> =
+            retrieve(handle, ContactRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /location/contacts`, but is otherwise the same as
+         * [ContactService.list].
+         */
+        @MustBeClosed
+        fun list(): HttpResponseFor<ContactListResponse> = list(ContactListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ContactListParams = ContactListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: ContactListParams = ContactListParams.none()
+        ): HttpResponseFor<ContactListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<ContactListResponse> =
+            list(ContactListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /location/contacts/refresh`, but is otherwise the
+         * same as [ContactService.refresh].
+         */
+        @MustBeClosed
+        fun refresh(): HttpResponseFor<ContactRefreshResponse> =
+            refresh(ContactRefreshParams.none())
+
+        /** @see refresh */
+        @MustBeClosed
+        fun refresh(
+            params: ContactRefreshParams = ContactRefreshParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactRefreshResponse>
+
+        /** @see refresh */
+        @MustBeClosed
+        fun refresh(
+            params: ContactRefreshParams = ContactRefreshParams.none()
+        ): HttpResponseFor<ContactRefreshResponse> = refresh(params, RequestOptions.none())
+
+        /** @see refresh */
+        @MustBeClosed
+        fun refresh(requestOptions: RequestOptions): HttpResponseFor<ContactRefreshResponse> =
+            refresh(ContactRefreshParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactServiceImpl.kt
new file mode 100644
index 0000000..db43bd4
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/location/ContactServiceImpl.kt
@@ -0,0 +1,160 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.location
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.location.contacts.ContactListParams
+import com.blooio.api.models.location.contacts.ContactListResponse
+import com.blooio.api.models.location.contacts.ContactLocation
+import com.blooio.api.models.location.contacts.ContactRefreshParams
+import com.blooio.api.models.location.contacts.ContactRefreshResponse
+import com.blooio.api.models.location.contacts.ContactRetrieveParams
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** FindMy contact location tracking */
+class ContactServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    ContactService {
+
+    private val withRawResponse: ContactService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ContactService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactService =
+        ContactServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: ContactRetrieveParams,
+        requestOptions: RequestOptions,
+    ): ContactLocation =
+        // get /location/contacts/{handle}
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun list(
+        params: ContactListParams,
+        requestOptions: RequestOptions,
+    ): ContactListResponse =
+        // get /location/contacts
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun refresh(
+        params: ContactRefreshParams,
+        requestOptions: RequestOptions,
+    ): ContactRefreshResponse =
+        // post /location/contacts/refresh
+        withRawResponse().refresh(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ContactService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactService.WithRawResponse =
+            ContactServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ContactLocation> =
+            jsonHandler<ContactLocation>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactLocation> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("handle", params.handle().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts", params._pathParam(0))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val listHandler: Handler<ContactListResponse> =
+            jsonHandler<ContactListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: ContactListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val refreshHandler: Handler<ContactRefreshResponse> =
+            jsonHandler<ContactRefreshResponse>(clientOptions.jsonMapper)
+
+        override fun refresh(
+            params: ContactRefreshParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactRefreshResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("location", "contacts", "refresh")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { refreshHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberService.kt
new file mode 100644
index 0000000..3845265
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberService.kt
@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.me.numbers.NumberListParams
+import com.blooio.api.models.me.numbers.NumberListResponse
+import com.blooio.api.services.blocking.me.numbers.ContactCardService
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage phone numbers linked to your account */
+interface NumberService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): NumberService
+
+    /** Manage and share your iMessage contact card (Name & Photo) */
+    fun contactCard(): ContactCardService
+
+    /**
+     * List all phone numbers bound to this API key with their availability status. Use the returned
+     * phone numbers as the `:number` path parameter for other `/me/numbers/` endpoints.
+     */
+    fun list(): NumberListResponse = list(NumberListParams.none())
+
+    /** @see list */
+    fun list(
+        params: NumberListParams = NumberListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): NumberListResponse
+
+    /** @see list */
+    fun list(params: NumberListParams = NumberListParams.none()): NumberListResponse =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(requestOptions: RequestOptions): NumberListResponse =
+        list(NumberListParams.none(), requestOptions)
+
+    /** A view of [NumberService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): NumberService.WithRawResponse
+
+        /** Manage and share your iMessage contact card (Name & Photo) */
+        fun contactCard(): ContactCardService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /me/numbers`, but is otherwise the same as
+         * [NumberService.list].
+         */
+        @MustBeClosed
+        fun list(): HttpResponseFor<NumberListResponse> = list(NumberListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: NumberListParams = NumberListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<NumberListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: NumberListParams = NumberListParams.none()
+        ): HttpResponseFor<NumberListResponse> = list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(requestOptions: RequestOptions): HttpResponseFor<NumberListResponse> =
+            list(NumberListParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberServiceImpl.kt
new file mode 100644
index 0000000..8b34c4a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/NumberServiceImpl.kt
@@ -0,0 +1,95 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.me.numbers.NumberListParams
+import com.blooio.api.models.me.numbers.NumberListResponse
+import com.blooio.api.services.blocking.me.numbers.ContactCardService
+import com.blooio.api.services.blocking.me.numbers.ContactCardServiceImpl
+import java.util.function.Consumer
+
+/** Manage phone numbers linked to your account */
+class NumberServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    NumberService {
+
+    private val withRawResponse: NumberService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val contactCard: ContactCardService by lazy { ContactCardServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): NumberService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): NumberService =
+        NumberServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    /** Manage and share your iMessage contact card (Name & Photo) */
+    override fun contactCard(): ContactCardService = contactCard
+
+    override fun list(
+        params: NumberListParams,
+        requestOptions: RequestOptions,
+    ): NumberListResponse =
+        // get /me/numbers
+        withRawResponse().list(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        NumberService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val contactCard: ContactCardService.WithRawResponse by lazy {
+            ContactCardServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): NumberService.WithRawResponse =
+            NumberServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        /** Manage and share your iMessage contact card (Name & Photo) */
+        override fun contactCard(): ContactCardService.WithRawResponse = contactCard
+
+        private val listHandler: Handler<NumberListResponse> =
+            jsonHandler<NumberListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: NumberListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<NumberListResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
new file mode 100644
index 0000000..702a821
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
@@ -0,0 +1,206 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me.numbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveResponse
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage and share your iMessage contact card (Name & Photo) */
+interface ContactCardService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactCardService
+
+    /**
+     * ⚠️ **COMING SOON** - This endpoint is temporarily disabled while we stabilize this feature.
+     *
+     * Get the personal contact card (Name & Photo) for the specified phone number. This is the
+     * identity that gets shared with contacts in iMessage.
+     */
+    fun retrieve(number: String): ContactCardRetrieveResponse =
+        retrieve(number, ContactCardRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        number: String,
+        params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactCardRetrieveResponse =
+        retrieve(params.toBuilder().number(number).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        number: String,
+        params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+    ): ContactCardRetrieveResponse = retrieve(number, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ContactCardRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactCardRetrieveResponse
+
+    /** @see retrieve */
+    fun retrieve(params: ContactCardRetrieveParams): ContactCardRetrieveResponse =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(number: String, requestOptions: RequestOptions): ContactCardRetrieveResponse =
+        retrieve(number, ContactCardRetrieveParams.none(), requestOptions)
+
+    /**
+     * Update the personal contact card (Name & Photo) for the specified phone number. All fields
+     * are optional — only provided fields are updated.
+     */
+    fun update(number: String): ContactCardUpdateResponse =
+        update(number, ContactCardUpdateParams.none())
+
+    /** @see update */
+    fun update(
+        number: String,
+        params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactCardUpdateResponse = update(params.toBuilder().number(number).build(), requestOptions)
+
+    /** @see update */
+    fun update(
+        number: String,
+        params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+    ): ContactCardUpdateResponse = update(number, params, RequestOptions.none())
+
+    /** @see update */
+    fun update(
+        params: ContactCardUpdateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): ContactCardUpdateResponse
+
+    /** @see update */
+    fun update(params: ContactCardUpdateParams): ContactCardUpdateResponse =
+        update(params, RequestOptions.none())
+
+    /** @see update */
+    fun update(number: String, requestOptions: RequestOptions): ContactCardUpdateResponse =
+        update(number, ContactCardUpdateParams.none(), requestOptions)
+
+    /**
+     * A view of [ContactCardService] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactCardService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /me/numbers/{number}/contact-card`, but is otherwise
+         * the same as [ContactCardService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(number: String): HttpResponseFor<ContactCardRetrieveResponse> =
+            retrieve(number, ContactCardRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            number: String,
+            params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactCardRetrieveResponse> =
+            retrieve(params.toBuilder().number(number).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            number: String,
+            params: ContactCardRetrieveParams = ContactCardRetrieveParams.none(),
+        ): HttpResponseFor<ContactCardRetrieveResponse> =
+            retrieve(number, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ContactCardRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactCardRetrieveResponse>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ContactCardRetrieveParams
+        ): HttpResponseFor<ContactCardRetrieveResponse> = retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            number: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactCardRetrieveResponse> =
+            retrieve(number, ContactCardRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `put /me/numbers/{number}/contact-card`, but is otherwise
+         * the same as [ContactCardService.update].
+         */
+        @MustBeClosed
+        fun update(number: String): HttpResponseFor<ContactCardUpdateResponse> =
+            update(number, ContactCardUpdateParams.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            number: String,
+            params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactCardUpdateResponse> =
+            update(params.toBuilder().number(number).build(), requestOptions)
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            number: String,
+            params: ContactCardUpdateParams = ContactCardUpdateParams.none(),
+        ): HttpResponseFor<ContactCardUpdateResponse> =
+            update(number, params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            params: ContactCardUpdateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<ContactCardUpdateResponse>
+
+        /** @see update */
+        @MustBeClosed
+        fun update(params: ContactCardUpdateParams): HttpResponseFor<ContactCardUpdateResponse> =
+            update(params, RequestOptions.none())
+
+        /** @see update */
+        @MustBeClosed
+        fun update(
+            number: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactCardUpdateResponse> =
+            update(number, ContactCardUpdateParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceImpl.kt
new file mode 100644
index 0000000..38a4a0e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceImpl.kt
@@ -0,0 +1,127 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me.numbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardRetrieveResponse
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage and share your iMessage contact card (Name & Photo) */
+class ContactCardServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    ContactCardService {
+
+    private val withRawResponse: ContactCardService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ContactCardService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ContactCardService =
+        ContactCardServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun retrieve(
+        params: ContactCardRetrieveParams,
+        requestOptions: RequestOptions,
+    ): ContactCardRetrieveResponse =
+        // get /me/numbers/{number}/contact-card
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun update(
+        params: ContactCardUpdateParams,
+        requestOptions: RequestOptions,
+    ): ContactCardUpdateResponse =
+        // put /me/numbers/{number}/contact-card
+        withRawResponse().update(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ContactCardService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ContactCardService.WithRawResponse =
+            ContactCardServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val retrieveHandler: Handler<ContactCardRetrieveResponse> =
+            jsonHandler<ContactCardRetrieveResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ContactCardRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactCardRetrieveResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("number", params.number().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers", params._pathParam(0), "contact-card")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val updateHandler: Handler<ContactCardUpdateResponse> =
+            jsonHandler<ContactCardUpdateResponse>(clientOptions.jsonMapper)
+
+        override fun update(
+            params: ContactCardUpdateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<ContactCardUpdateResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("number", params.number().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.PUT)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("me", "numbers", params._pathParam(0), "contact-card")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { updateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupService.kt
new file mode 100644
index 0000000..549eb8f
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupService.kt
@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.phonenumbers
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+interface LookupService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LookupService
+
+    /**
+     * Same as the GET endpoint, but accepts the phone number in the request body. Useful when the
+     * number contains characters that are difficult to URL-encode.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise).
+     */
+    fun create(params: LookupCreateParams): PhoneNumberLookupResult =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(
+        params: LookupCreateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PhoneNumberLookupResult
+
+    /**
+     * Returns detailed information about a phone number including validation, formatting (E.164,
+     * national, international), number type, and NANPA geocoding (city, state/province) for North
+     * American numbers. The geocoding data is sourced from different database with 240,000+ NPA-NXX
+     * entries.
+     *
+     * **Requires an Enterprise plan** (Dedicated Enterprise). Returns 403 if your organization does
+     * not have an active enterprise subscription.
+     */
+    fun retrieve(params: LookupRetrieveParams): PhoneNumberLookupResult =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: LookupRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): PhoneNumberLookupResult
+
+    /** A view of [LookupService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): LookupService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /phone-numbers/lookup`, but is otherwise the same
+         * as [LookupService.create].
+         */
+        @MustBeClosed
+        fun create(params: LookupCreateParams): HttpResponseFor<PhoneNumberLookupResult> =
+            create(params, RequestOptions.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: LookupCreateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PhoneNumberLookupResult>
+
+        /**
+         * Returns a raw HTTP response for `get /phone-numbers/lookup`, but is otherwise the same as
+         * [LookupService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(params: LookupRetrieveParams): HttpResponseFor<PhoneNumberLookupResult> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: LookupRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<PhoneNumberLookupResult>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceImpl.kt
similarity index 61%
rename from blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt
rename to blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceImpl.kt
index 28c3071..1dd7da6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/config/WebhookServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceImpl.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.services.blocking.config
+package com.blooio.api.services.blocking.phonenumbers
 
 import com.blooio.api.core.ClientOptions
 import com.blooio.api.core.RequestOptions
@@ -15,71 +15,74 @@ import com.blooio.api.core.http.HttpResponseFor
 import com.blooio.api.core.http.json
 import com.blooio.api.core.http.parseable
 import com.blooio.api.core.prepare
-import com.blooio.api.models.config.webhook.WebhookRetrieveParams
-import com.blooio.api.models.config.webhook.WebhookRetrieveResponse
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import com.blooio.api.models.config.webhook.WebhookUpdateResponse
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
 import java.util.function.Consumer
 
-/** Account-level configuration */
-class WebhookServiceImpl internal constructor(private val clientOptions: ClientOptions) :
-    WebhookService {
+/**
+ * Phone number validation, formatting, and NANPA geocoding. Requires an Enterprise plan (Dedicated
+ * Enterprise).
+ */
+class LookupServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    LookupService {
 
-    private val withRawResponse: WebhookService.WithRawResponse by lazy {
+    private val withRawResponse: LookupService.WithRawResponse by lazy {
         WithRawResponseImpl(clientOptions)
     }
 
-    override fun withRawResponse(): WebhookService.WithRawResponse = withRawResponse
+    override fun withRawResponse(): LookupService.WithRawResponse = withRawResponse
 
-    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): WebhookService =
-        WebhookServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LookupService =
+        LookupServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    override fun retrieve(
-        params: WebhookRetrieveParams,
+    override fun create(
+        params: LookupCreateParams,
         requestOptions: RequestOptions,
-    ): WebhookRetrieveResponse =
-        // get /v1/api/config/webhook
-        withRawResponse().retrieve(params, requestOptions).parse()
+    ): PhoneNumberLookupResult =
+        // post /phone-numbers/lookup
+        withRawResponse().create(params, requestOptions).parse()
 
-    override fun update(
-        params: WebhookUpdateParams,
+    override fun retrieve(
+        params: LookupRetrieveParams,
         requestOptions: RequestOptions,
-    ): WebhookUpdateResponse =
-        // put /v1/api/config/webhook
-        withRawResponse().update(params, requestOptions).parse()
+    ): PhoneNumberLookupResult =
+        // get /phone-numbers/lookup
+        withRawResponse().retrieve(params, requestOptions).parse()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
-        WebhookService.WithRawResponse {
+        LookupService.WithRawResponse {
 
         private val errorHandler: Handler<HttpResponse> =
             errorHandler(errorBodyHandler(clientOptions.jsonMapper))
 
         override fun withOptions(
             modifier: Consumer<ClientOptions.Builder>
-        ): WebhookService.WithRawResponse =
-            WebhookServiceImpl.WithRawResponseImpl(
+        ): LookupService.WithRawResponse =
+            LookupServiceImpl.WithRawResponseImpl(
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        private val retrieveHandler: Handler<WebhookRetrieveResponse> =
-            jsonHandler<WebhookRetrieveResponse>(clientOptions.jsonMapper)
+        private val createHandler: Handler<PhoneNumberLookupResult> =
+            jsonHandler<PhoneNumberLookupResult>(clientOptions.jsonMapper)
 
-        override fun retrieve(
-            params: WebhookRetrieveParams,
+        override fun create(
+            params: LookupCreateParams,
             requestOptions: RequestOptions,
-        ): HttpResponseFor<WebhookRetrieveResponse> {
+        ): HttpResponseFor<PhoneNumberLookupResult> {
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.GET)
+                    .method(HttpMethod.POST)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "config", "webhook")
+                    .addPathSegments("phone-numbers", "lookup")
+                    .body(json(clientOptions.jsonMapper, params._body()))
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
             val response = clientOptions.httpClient.execute(request, requestOptions)
             return errorHandler.handle(response).parseable {
                 response
-                    .use { retrieveHandler.handle(it) }
+                    .use { createHandler.handle(it) }
                     .also {
                         if (requestOptions.responseValidation!!) {
                             it.validate()
@@ -88,26 +91,25 @@ class WebhookServiceImpl internal constructor(private val clientOptions: ClientO
             }
         }
 
-        private val updateHandler: Handler<WebhookUpdateResponse> =
-            jsonHandler<WebhookUpdateResponse>(clientOptions.jsonMapper)
+        private val retrieveHandler: Handler<PhoneNumberLookupResult> =
+            jsonHandler<PhoneNumberLookupResult>(clientOptions.jsonMapper)
 
-        override fun update(
-            params: WebhookUpdateParams,
+        override fun retrieve(
+            params: LookupRetrieveParams,
             requestOptions: RequestOptions,
-        ): HttpResponseFor<WebhookUpdateResponse> {
+        ): HttpResponseFor<PhoneNumberLookupResult> {
             val request =
                 HttpRequest.builder()
-                    .method(HttpMethod.PUT)
+                    .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
-                    .addPathSegments("v1", "api", "config", "webhook")
-                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .addPathSegments("phone-numbers", "lookup")
                     .build()
                     .prepare(clientOptions, params)
             val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
             val response = clientOptions.httpClient.execute(request, requestOptions)
             return errorHandler.handle(response).parseable {
                 response
-                    .use { updateHandler.handle(it) }
+                    .use { retrieveHandler.handle(it) }
                     .also {
                         if (requestOptions.responseValidation!!) {
                             it.validate()
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogService.kt
new file mode 100644
index 0000000..36c47bd
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogService.kt
@@ -0,0 +1,159 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogListResponse
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import com.blooio.api.models.webhooks.logs.LogReplayResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** View and replay webhook deliveries */
+interface LogService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogService
+
+    /** List delivery logs for a specific webhook. */
+    fun list(webhookId: String): LogListResponse = list(webhookId, LogListParams.none())
+
+    /** @see list */
+    fun list(
+        webhookId: String,
+        params: LogListParams = LogListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): LogListResponse = list(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see list */
+    fun list(webhookId: String, params: LogListParams = LogListParams.none()): LogListResponse =
+        list(webhookId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: LogListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): LogListResponse
+
+    /** @see list */
+    fun list(params: LogListParams): LogListResponse = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(webhookId: String, requestOptions: RequestOptions): LogListResponse =
+        list(webhookId, LogListParams.none(), requestOptions)
+
+    /** Re-send a webhook event to the configured URL. */
+    fun replay(eventId: String, params: LogReplayParams): LogReplayResponse =
+        replay(eventId, params, RequestOptions.none())
+
+    /** @see replay */
+    fun replay(
+        eventId: String,
+        params: LogReplayParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): LogReplayResponse = replay(params.toBuilder().eventId(eventId).build(), requestOptions)
+
+    /** @see replay */
+    fun replay(params: LogReplayParams): LogReplayResponse = replay(params, RequestOptions.none())
+
+    /** @see replay */
+    fun replay(
+        params: LogReplayParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): LogReplayResponse
+
+    /** A view of [LogService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /webhooks/{webhookId}/logs`, but is otherwise the
+         * same as [LogService.list].
+         */
+        @MustBeClosed
+        fun list(webhookId: String): HttpResponseFor<LogListResponse> =
+            list(webhookId, LogListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            webhookId: String,
+            params: LogListParams = LogListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<LogListResponse> =
+            list(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            webhookId: String,
+            params: LogListParams = LogListParams.none(),
+        ): HttpResponseFor<LogListResponse> = list(webhookId, params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: LogListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<LogListResponse>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(params: LogListParams): HttpResponseFor<LogListResponse> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<LogListResponse> = list(webhookId, LogListParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks/{webhookId}/logs/{eventId}/replay`, but
+         * is otherwise the same as [LogService.replay].
+         */
+        @MustBeClosed
+        fun replay(eventId: String, params: LogReplayParams): HttpResponseFor<LogReplayResponse> =
+            replay(eventId, params, RequestOptions.none())
+
+        /** @see replay */
+        @MustBeClosed
+        fun replay(
+            eventId: String,
+            params: LogReplayParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<LogReplayResponse> =
+            replay(params.toBuilder().eventId(eventId).build(), requestOptions)
+
+        /** @see replay */
+        @MustBeClosed
+        fun replay(params: LogReplayParams): HttpResponseFor<LogReplayResponse> =
+            replay(params, RequestOptions.none())
+
+        /** @see replay */
+        @MustBeClosed
+        fun replay(
+            params: LogReplayParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<LogReplayResponse>
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceImpl.kt
new file mode 100644
index 0000000..e9f90ef
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceImpl.kt
@@ -0,0 +1,129 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogListResponse
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import com.blooio.api.models.webhooks.logs.LogReplayResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** View and replay webhook deliveries */
+class LogServiceImpl internal constructor(private val clientOptions: ClientOptions) : LogService {
+
+    private val withRawResponse: LogService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): LogService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): LogService =
+        LogServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(params: LogListParams, requestOptions: RequestOptions): LogListResponse =
+        // get /webhooks/{webhookId}/logs
+        withRawResponse().list(params, requestOptions).parse()
+
+    override fun replay(
+        params: LogReplayParams,
+        requestOptions: RequestOptions,
+    ): LogReplayResponse =
+        // post /webhooks/{webhookId}/logs/{eventId}/replay
+        withRawResponse().replay(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        LogService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): LogService.WithRawResponse =
+            LogServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<LogListResponse> =
+            jsonHandler<LogListResponse>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: LogListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<LogListResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0), "logs")
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val replayHandler: Handler<LogReplayResponse> =
+            jsonHandler<LogReplayResponse>(clientOptions.jsonMapper)
+
+        override fun replay(
+            params: LogReplayParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<LogReplayResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("eventId", params.eventId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments(
+                        "webhooks",
+                        params._pathParam(0),
+                        "logs",
+                        params._pathParam(1),
+                        "replay",
+                    )
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { replayHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretService.kt
new file mode 100644
index 0000000..12ba1c8
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretService.kt
@@ -0,0 +1,117 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.models.webhooks.secret.SecretRotateParams
+import com.blooio.api.models.webhooks.secret.SecretRotateResponse
+import com.google.errorprone.annotations.MustBeClosed
+import java.util.function.Consumer
+
+/** Manage webhook subscriptions */
+interface SecretService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): SecretService
+
+    /**
+     * Generate a new signing secret for the webhook. The new secret is returned only once in this
+     * response - store it securely. The old secret becomes invalid immediately.
+     */
+    fun rotate(webhookId: String): SecretRotateResponse =
+        rotate(webhookId, SecretRotateParams.none())
+
+    /** @see rotate */
+    fun rotate(
+        webhookId: String,
+        params: SecretRotateParams = SecretRotateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): SecretRotateResponse =
+        rotate(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+    /** @see rotate */
+    fun rotate(
+        webhookId: String,
+        params: SecretRotateParams = SecretRotateParams.none(),
+    ): SecretRotateResponse = rotate(webhookId, params, RequestOptions.none())
+
+    /** @see rotate */
+    fun rotate(
+        params: SecretRotateParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): SecretRotateResponse
+
+    /** @see rotate */
+    fun rotate(params: SecretRotateParams): SecretRotateResponse =
+        rotate(params, RequestOptions.none())
+
+    /** @see rotate */
+    fun rotate(webhookId: String, requestOptions: RequestOptions): SecretRotateResponse =
+        rotate(webhookId, SecretRotateParams.none(), requestOptions)
+
+    /** A view of [SecretService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): SecretService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /webhooks/{webhookId}/secret/rotate`, but is
+         * otherwise the same as [SecretService.rotate].
+         */
+        @MustBeClosed
+        fun rotate(webhookId: String): HttpResponseFor<SecretRotateResponse> =
+            rotate(webhookId, SecretRotateParams.none())
+
+        /** @see rotate */
+        @MustBeClosed
+        fun rotate(
+            webhookId: String,
+            params: SecretRotateParams = SecretRotateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<SecretRotateResponse> =
+            rotate(params.toBuilder().webhookId(webhookId).build(), requestOptions)
+
+        /** @see rotate */
+        @MustBeClosed
+        fun rotate(
+            webhookId: String,
+            params: SecretRotateParams = SecretRotateParams.none(),
+        ): HttpResponseFor<SecretRotateResponse> = rotate(webhookId, params, RequestOptions.none())
+
+        /** @see rotate */
+        @MustBeClosed
+        fun rotate(
+            params: SecretRotateParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<SecretRotateResponse>
+
+        /** @see rotate */
+        @MustBeClosed
+        fun rotate(params: SecretRotateParams): HttpResponseFor<SecretRotateResponse> =
+            rotate(params, RequestOptions.none())
+
+        /** @see rotate */
+        @MustBeClosed
+        fun rotate(
+            webhookId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<SecretRotateResponse> =
+            rotate(webhookId, SecretRotateParams.none(), requestOptions)
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceImpl.kt
new file mode 100644
index 0000000..7fbc54e
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceImpl.kt
@@ -0,0 +1,88 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.handlers.errorBodyHandler
+import com.blooio.api.core.handlers.errorHandler
+import com.blooio.api.core.handlers.jsonHandler
+import com.blooio.api.core.http.HttpMethod
+import com.blooio.api.core.http.HttpRequest
+import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.HttpResponse.Handler
+import com.blooio.api.core.http.HttpResponseFor
+import com.blooio.api.core.http.json
+import com.blooio.api.core.http.parseable
+import com.blooio.api.core.prepare
+import com.blooio.api.models.webhooks.secret.SecretRotateParams
+import com.blooio.api.models.webhooks.secret.SecretRotateResponse
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+/** Manage webhook subscriptions */
+class SecretServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    SecretService {
+
+    private val withRawResponse: SecretService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): SecretService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): SecretService =
+        SecretServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun rotate(
+        params: SecretRotateParams,
+        requestOptions: RequestOptions,
+    ): SecretRotateResponse =
+        // post /webhooks/{webhookId}/secret/rotate
+        withRawResponse().rotate(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        SecretService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): SecretService.WithRawResponse =
+            SecretServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val rotateHandler: Handler<SecretRotateResponse> =
+            jsonHandler<SecretRotateResponse>(clientOptions.jsonMapper)
+
+        override fun rotate(
+            params: SecretRotateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<SecretRotateResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("webhookId", params.webhookId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("webhooks", params._pathParam(0), "secret", "rotate")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(clientOptions, params)
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { rotateHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ClientOptionsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ClientOptionsTest.kt
index e561b69..3d83e40 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/ClientOptionsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/ClientOptionsTest.kt
@@ -16,6 +16,29 @@ internal class ClientOptionsTest {
 
     private val httpClient = mock<HttpClient>()
 
+    @Test
+    fun putHeader_canOverwriteDefaultHeader() {
+        val clientOptions =
+            ClientOptions.builder()
+                .httpClient(httpClient)
+                .putHeader("User-Agent", "My User Agent")
+                .apiKey("My API Key")
+                .build()
+
+        assertThat(clientOptions.headers.values("User-Agent")).containsExactly("My User Agent")
+    }
+
+    @Test
+    fun toBuilder_bearerAuthCanBeUpdated() {
+        var clientOptions =
+            ClientOptions.builder().httpClient(httpClient).apiKey("My API Key").build()
+
+        clientOptions = clientOptions.toBuilder().apiKey("another My API Key").build()
+
+        assertThat(clientOptions.headers.values("Authorization"))
+            .containsExactly("Bearer another My API Key")
+    }
+
     @Test
     fun toBuilder_whenOriginalClientOptionsGarbageCollected_doesNotCloseOriginalClient() {
         var clientOptions =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
index 4b595df..cf04848 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/RetryingHttpClientTest.kt
@@ -20,7 +20,11 @@ import com.github.tomakehurst.wiremock.junit5.WireMockRuntimeInfo
 import com.github.tomakehurst.wiremock.junit5.WireMockTest
 import com.github.tomakehurst.wiremock.stubbing.Scenario
 import java.io.InputStream
+import java.time.Clock
 import java.time.Duration
+import java.time.OffsetDateTime
+import java.time.ZoneOffset
+import java.time.format.DateTimeFormatter
 import java.util.concurrent.CompletableFuture
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.BeforeEach
@@ -36,6 +40,21 @@ internal class RetryingHttpClientTest {
     private lateinit var baseUrl: String
     private lateinit var httpClient: HttpClient
 
+    private class RecordingSleeper : Sleeper {
+        val durations = mutableListOf<Duration>()
+
+        override fun sleep(duration: Duration) {
+            durations.add(duration)
+        }
+
+        override fun sleepAsync(duration: Duration): CompletableFuture<Void> {
+            durations.add(duration)
+            return CompletableFuture.completedFuture(null)
+        }
+
+        override fun close() {}
+    }
+
     @BeforeEach
     fun beforeEach(wmRuntimeInfo: WireMockRuntimeInfo) {
         baseUrl = wmRuntimeInfo.httpBaseUrl
@@ -86,7 +105,8 @@ internal class RetryingHttpClientTest {
     @ValueSource(booleans = [false, true])
     fun execute(async: Boolean) {
         stubFor(post(urlPathEqualTo("/something")).willReturn(ok()))
-        val retryingClient = retryingHttpClientBuilder().build()
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).build()
 
         val response =
             retryingClient.execute(
@@ -100,6 +120,7 @@ internal class RetryingHttpClientTest {
 
         assertThat(response.statusCode()).isEqualTo(200)
         verify(1, postRequestedFor(urlPathEqualTo("/something")))
+        assertThat(sleeper.durations).isEmpty()
         assertNoResponseLeaks()
     }
 
@@ -111,8 +132,12 @@ internal class RetryingHttpClientTest {
                 .withHeader("X-Some-Header", matching("stainless-java-retry-.+"))
                 .willReturn(ok())
         )
+        val sleeper = RecordingSleeper()
         val retryingClient =
-            retryingHttpClientBuilder().maxRetries(2).idempotencyHeader("X-Some-Header").build()
+            retryingHttpClientBuilder(sleeper)
+                .maxRetries(2)
+                .idempotencyHeader("X-Some-Header")
+                .build()
 
         val response =
             retryingClient.execute(
@@ -126,20 +151,20 @@ internal class RetryingHttpClientTest {
 
         assertThat(response.statusCode()).isEqualTo(200)
         verify(1, postRequestedFor(urlPathEqualTo("/something")))
+        assertThat(sleeper.durations).isEmpty()
         assertNoResponseLeaks()
     }
 
     @ParameterizedTest
     @ValueSource(booleans = [false, true])
     fun execute_withRetryAfterHeader(async: Boolean) {
+        val retryAfterDate = "Wed, 21 Oct 2015 07:28:00 GMT"
         stubFor(
             post(urlPathEqualTo("/something"))
                 // First we fail with a retry after header given as a date
                 .inScenario("foo")
                 .whenScenarioStateIs(Scenario.STARTED)
-                .willReturn(
-                    serviceUnavailable().withHeader("Retry-After", "Wed, 21 Oct 2015 07:28:00 GMT")
-                )
+                .willReturn(serviceUnavailable().withHeader("Retry-After", retryAfterDate))
                 .willSetStateTo("RETRY_AFTER_DATE")
         )
         stubFor(
@@ -158,7 +183,13 @@ internal class RetryingHttpClientTest {
                 .willReturn(ok())
                 .willSetStateTo("COMPLETED")
         )
-        val retryingClient = retryingHttpClientBuilder().maxRetries(2).build()
+        // Fix the clock to 5 seconds before the Retry-After date so the date-based backoff is
+        // deterministic.
+        val retryAfterDateTime =
+            OffsetDateTime.parse(retryAfterDate, DateTimeFormatter.RFC_1123_DATE_TIME)
+        val clock = Clock.fixed(retryAfterDateTime.minusSeconds(5).toInstant(), ZoneOffset.UTC)
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper, clock).maxRetries(2).build()
 
         val response =
             retryingClient.execute(
@@ -186,19 +217,20 @@ internal class RetryingHttpClientTest {
             postRequestedFor(urlPathEqualTo("/something"))
                 .withHeader("x-stainless-retry-count", equalTo("2")),
         )
+        assertThat(sleeper.durations)
+            .containsExactly(Duration.ofSeconds(5), Duration.ofMillis(1234))
         assertNoResponseLeaks()
     }
 
     @ParameterizedTest
     @ValueSource(booleans = [false, true])
     fun execute_withOverwrittenRetryCountHeader(async: Boolean) {
+        val retryAfterDate = "Wed, 21 Oct 2015 07:28:00 GMT"
         stubFor(
             post(urlPathEqualTo("/something"))
                 .inScenario("foo") // first we fail with a retry after header given as a date
                 .whenScenarioStateIs(Scenario.STARTED)
-                .willReturn(
-                    serviceUnavailable().withHeader("Retry-After", "Wed, 21 Oct 2015 07:28:00 GMT")
-                )
+                .willReturn(serviceUnavailable().withHeader("Retry-After", retryAfterDate))
                 .willSetStateTo("RETRY_AFTER_DATE")
         )
         stubFor(
@@ -208,7 +240,11 @@ internal class RetryingHttpClientTest {
                 .willReturn(ok())
                 .willSetStateTo("COMPLETED")
         )
-        val retryingClient = retryingHttpClientBuilder().maxRetries(2).build()
+        val retryAfterDateTime =
+            OffsetDateTime.parse(retryAfterDate, DateTimeFormatter.RFC_1123_DATE_TIME)
+        val clock = Clock.fixed(retryAfterDateTime.minusSeconds(5).toInstant(), ZoneOffset.UTC)
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper, clock).maxRetries(2).build()
 
         val response =
             retryingClient.execute(
@@ -227,6 +263,7 @@ internal class RetryingHttpClientTest {
             postRequestedFor(urlPathEqualTo("/something"))
                 .withHeader("x-stainless-retry-count", equalTo("42")),
         )
+        assertThat(sleeper.durations).containsExactly(Duration.ofSeconds(5))
         assertNoResponseLeaks()
     }
 
@@ -247,7 +284,8 @@ internal class RetryingHttpClientTest {
                 .willReturn(ok())
                 .willSetStateTo("COMPLETED")
         )
-        val retryingClient = retryingHttpClientBuilder().maxRetries(1).build()
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).maxRetries(1).build()
 
         val response =
             retryingClient.execute(
@@ -261,6 +299,7 @@ internal class RetryingHttpClientTest {
 
         assertThat(response.statusCode()).isEqualTo(200)
         verify(2, postRequestedFor(urlPathEqualTo("/something")))
+        assertThat(sleeper.durations).containsExactly(Duration.ofMillis(10))
         assertNoResponseLeaks()
     }
 
@@ -301,21 +340,12 @@ internal class RetryingHttpClientTest {
                 override fun close() = httpClient.close()
             }
 
+        val sleeper = RecordingSleeper()
         val retryingClient =
             RetryingHttpClient.builder()
                 .httpClient(failingHttpClient)
                 .maxRetries(2)
-                .sleeper(
-                    object : Sleeper {
-
-                        override fun sleep(duration: Duration) {}
-
-                        override fun sleepAsync(duration: Duration): CompletableFuture<Void> =
-                            CompletableFuture.completedFuture(null)
-
-                        override fun close() {}
-                    }
-                )
+                .sleeper(sleeper)
                 .build()
 
         val response =
@@ -339,25 +369,153 @@ internal class RetryingHttpClientTest {
             postRequestedFor(urlPathEqualTo("/something"))
                 .withHeader("x-stainless-retry-count", equalTo("0")),
         )
+        // Exponential backoff with jitter: 0.5s * jitter where jitter is in [0.75, 1.0].
+        assertThat(sleeper.durations).hasSize(1)
+        assertThat(sleeper.durations[0]).isBetween(Duration.ofMillis(375), Duration.ofMillis(500))
         assertNoResponseLeaks()
     }
 
-    private fun retryingHttpClientBuilder() =
-        RetryingHttpClient.builder()
-            .httpClient(httpClient)
-            // Use a no-op `Sleeper` to make the test fast.
-            .sleeper(
-                object : Sleeper {
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun execute_withExponentialBackoff(async: Boolean) {
+        stubFor(post(urlPathEqualTo("/something")).willReturn(serviceUnavailable()))
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).maxRetries(3).build()
+
+        val response =
+            retryingClient.execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(baseUrl)
+                    .addPathSegment("something")
+                    .build(),
+                async,
+            )
 
-                    override fun sleep(duration: Duration) {}
+        // All retries exhausted; the last 503 response is returned.
+        assertThat(response.statusCode()).isEqualTo(503)
+        verify(4, postRequestedFor(urlPathEqualTo("/something")))
+        // Exponential backoff with jitter: backoff = min(0.5 * 2^(retries-1), 8) * jitter where
+        // jitter is in [0.75, 1.0].
+        assertThat(sleeper.durations).hasSize(3)
+        // retries=1: 0.5s * [0.75, 1.0]
+        assertThat(sleeper.durations[0]).isBetween(Duration.ofMillis(375), Duration.ofMillis(500))
+        // retries=2: 1s * [0.75, 1.0]
+        assertThat(sleeper.durations[1]).isBetween(Duration.ofMillis(750), Duration.ofMillis(1000))
+        // retries=3: 2s * [0.75, 1.0]
+        assertThat(sleeper.durations[2]).isBetween(Duration.ofMillis(1500), Duration.ofMillis(2000))
+        assertNoResponseLeaks()
+    }
 
-                    override fun sleepAsync(duration: Duration): CompletableFuture<Void> =
-                        CompletableFuture.completedFuture(null)
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun execute_withExponentialBackoffCap(async: Boolean) {
+        stubFor(post(urlPathEqualTo("/something")).willReturn(serviceUnavailable()))
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).maxRetries(6).build()
 
-                    override fun close() {}
-                }
+        val response =
+            retryingClient.execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(baseUrl)
+                    .addPathSegment("something")
+                    .build(),
+                async,
             )
 
+        assertThat(response.statusCode()).isEqualTo(503)
+        verify(7, postRequestedFor(urlPathEqualTo("/something")))
+        assertThat(sleeper.durations).hasSize(6)
+        // retries=5: backoff hits the 8s cap * [0.75, 1.0]
+        assertThat(sleeper.durations[4]).isBetween(Duration.ofMillis(6000), Duration.ofMillis(8000))
+        // retries=6: still capped at 8s * [0.75, 1.0]
+        assertThat(sleeper.durations[5]).isBetween(Duration.ofMillis(6000), Duration.ofMillis(8000))
+        assertNoResponseLeaks()
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun execute_withRetryAfterMsPriorityOverRetryAfter(async: Boolean) {
+        stubFor(
+            post(urlPathEqualTo("/something"))
+                .inScenario("foo")
+                .whenScenarioStateIs(Scenario.STARTED)
+                .willReturn(
+                    serviceUnavailable()
+                        .withHeader("Retry-After-Ms", "50")
+                        .withHeader("Retry-After", "2")
+                )
+                .willSetStateTo("RETRY")
+        )
+        stubFor(
+            post(urlPathEqualTo("/something"))
+                .inScenario("foo")
+                .whenScenarioStateIs("RETRY")
+                .willReturn(ok())
+                .willSetStateTo("COMPLETED")
+        )
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).maxRetries(1).build()
+
+        val response =
+            retryingClient.execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(baseUrl)
+                    .addPathSegment("something")
+                    .build(),
+                async,
+            )
+
+        assertThat(response.statusCode()).isEqualTo(200)
+        // Retry-After-Ms (50ms) takes priority over Retry-After (2s).
+        assertThat(sleeper.durations).containsExactly(Duration.ofMillis(50))
+        assertNoResponseLeaks()
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun execute_withRetryAfterUnparseable(async: Boolean) {
+        stubFor(
+            post(urlPathEqualTo("/something"))
+                .inScenario("foo")
+                .whenScenarioStateIs(Scenario.STARTED)
+                .willReturn(serviceUnavailable().withHeader("Retry-After", "not-a-date-or-number"))
+                .willSetStateTo("RETRY")
+        )
+        stubFor(
+            post(urlPathEqualTo("/something"))
+                .inScenario("foo")
+                .whenScenarioStateIs("RETRY")
+                .willReturn(ok())
+                .willSetStateTo("COMPLETED")
+        )
+        val sleeper = RecordingSleeper()
+        val retryingClient = retryingHttpClientBuilder(sleeper).maxRetries(1).build()
+
+        val response =
+            retryingClient.execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(baseUrl)
+                    .addPathSegment("something")
+                    .build(),
+                async,
+            )
+
+        assertThat(response.statusCode()).isEqualTo(200)
+        // Unparseable Retry-After falls through to exponential backoff.
+        assertThat(sleeper.durations).hasSize(1)
+        assertThat(sleeper.durations[0]).isBetween(Duration.ofMillis(375), Duration.ofMillis(500))
+        assertNoResponseLeaks()
+    }
+
+    private fun retryingHttpClientBuilder(
+        sleeper: RecordingSleeper,
+        clock: Clock = Clock.systemUTC(),
+    ) = RetryingHttpClient.builder().httpClient(httpClient).sleeper(sleeper).clock(clock)
+
     private fun HttpClient.execute(request: HttpRequest, async: Boolean): HttpResponse =
         if (async) executeAsync(request).get() else execute(request)
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListParamsTest.kt
new file mode 100644
index 0000000..dc21102
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListParamsTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatListParamsTest {
+
+    @Test
+    fun create() {
+        ChatListParams.builder()
+            .limit(1L)
+            .offset(0L)
+            .q("q")
+            .sort(ChatListParams.Sort.RECENT)
+            .build()
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            ChatListParams.builder()
+                .limit(1L)
+                .offset(0L)
+                .q("q")
+                .sort(ChatListParams.Sort.RECENT)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("limit", "1")
+                    .put("offset", "0")
+                    .put("q", "q")
+                    .put("sort", "recent")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = ChatListParams.builder().build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
new file mode 100644
index 0000000..76639bc
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
@@ -0,0 +1,135 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.jsonMapper
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatListResponseTest {
+
+    @Test
+    fun create() {
+        val chatListResponse =
+            ChatListResponse.builder()
+                .addChat(
+                    ChatListResponse.Chat.builder()
+                        .id("id")
+                        .contact(
+                            ChatListResponse.Chat.Contact.builder()
+                                .contactId("contact_id")
+                                .identifier("identifier")
+                                .name("name")
+                                .build()
+                        )
+                        .groupId("group_id")
+                        .groupName("group_name")
+                        .inboundCount(0L)
+                        .isGroup(true)
+                        .lastInboundTime(0L)
+                        .lastMessage(
+                            LastMessage.builder()
+                                .direction(LastMessage.Direction.INBOUND)
+                                .messageId("message_id")
+                                .text("text")
+                                .timeSent(0L)
+                                .build()
+                        )
+                        .lastMessageTime(0L)
+                        .lastOutboundTime(0L)
+                        .memberCount(0L)
+                        .messageCount(0L)
+                        .outboundCount(0L)
+                        .type(ChatListResponse.Chat.Type.PHONE)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        assertThat(chatListResponse.chats().getOrNull())
+            .containsExactly(
+                ChatListResponse.Chat.builder()
+                    .id("id")
+                    .contact(
+                        ChatListResponse.Chat.Contact.builder()
+                            .contactId("contact_id")
+                            .identifier("identifier")
+                            .name("name")
+                            .build()
+                    )
+                    .groupId("group_id")
+                    .groupName("group_name")
+                    .inboundCount(0L)
+                    .isGroup(true)
+                    .lastInboundTime(0L)
+                    .lastMessage(
+                        LastMessage.builder()
+                            .direction(LastMessage.Direction.INBOUND)
+                            .messageId("message_id")
+                            .text("text")
+                            .timeSent(0L)
+                            .build()
+                    )
+                    .lastMessageTime(0L)
+                    .lastOutboundTime(0L)
+                    .memberCount(0L)
+                    .messageCount(0L)
+                    .outboundCount(0L)
+                    .type(ChatListResponse.Chat.Type.PHONE)
+                    .build()
+            )
+        assertThat(chatListResponse.pagination())
+            .contains(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val chatListResponse =
+            ChatListResponse.builder()
+                .addChat(
+                    ChatListResponse.Chat.builder()
+                        .id("id")
+                        .contact(
+                            ChatListResponse.Chat.Contact.builder()
+                                .contactId("contact_id")
+                                .identifier("identifier")
+                                .name("name")
+                                .build()
+                        )
+                        .groupId("group_id")
+                        .groupName("group_name")
+                        .inboundCount(0L)
+                        .isGroup(true)
+                        .lastInboundTime(0L)
+                        .lastMessage(
+                            LastMessage.builder()
+                                .direction(LastMessage.Direction.INBOUND)
+                                .messageId("message_id")
+                                .text("text")
+                                .timeSent(0L)
+                                .build()
+                        )
+                        .lastMessageTime(0L)
+                        .lastOutboundTime(0L)
+                        .memberCount(0L)
+                        .messageCount(0L)
+                        .outboundCount(0L)
+                        .type(ChatListResponse.Chat.Type.PHONE)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        val roundtrippedChatListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(chatListResponse),
+                jacksonTypeRef<ChatListResponse>(),
+            )
+
+        assertThat(roundtrippedChatListResponse).isEqualTo(chatListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParamsTest.kt
similarity index 52%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParamsTest.kt
index 9016649..c8c5e78 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.chats
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class BatchRetrieveParamsTest {
+internal class ChatMarkAsReadParamsTest {
 
     @Test
     fun create() {
-        BatchRetrieveParams.builder().batchId("batchId").build()
+        ChatMarkAsReadParams.builder().chatId("chatId").build()
     }
 
     @Test
     fun pathParams() {
-        val params = BatchRetrieveParams.builder().batchId("batchId").build()
+        val params = ChatMarkAsReadParams.builder().chatId("chatId").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("batchId")
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponseTest.kt
new file mode 100644
index 0000000..e713d03
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponseTest.kt
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatMarkAsReadResponseTest {
+
+    @Test
+    fun create() {
+        val chatMarkAsReadResponse =
+            ChatMarkAsReadResponse.builder()
+                .chatId("chat_id")
+                .markedAt(0L)
+                .status(ChatMarkAsReadResponse.Status.READ)
+                .build()
+
+        assertThat(chatMarkAsReadResponse.chatId()).contains("chat_id")
+        assertThat(chatMarkAsReadResponse.markedAt()).contains(0L)
+        assertThat(chatMarkAsReadResponse.status()).contains(ChatMarkAsReadResponse.Status.READ)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val chatMarkAsReadResponse =
+            ChatMarkAsReadResponse.builder()
+                .chatId("chat_id")
+                .markedAt(0L)
+                .status(ChatMarkAsReadResponse.Status.READ)
+                .build()
+
+        val roundtrippedChatMarkAsReadResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(chatMarkAsReadResponse),
+                jacksonTypeRef<ChatMarkAsReadResponse>(),
+            )
+
+        assertThat(roundtrippedChatMarkAsReadResponse).isEqualTo(chatMarkAsReadResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveParamsTest.kt
similarity index 51%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveParamsTest.kt
index 9a06fcf..f289c2b 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class MessageCancelParamsTest {
+internal class ChatRetrieveParamsTest {
 
     @Test
     fun create() {
-        MessageCancelParams.builder().messageId("messageId").build()
+        ChatRetrieveParams.builder().chatId("chatId").build()
     }
 
     @Test
     fun pathParams() {
-        val params = MessageCancelParams.builder().messageId("messageId").build()
+        val params = ChatRetrieveParams.builder().chatId("chatId").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("messageId")
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
new file mode 100644
index 0000000..d83add3
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
@@ -0,0 +1,121 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatRetrieveResponseTest {
+
+    @Test
+    fun create() {
+        val chatRetrieveResponse =
+            ChatRetrieveResponse.builder()
+                .id("id")
+                .contact(
+                    ChatRetrieveResponse.Contact.builder()
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .firstMessageTime(0L)
+                .groupId("group_id")
+                .groupName("group_name")
+                .inboundCount(0L)
+                .isGroup(true)
+                .lastInboundTime(0L)
+                .lastMessage(
+                    LastMessage.builder()
+                        .direction(LastMessage.Direction.INBOUND)
+                        .messageId("message_id")
+                        .text("text")
+                        .timeSent(0L)
+                        .build()
+                )
+                .lastMessageTime(0L)
+                .lastOutboundTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .outboundCount(0L)
+                .type(ChatRetrieveResponse.Type.PHONE)
+                .build()
+
+        assertThat(chatRetrieveResponse.id()).contains("id")
+        assertThat(chatRetrieveResponse.contact())
+            .contains(
+                ChatRetrieveResponse.Contact.builder()
+                    .contactId("contact_id")
+                    .identifier("identifier")
+                    .name("name")
+                    .build()
+            )
+        assertThat(chatRetrieveResponse.firstMessageTime()).contains(0L)
+        assertThat(chatRetrieveResponse.groupId()).contains("group_id")
+        assertThat(chatRetrieveResponse.groupName()).contains("group_name")
+        assertThat(chatRetrieveResponse.inboundCount()).contains(0L)
+        assertThat(chatRetrieveResponse.isGroup()).contains(true)
+        assertThat(chatRetrieveResponse.lastInboundTime()).contains(0L)
+        assertThat(chatRetrieveResponse.lastMessage())
+            .contains(
+                LastMessage.builder()
+                    .direction(LastMessage.Direction.INBOUND)
+                    .messageId("message_id")
+                    .text("text")
+                    .timeSent(0L)
+                    .build()
+            )
+        assertThat(chatRetrieveResponse.lastMessageTime()).contains(0L)
+        assertThat(chatRetrieveResponse.lastOutboundTime()).contains(0L)
+        assertThat(chatRetrieveResponse.memberCount()).contains(0L)
+        assertThat(chatRetrieveResponse.messageCount()).contains(0L)
+        assertThat(chatRetrieveResponse.outboundCount()).contains(0L)
+        assertThat(chatRetrieveResponse.type()).contains(ChatRetrieveResponse.Type.PHONE)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val chatRetrieveResponse =
+            ChatRetrieveResponse.builder()
+                .id("id")
+                .contact(
+                    ChatRetrieveResponse.Contact.builder()
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .firstMessageTime(0L)
+                .groupId("group_id")
+                .groupName("group_name")
+                .inboundCount(0L)
+                .isGroup(true)
+                .lastInboundTime(0L)
+                .lastMessage(
+                    LastMessage.builder()
+                        .direction(LastMessage.Direction.INBOUND)
+                        .messageId("message_id")
+                        .text("text")
+                        .timeSent(0L)
+                        .build()
+                )
+                .lastMessageTime(0L)
+                .lastOutboundTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .outboundCount(0L)
+                .type(ChatRetrieveResponse.Type.PHONE)
+                .build()
+
+        val roundtrippedChatRetrieveResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(chatRetrieveResponse),
+                jacksonTypeRef<ChatRetrieveResponse>(),
+            )
+
+        assertThat(roundtrippedChatRetrieveResponse).isEqualTo(chatRetrieveResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardParamsTest.kt
similarity index 50%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardParamsTest.kt
index 2bac8cd..ac790bb 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class MessageRetrieveParamsTest {
+internal class ChatShareContactCardParamsTest {
 
     @Test
     fun create() {
-        MessageRetrieveParams.builder().messageId("messageId").build()
+        ChatShareContactCardParams.builder().chatId("chatId").build()
     }
 
     @Test
     fun pathParams() {
-        val params = MessageRetrieveParams.builder().messageId("messageId").build()
+        val params = ChatShareContactCardParams.builder().chatId("chatId").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("messageId")
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponseTest.kt
new file mode 100644
index 0000000..c5af4c0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponseTest.kt
@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatShareContactCardResponseTest {
+
+    @Test
+    fun create() {
+        val chatShareContactCardResponse =
+            ChatShareContactCardResponse.builder()
+                .chatId("chat_id")
+                .message(
+                    "Contact card staged. It will be sent with the next outgoing message in this chat."
+                )
+                .success(true)
+                .build()
+
+        assertThat(chatShareContactCardResponse.chatId()).contains("chat_id")
+        assertThat(chatShareContactCardResponse.message())
+            .contains(
+                "Contact card staged. It will be sent with the next outgoing message in this chat."
+            )
+        assertThat(chatShareContactCardResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val chatShareContactCardResponse =
+            ChatShareContactCardResponse.builder()
+                .chatId("chat_id")
+                .message(
+                    "Contact card staged. It will be sent with the next outgoing message in this chat."
+                )
+                .success(true)
+                .build()
+
+        val roundtrippedChatShareContactCardResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(chatShareContactCardResponse),
+                jacksonTypeRef<ChatShareContactCardResponse>(),
+            )
+
+        assertThat(roundtrippedChatShareContactCardResponse).isEqualTo(chatShareContactCardResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/LastMessageTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/LastMessageTest.kt
new file mode 100644
index 0000000..bca7d8a
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/LastMessageTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LastMessageTest {
+
+    @Test
+    fun create() {
+        val lastMessage =
+            LastMessage.builder()
+                .direction(LastMessage.Direction.INBOUND)
+                .messageId("message_id")
+                .text("text")
+                .timeSent(0L)
+                .build()
+
+        assertThat(lastMessage.direction()).contains(LastMessage.Direction.INBOUND)
+        assertThat(lastMessage.messageId()).contains("message_id")
+        assertThat(lastMessage.text()).contains("text")
+        assertThat(lastMessage.timeSent()).contains(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val lastMessage =
+            LastMessage.builder()
+                .direction(LastMessage.Direction.INBOUND)
+                .messageId("message_id")
+                .text("text")
+                .timeSent(0L)
+                .build()
+
+        val roundtrippedLastMessage =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(lastMessage),
+                jacksonTypeRef<LastMessage>(),
+            )
+
+        assertThat(roundtrippedLastMessage).isEqualTo(lastMessage)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParamsTest.kt
new file mode 100644
index 0000000..993a842
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRemoveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BackgroundRemoveParamsTest {
+
+    @Test
+    fun create() {
+        BackgroundRemoveParams.builder().chatId("chatId").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = BackgroundRemoveParams.builder().chatId("chatId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParamsTest.kt
new file mode 100644
index 0000000..708799b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BackgroundRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        BackgroundRetrieveParams.builder().chatId("chatId").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = BackgroundRetrieveParams.builder().chatId("chatId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundSetParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundSetParamsTest.kt
new file mode 100644
index 0000000..9ea5f0e
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/BackgroundSetParamsTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import com.blooio.api.core.MultipartField
+import java.io.InputStream
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BackgroundSetParamsTest {
+
+    @Test
+    fun create() {
+        BackgroundSetParams.builder()
+            .chatId("chatId")
+            .background("Example data".byteInputStream())
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            BackgroundSetParams.builder()
+                .chatId("chatId")
+                .background("Example data".byteInputStream())
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            BackgroundSetParams.builder()
+                .chatId("chatId")
+                .background("Example data".byteInputStream())
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.filterValues { !it.value.isNull() })
+            .usingRecursiveComparison()
+            // TODO(AssertJ): Replace this and the `mapValues` below with:
+            // https://github.com/assertj/assertj/issues/3165
+            .withEqualsForType(
+                { a, b -> a.readBytes() contentEquals b.readBytes() },
+                InputStream::class.java,
+            )
+            .isEqualTo(
+                mapOf("background" to MultipartField.of("Example data".byteInputStream()))
+                    .mapValues { (_, field) ->
+                        field.map { (it as? ByteArray)?.inputStream() ?: it }
+                    }
+            )
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
new file mode 100644
index 0000000..53e1631
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.background
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ChatBackgroundResponseTest {
+
+    @Test
+    fun create() {
+        val chatBackgroundResponse =
+            ChatBackgroundResponse.builder()
+                .backgroundId("background_id")
+                .backgroundVersion(0L)
+                .changed(true)
+                .chatId("chat_id")
+                .hasBackground(true)
+                .build()
+
+        assertThat(chatBackgroundResponse.backgroundId()).contains("background_id")
+        assertThat(chatBackgroundResponse.backgroundVersion()).contains(0L)
+        assertThat(chatBackgroundResponse.changed()).contains(true)
+        assertThat(chatBackgroundResponse.chatId()).contains("chat_id")
+        assertThat(chatBackgroundResponse.hasBackground()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val chatBackgroundResponse =
+            ChatBackgroundResponse.builder()
+                .backgroundId("background_id")
+                .backgroundVersion(0L)
+                .changed(true)
+                .chatId("chat_id")
+                .hasBackground(true)
+                .build()
+
+        val roundtrippedChatBackgroundResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(chatBackgroundResponse),
+                jacksonTypeRef<ChatBackgroundResponse>(),
+            )
+
+        assertThat(roundtrippedChatBackgroundResponse).isEqualTo(chatBackgroundResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/LinkPreviewTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/LinkPreviewTest.kt
new file mode 100644
index 0000000..aaae440
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/LinkPreviewTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LinkPreviewTest {
+
+    @Test
+    fun create() {
+        val linkPreview =
+            LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+
+        assertThat(linkPreview.imageUrl()).contains("https://example.com")
+        assertThat(linkPreview.title()).contains("title")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val linkPreview =
+            LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+
+        val roundtrippedLinkPreview =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(linkPreview),
+                jacksonTypeRef<LinkPreview>(),
+            )
+
+        assertThat(roundtrippedLinkPreview).isEqualTo(linkPreview)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParamsTest.kt
new file mode 100644
index 0000000..c9aeb25
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusParamsTest.kt
@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageGetStatusParamsTest {
+
+    @Test
+    fun create() {
+        MessageGetStatusParams.builder().chatId("chatId").messageId("msg_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            MessageGetStatusParams.builder().chatId("chatId").messageId("msg_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        assertThat(params._pathParam(1)).isEqualTo("msg_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
similarity index 54%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusResponseTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
index 1034847..5001166 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
@@ -1,6 +1,6 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.chats.messages
 
 import com.blooio.api.core.jsonMapper
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
@@ -13,13 +13,27 @@ internal class MessageGetStatusResponseTest {
     fun create() {
         val messageGetStatusResponse =
             MessageGetStatusResponse.builder()
+                .chatId("chat_id")
+                .direction(MessageGetStatusResponse.Direction.INBOUND)
+                .error("error")
                 .messageId("message_id")
+                .protocol(MessageGetStatusResponse.Protocol.IMESSAGE)
                 .status(MessageGetStatusResponse.Status.PENDING)
+                .timeDelivered(0L)
+                .timeSent(0L)
                 .build()
 
+        assertThat(messageGetStatusResponse.chatId()).contains("chat_id")
+        assertThat(messageGetStatusResponse.direction())
+            .contains(MessageGetStatusResponse.Direction.INBOUND)
+        assertThat(messageGetStatusResponse.error()).contains("error")
         assertThat(messageGetStatusResponse.messageId()).contains("message_id")
+        assertThat(messageGetStatusResponse.protocol())
+            .contains(MessageGetStatusResponse.Protocol.IMESSAGE)
         assertThat(messageGetStatusResponse.status())
             .contains(MessageGetStatusResponse.Status.PENDING)
+        assertThat(messageGetStatusResponse.timeDelivered()).contains(0L)
+        assertThat(messageGetStatusResponse.timeSent()).contains(0L)
     }
 
     @Test
@@ -27,8 +41,14 @@ internal class MessageGetStatusResponseTest {
         val jsonMapper = jsonMapper()
         val messageGetStatusResponse =
             MessageGetStatusResponse.builder()
+                .chatId("chat_id")
+                .direction(MessageGetStatusResponse.Direction.INBOUND)
+                .error("error")
                 .messageId("message_id")
+                .protocol(MessageGetStatusResponse.Protocol.IMESSAGE)
                 .status(MessageGetStatusResponse.Status.PENDING)
+                .timeDelivered(0L)
+                .timeSent(0L)
                 .build()
 
         val roundtrippedMessageGetStatusResponse =
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListParamsTest.kt
new file mode 100644
index 0000000..c617f78
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListParamsTest.kt
@@ -0,0 +1,69 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageListParamsTest {
+
+    @Test
+    fun create() {
+        MessageListParams.builder()
+            .chatId("chatId")
+            .direction(MessageListParams.Direction.INBOUND)
+            .limit(1L)
+            .offset(0L)
+            .since(0L)
+            .sort(MessageListParams.Sort.ASC)
+            .until(0L)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = MessageListParams.builder().chatId("chatId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            MessageListParams.builder()
+                .chatId("chatId")
+                .direction(MessageListParams.Direction.INBOUND)
+                .limit(1L)
+                .offset(0L)
+                .since(0L)
+                .sort(MessageListParams.Sort.ASC)
+                .until(0L)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("direction", "inbound")
+                    .put("limit", "1")
+                    .put("offset", "0")
+                    .put("since", "0")
+                    .put("sort", "asc")
+                    .put("until", "0")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = MessageListParams.builder().chatId("chatId").build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
new file mode 100644
index 0000000..921b646
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
@@ -0,0 +1,118 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.jsonMapper
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageListResponseTest {
+
+    @Test
+    fun create() {
+        val messageListResponse =
+            MessageListResponse.builder()
+                .chatId("chat_id")
+                .addMessage(
+                    MessageListResponse.Message.builder()
+                        .addAttachment(JsonValue.from(mapOf<String, Any>()))
+                        .direction(MessageListResponse.Message.Direction.INBOUND)
+                        .error("error")
+                        .externalId("external_id")
+                        .internalId("internal_id")
+                        .messageId("message_id")
+                        .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                        .addReaction(
+                            Reaction.builder()
+                                .isAdded(true)
+                                .reaction("reaction")
+                                .sender("sender")
+                                .timeSent(0L)
+                                .build()
+                        )
+                        .sender("sender")
+                        .status(MessageListResponse.Message.Status.PENDING)
+                        .text("text")
+                        .timeDelivered(0L)
+                        .timeSent(0L)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        assertThat(messageListResponse.chatId()).contains("chat_id")
+        assertThat(messageListResponse.messages().getOrNull())
+            .containsExactly(
+                MessageListResponse.Message.builder()
+                    .addAttachment(JsonValue.from(mapOf<String, Any>()))
+                    .direction(MessageListResponse.Message.Direction.INBOUND)
+                    .error("error")
+                    .externalId("external_id")
+                    .internalId("internal_id")
+                    .messageId("message_id")
+                    .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                    .addReaction(
+                        Reaction.builder()
+                            .isAdded(true)
+                            .reaction("reaction")
+                            .sender("sender")
+                            .timeSent(0L)
+                            .build()
+                    )
+                    .sender("sender")
+                    .status(MessageListResponse.Message.Status.PENDING)
+                    .text("text")
+                    .timeDelivered(0L)
+                    .timeSent(0L)
+                    .build()
+            )
+        assertThat(messageListResponse.pagination())
+            .contains(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val messageListResponse =
+            MessageListResponse.builder()
+                .chatId("chat_id")
+                .addMessage(
+                    MessageListResponse.Message.builder()
+                        .addAttachment(JsonValue.from(mapOf<String, Any>()))
+                        .direction(MessageListResponse.Message.Direction.INBOUND)
+                        .error("error")
+                        .externalId("external_id")
+                        .internalId("internal_id")
+                        .messageId("message_id")
+                        .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                        .addReaction(
+                            Reaction.builder()
+                                .isAdded(true)
+                                .reaction("reaction")
+                                .sender("sender")
+                                .timeSent(0L)
+                                .build()
+                        )
+                        .sender("sender")
+                        .status(MessageListResponse.Message.Status.PENDING)
+                        .text("text")
+                        .timeDelivered(0L)
+                        .timeSent(0L)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        val roundtrippedMessageListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(messageListResponse),
+                jacksonTypeRef<MessageListResponse>(),
+            )
+
+        assertThat(roundtrippedMessageListResponse).isEqualTo(messageListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactParamsTest.kt
new file mode 100644
index 0000000..6fe4ef3
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactParamsTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageReactParamsTest {
+
+    @Test
+    fun create() {
+        MessageReactParams.builder()
+            .chatId("chatId")
+            .messageId("messageId")
+            .reaction("+love")
+            .direction(MessageReactParams.Direction.INBOUND)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            MessageReactParams.builder()
+                .chatId("chatId")
+                .messageId("messageId")
+                .reaction("+love")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        assertThat(params._pathParam(1)).isEqualTo("messageId")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            MessageReactParams.builder()
+                .chatId("chatId")
+                .messageId("messageId")
+                .reaction("+love")
+                .direction(MessageReactParams.Direction.INBOUND)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.reaction()).isEqualTo("+love")
+        assertThat(body.direction()).contains(MessageReactParams.Direction.INBOUND)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params =
+            MessageReactParams.builder()
+                .chatId("chatId")
+                .messageId("messageId")
+                .reaction("+love")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.reaction()).isEqualTo("+love")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactResponseTest.kt
new file mode 100644
index 0000000..67bcc24
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageReactResponseTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageReactResponseTest {
+
+    @Test
+    fun create() {
+        val messageReactResponse =
+            MessageReactResponse.builder()
+                .action(MessageReactResponse.Action.ADD)
+                .messageId("message_id")
+                .reaction("love")
+                .success(true)
+                .build()
+
+        assertThat(messageReactResponse.action()).contains(MessageReactResponse.Action.ADD)
+        assertThat(messageReactResponse.messageId()).contains("message_id")
+        assertThat(messageReactResponse.reaction()).contains("love")
+        assertThat(messageReactResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val messageReactResponse =
+            MessageReactResponse.builder()
+                .action(MessageReactResponse.Action.ADD)
+                .messageId("message_id")
+                .reaction("love")
+                .success(true)
+                .build()
+
+        val roundtrippedMessageReactResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(messageReactResponse),
+                jacksonTypeRef<MessageReactResponse>(),
+            )
+
+        assertThat(roundtrippedMessageReactResponse).isEqualTo(messageReactResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParamsTest.kt
new file mode 100644
index 0000000..39a4ba5
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveParamsTest.kt
@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        MessageRetrieveParams.builder().chatId("chatId").messageId("msg_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            MessageRetrieveParams.builder().chatId("chatId").messageId("msg_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        assertThat(params._pathParam(1)).isEqualTo("msg_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
new file mode 100644
index 0000000..b50572d
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
@@ -0,0 +1,124 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageRetrieveResponseTest {
+
+    @Test
+    fun create() {
+        val messageRetrieveResponse =
+            MessageRetrieveResponse.builder()
+                .addAttachment(JsonValue.from(mapOf<String, Any>()))
+                .chatId("chat_id")
+                .contact(
+                    MessageRetrieveResponse.Contact.builder()
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .direction(MessageRetrieveResponse.Direction.INBOUND)
+                .error("error")
+                .internalId("internal_id")
+                .messageId("message_id")
+                .protocol(MessageRetrieveResponse.Protocol.IMESSAGE)
+                .addReaction(
+                    Reaction.builder()
+                        .isAdded(true)
+                        .reaction("reaction")
+                        .sender("sender")
+                        .timeSent(0L)
+                        .build()
+                )
+                .sender("sender")
+                .status(MessageRetrieveResponse.Status.PENDING)
+                .text("text")
+                .timeDelivered(0L)
+                .timeSent(0L)
+                .build()
+
+        assertThat(messageRetrieveResponse.attachments().getOrNull())
+            .containsExactly(JsonValue.from(mapOf<String, Any>()))
+        assertThat(messageRetrieveResponse.chatId()).contains("chat_id")
+        assertThat(messageRetrieveResponse.contact())
+            .contains(
+                MessageRetrieveResponse.Contact.builder()
+                    .contactId("contact_id")
+                    .identifier("identifier")
+                    .name("name")
+                    .build()
+            )
+        assertThat(messageRetrieveResponse.direction())
+            .contains(MessageRetrieveResponse.Direction.INBOUND)
+        assertThat(messageRetrieveResponse.error()).contains("error")
+        assertThat(messageRetrieveResponse.internalId()).contains("internal_id")
+        assertThat(messageRetrieveResponse.messageId()).contains("message_id")
+        assertThat(messageRetrieveResponse.protocol())
+            .contains(MessageRetrieveResponse.Protocol.IMESSAGE)
+        assertThat(messageRetrieveResponse.reactions().getOrNull())
+            .containsExactly(
+                Reaction.builder()
+                    .isAdded(true)
+                    .reaction("reaction")
+                    .sender("sender")
+                    .timeSent(0L)
+                    .build()
+            )
+        assertThat(messageRetrieveResponse.sender()).contains("sender")
+        assertThat(messageRetrieveResponse.status())
+            .contains(MessageRetrieveResponse.Status.PENDING)
+        assertThat(messageRetrieveResponse.text()).contains("text")
+        assertThat(messageRetrieveResponse.timeDelivered()).contains(0L)
+        assertThat(messageRetrieveResponse.timeSent()).contains(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val messageRetrieveResponse =
+            MessageRetrieveResponse.builder()
+                .addAttachment(JsonValue.from(mapOf<String, Any>()))
+                .chatId("chat_id")
+                .contact(
+                    MessageRetrieveResponse.Contact.builder()
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .direction(MessageRetrieveResponse.Direction.INBOUND)
+                .error("error")
+                .internalId("internal_id")
+                .messageId("message_id")
+                .protocol(MessageRetrieveResponse.Protocol.IMESSAGE)
+                .addReaction(
+                    Reaction.builder()
+                        .isAdded(true)
+                        .reaction("reaction")
+                        .sender("sender")
+                        .timeSent(0L)
+                        .build()
+                )
+                .sender("sender")
+                .status(MessageRetrieveResponse.Status.PENDING)
+                .text("text")
+                .timeDelivered(0L)
+                .timeSent(0L)
+                .build()
+
+        val roundtrippedMessageRetrieveResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(messageRetrieveResponse),
+                jacksonTypeRef<MessageRetrieveResponse>(),
+            )
+
+        assertThat(roundtrippedMessageRetrieveResponse).isEqualTo(messageRetrieveResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
new file mode 100644
index 0000000..29cb640
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
@@ -0,0 +1,153 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.http.Headers
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageSendParamsTest {
+
+    @Test
+    fun create() {
+        MessageSendParams.builder()
+            .chatId("chatId")
+            .idempotencyKey("Idempotency-Key")
+            .addAttachment("string")
+            .fromNumber("from_number")
+            .linkPreview(
+                LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+            )
+            .addPart(
+                MessageSendParams.Part.builder()
+                    .linkPreview(
+                        LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                    )
+                    .mention("mention")
+                    .name("name")
+                    .text("text")
+                    .url("url")
+                    .build()
+            )
+            .shareContact(true)
+            .text("string")
+            .useTypingIndicator(true)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = MessageSendParams.builder().chatId("chatId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            MessageSendParams.builder()
+                .chatId("chatId")
+                .idempotencyKey("Idempotency-Key")
+                .addAttachment("string")
+                .fromNumber("from_number")
+                .linkPreview(
+                    LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                )
+                .addPart(
+                    MessageSendParams.Part.builder()
+                        .linkPreview(
+                            LinkPreview.builder()
+                                .imageUrl("https://example.com")
+                                .title("title")
+                                .build()
+                        )
+                        .mention("mention")
+                        .name("name")
+                        .text("text")
+                        .url("url")
+                        .build()
+                )
+                .shareContact(true)
+                .text("string")
+                .useTypingIndicator(true)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("Idempotency-Key", "Idempotency-Key").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params = MessageSendParams.builder().chatId("chatId").build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun body() {
+        val params =
+            MessageSendParams.builder()
+                .chatId("chatId")
+                .idempotencyKey("Idempotency-Key")
+                .addAttachment("string")
+                .fromNumber("from_number")
+                .linkPreview(
+                    LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                )
+                .addPart(
+                    MessageSendParams.Part.builder()
+                        .linkPreview(
+                            LinkPreview.builder()
+                                .imageUrl("https://example.com")
+                                .title("title")
+                                .build()
+                        )
+                        .mention("mention")
+                        .name("name")
+                        .text("text")
+                        .url("url")
+                        .build()
+                )
+                .shareContact(true)
+                .text("string")
+                .useTypingIndicator(true)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.attachments().getOrNull())
+            .containsExactly(MessageSendParams.Attachment.ofString("string"))
+        assertThat(body.fromNumber()).contains("from_number")
+        assertThat(body.linkPreview())
+            .contains(LinkPreview.builder().imageUrl("https://example.com").title("title").build())
+        assertThat(body.parts().getOrNull())
+            .containsExactly(
+                MessageSendParams.Part.builder()
+                    .linkPreview(
+                        LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                    )
+                    .mention("mention")
+                    .name("name")
+                    .text("text")
+                    .url("url")
+                    .build()
+            )
+        assertThat(body.shareContact()).contains(true)
+        assertThat(body.text()).contains(MessageSendParams.Text.ofString("string"))
+        assertThat(body.useTypingIndicator()).contains(true)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = MessageSendParams.builder().chatId("chatId").build()
+
+        val body = params._body()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
new file mode 100644
index 0000000..9bb1f1b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
@@ -0,0 +1,57 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MessageSendResponseTest {
+
+    @Test
+    fun create() {
+        val messageSendResponse =
+            MessageSendResponse.builder()
+                .count(0L)
+                .groupCreated(true)
+                .groupId("group_id")
+                .messageId("message_id")
+                .addMessageId("string")
+                .addParticipant("string")
+                .status(MessageSendResponse.Status.QUEUED)
+                .build()
+
+        assertThat(messageSendResponse.count()).contains(0L)
+        assertThat(messageSendResponse.groupCreated()).contains(true)
+        assertThat(messageSendResponse.groupId()).contains("group_id")
+        assertThat(messageSendResponse.messageId()).contains("message_id")
+        assertThat(messageSendResponse.messageIds().getOrNull()).containsExactly("string")
+        assertThat(messageSendResponse.participants().getOrNull()).containsExactly("string")
+        assertThat(messageSendResponse.status()).contains(MessageSendResponse.Status.QUEUED)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val messageSendResponse =
+            MessageSendResponse.builder()
+                .count(0L)
+                .groupCreated(true)
+                .groupId("group_id")
+                .messageId("message_id")
+                .addMessageId("string")
+                .addParticipant("string")
+                .status(MessageSendResponse.Status.QUEUED)
+                .build()
+
+        val roundtrippedMessageSendResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(messageSendResponse),
+                jacksonTypeRef<MessageSendResponse>(),
+            )
+
+        assertThat(roundtrippedMessageSendResponse).isEqualTo(messageSendResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/ReactionTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/ReactionTest.kt
new file mode 100644
index 0000000..d981615
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/ReactionTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.messages
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ReactionTest {
+
+    @Test
+    fun create() {
+        val reaction =
+            Reaction.builder()
+                .isAdded(true)
+                .reaction("reaction")
+                .sender("sender")
+                .timeSent(0L)
+                .build()
+
+        assertThat(reaction.isAdded()).contains(true)
+        assertThat(reaction.reaction()).contains("reaction")
+        assertThat(reaction.sender()).contains("sender")
+        assertThat(reaction.timeSent()).contains(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val reaction =
+            Reaction.builder()
+                .isAdded(true)
+                .reaction("reaction")
+                .sender("sender")
+                .timeSent(0L)
+                .build()
+
+        val roundtrippedReaction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(reaction),
+                jacksonTypeRef<Reaction>(),
+            )
+
+        assertThat(roundtrippedReaction).isEqualTo(reaction)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParamsTest.kt
new file mode 100644
index 0000000..23ae047
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsParamsTest.kt
@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PollGetResultsParamsTest {
+
+    @Test
+    fun create() {
+        PollGetResultsParams.builder().chatId("chatId").pollId("pollId").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = PollGetResultsParams.builder().chatId("chatId").pollId("pollId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        assertThat(params._pathParam(1)).isEqualTo("pollId")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponseTest.kt
new file mode 100644
index 0000000..ca75631
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponseTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PollGetResultsResponseTest {
+
+    @Test
+    fun create() {
+        val pollGetResultsResponse =
+            PollGetResultsResponse.builder()
+                .chatId("chat_id")
+                .addOption(PollGetResultsResponse.Option.builder().text("text").votes(0L).build())
+                .pollId("poll_id")
+                .title("title")
+                .totalVotes(0L)
+                .build()
+
+        assertThat(pollGetResultsResponse.chatId()).contains("chat_id")
+        assertThat(pollGetResultsResponse.options().getOrNull())
+            .containsExactly(PollGetResultsResponse.Option.builder().text("text").votes(0L).build())
+        assertThat(pollGetResultsResponse.pollId()).contains("poll_id")
+        assertThat(pollGetResultsResponse.title()).contains("title")
+        assertThat(pollGetResultsResponse.totalVotes()).contains(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val pollGetResultsResponse =
+            PollGetResultsResponse.builder()
+                .chatId("chat_id")
+                .addOption(PollGetResultsResponse.Option.builder().text("text").votes(0L).build())
+                .pollId("poll_id")
+                .title("title")
+                .totalVotes(0L)
+                .build()
+
+        val roundtrippedPollGetResultsResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(pollGetResultsResponse),
+                jacksonTypeRef<PollGetResultsResponse>(),
+            )
+
+        assertThat(roundtrippedPollGetResultsResponse).isEqualTo(pollGetResultsResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendParamsTest.kt
new file mode 100644
index 0000000..47e6625
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendParamsTest.kt
@@ -0,0 +1,63 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PollSendParamsTest {
+
+    @Test
+    fun create() {
+        PollSendParams.builder()
+            .chatId("chatId")
+            .addOption("string")
+            .addOption("string")
+            .title("title")
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            PollSendParams.builder()
+                .chatId("chatId")
+                .addOption("string")
+                .addOption("string")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            PollSendParams.builder()
+                .chatId("chatId")
+                .addOption("string")
+                .addOption("string")
+                .title("title")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.options()).containsExactly("string", "string")
+        assertThat(body.title()).contains("title")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params =
+            PollSendParams.builder()
+                .chatId("chatId")
+                .addOption("string")
+                .addOption("string")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.options()).containsExactly("string", "string")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendResponseTest.kt
new file mode 100644
index 0000000..54c3be0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/polls/PollSendResponseTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.polls
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PollSendResponseTest {
+
+    @Test
+    fun create() {
+        val pollSendResponse =
+            PollSendResponse.builder()
+                .chatId("chat_id")
+                .poll(PollSendResponse.Poll.builder().addOption("string").title("title").build())
+                .pollId("poll_id")
+                .sentAt(0.0)
+                .build()
+
+        assertThat(pollSendResponse.chatId()).contains("chat_id")
+        assertThat(pollSendResponse.poll())
+            .contains(PollSendResponse.Poll.builder().addOption("string").title("title").build())
+        assertThat(pollSendResponse.pollId()).contains("poll_id")
+        assertThat(pollSendResponse.sentAt()).contains(0.0)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val pollSendResponse =
+            PollSendResponse.builder()
+                .chatId("chat_id")
+                .poll(PollSendResponse.Poll.builder().addOption("string").title("title").build())
+                .pollId("poll_id")
+                .sentAt(0.0)
+                .build()
+
+        val roundtrippedPollSendResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(pollSendResponse),
+                jacksonTypeRef<PollSendResponse>(),
+            )
+
+        assertThat(roundtrippedPollSendResponse).isEqualTo(pollSendResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
new file mode 100644
index 0000000..0d782a0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.typing
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TypingResponseTest {
+
+    @Test
+    fun create() {
+        val typingResponse =
+            TypingResponse.builder()
+                .chatId("chat_id")
+                .startedAt(0L)
+                .stoppedAt(0L)
+                .typing(true)
+                .build()
+
+        assertThat(typingResponse.chatId()).contains("chat_id")
+        assertThat(typingResponse.startedAt()).contains(0L)
+        assertThat(typingResponse.stoppedAt()).contains(0L)
+        assertThat(typingResponse.typing()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val typingResponse =
+            TypingResponse.builder()
+                .chatId("chat_id")
+                .startedAt(0L)
+                .stoppedAt(0L)
+                .typing(true)
+                .build()
+
+        val roundtrippedTypingResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(typingResponse),
+                jacksonTypeRef<TypingResponse>(),
+            )
+
+        assertThat(roundtrippedTypingResponse).isEqualTo(typingResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchListMessagesParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStartParamsTest.kt
similarity index 51%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchListMessagesParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStartParamsTest.kt
index c1faa43..80cb923 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchListMessagesParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStartParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.chats.typing
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class BatchListMessagesParamsTest {
+internal class TypingStartParamsTest {
 
     @Test
     fun create() {
-        BatchListMessagesParams.builder().batchId("batchId").build()
+        TypingStartParams.builder().chatId("chatId").build()
     }
 
     @Test
     fun pathParams() {
-        val params = BatchListMessagesParams.builder().batchId("batchId").build()
+        val params = TypingStartParams.builder().chatId("chatId").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("batchId")
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStopParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStopParamsTest.kt
new file mode 100644
index 0000000..b2c706b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingStopParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.chats.typing
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TypingStopParamsTest {
+
+    @Test
+    fun create() {
+        TypingStopParams.builder().chatId("chatId").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = TypingStopParams.builder().chatId("chatId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("chatId")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParamsTest.kt
deleted file mode 100644
index 48ceab6..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveParamsTest.kt
+++ /dev/null
@@ -1,13 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.config.webhook
-
-import org.junit.jupiter.api.Test
-
-internal class WebhookRetrieveParamsTest {
-
-    @Test
-    fun create() {
-        WebhookRetrieveParams.builder().build()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponseTest.kt
deleted file mode 100644
index bea62f2..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookRetrieveResponseTest.kt
+++ /dev/null
@@ -1,41 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.config.webhook
-
-import com.blooio.api.core.jsonMapper
-import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class WebhookRetrieveResponseTest {
-
-    @Test
-    fun create() {
-        val webhookRetrieveResponse =
-            WebhookRetrieveResponse.builder()
-                .updatedAt(0L)
-                .webhookUrl("https://example.com/mywebhook")
-                .build()
-
-        assertThat(webhookRetrieveResponse.updatedAt()).contains(0L)
-        assertThat(webhookRetrieveResponse.webhookUrl()).contains("https://example.com/mywebhook")
-    }
-
-    @Test
-    fun roundtrip() {
-        val jsonMapper = jsonMapper()
-        val webhookRetrieveResponse =
-            WebhookRetrieveResponse.builder()
-                .updatedAt(0L)
-                .webhookUrl("https://example.com/mywebhook")
-                .build()
-
-        val roundtrippedWebhookRetrieveResponse =
-            jsonMapper.readValue(
-                jsonMapper.writeValueAsString(webhookRetrieveResponse),
-                jacksonTypeRef<WebhookRetrieveResponse>(),
-            )
-
-        assertThat(roundtrippedWebhookRetrieveResponse).isEqualTo(webhookRetrieveResponse)
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParamsTest.kt
deleted file mode 100644
index 4c8dda8..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateParamsTest.kt
+++ /dev/null
@@ -1,24 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.config.webhook
-
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class WebhookUpdateParamsTest {
-
-    @Test
-    fun create() {
-        WebhookUpdateParams.builder().webhookUrl("https://example.com/mywebhook").build()
-    }
-
-    @Test
-    fun body() {
-        val params =
-            WebhookUpdateParams.builder().webhookUrl("https://example.com/mywebhook").build()
-
-        val body = params._body()
-
-        assertThat(body.webhookUrl()).isEqualTo("https://example.com/mywebhook")
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponseTest.kt
deleted file mode 100644
index 6ed7923..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/config/webhook/WebhookUpdateResponseTest.kt
+++ /dev/null
@@ -1,41 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.config.webhook
-
-import com.blooio.api.core.jsonMapper
-import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class WebhookUpdateResponseTest {
-
-    @Test
-    fun create() {
-        val webhookUpdateResponse =
-            WebhookUpdateResponse.builder()
-                .message("Webhook URL updated successfully")
-                .status("success")
-                .build()
-
-        assertThat(webhookUpdateResponse.message()).contains("Webhook URL updated successfully")
-        assertThat(webhookUpdateResponse.status()).contains("success")
-    }
-
-    @Test
-    fun roundtrip() {
-        val jsonMapper = jsonMapper()
-        val webhookUpdateResponse =
-            WebhookUpdateResponse.builder()
-                .message("Webhook URL updated successfully")
-                .status("success")
-                .build()
-
-        val roundtrippedWebhookUpdateResponse =
-            jsonMapper.readValue(
-                jsonMapper.writeValueAsString(webhookUpdateResponse),
-                jacksonTypeRef<WebhookUpdateResponse>(),
-            )
-
-        assertThat(roundtrippedWebhookUpdateResponse).isEqualTo(webhookUpdateResponse)
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParamsTest.kt
index 97ee4c7..91f6d78 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesParamsTest.kt
@@ -9,14 +9,14 @@ internal class ContactCheckCapabilitiesParamsTest {
 
     @Test
     fun create() {
-        ContactCheckCapabilitiesParams.builder().contact("contact").build()
+        ContactCheckCapabilitiesParams.builder().contactId("%2B15551234567").build()
     }
 
     @Test
     fun pathParams() {
-        val params = ContactCheckCapabilitiesParams.builder().contact("contact").build()
+        val params = ContactCheckCapabilitiesParams.builder().contactId("%2B15551234567").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("contact")
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponseTest.kt
index 63d3c42..25a8ebe 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponseTest.kt
@@ -4,7 +4,6 @@ package com.blooio.api.models.contacts
 
 import com.blooio.api.core.jsonMapper
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import java.time.OffsetDateTime
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -16,25 +15,26 @@ internal class ContactCheckCapabilitiesResponseTest {
             ContactCheckCapabilitiesResponse.builder()
                 .capabilities(
                     ContactCheckCapabilitiesResponse.Capabilities.builder()
+                        .facetime(true)
                         .imessage(true)
                         .sms(true)
                         .build()
                 )
-                .contact("+1234567890")
-                .lastChecked(OffsetDateTime.parse("2024-01-01T00:00:00.000Z"))
+                .contact("contact")
+                .lastChecked(0L)
                 .type(ContactCheckCapabilitiesResponse.Type.PHONE)
                 .build()
 
         assertThat(contactCheckCapabilitiesResponse.capabilities())
             .contains(
                 ContactCheckCapabilitiesResponse.Capabilities.builder()
+                    .facetime(true)
                     .imessage(true)
                     .sms(true)
                     .build()
             )
-        assertThat(contactCheckCapabilitiesResponse.contact()).contains("+1234567890")
-        assertThat(contactCheckCapabilitiesResponse.lastChecked())
-            .contains(OffsetDateTime.parse("2024-01-01T00:00:00.000Z"))
+        assertThat(contactCheckCapabilitiesResponse.contact()).contains("contact")
+        assertThat(contactCheckCapabilitiesResponse.lastChecked()).contains(0L)
         assertThat(contactCheckCapabilitiesResponse.type())
             .contains(ContactCheckCapabilitiesResponse.Type.PHONE)
     }
@@ -46,12 +46,13 @@ internal class ContactCheckCapabilitiesResponseTest {
             ContactCheckCapabilitiesResponse.builder()
                 .capabilities(
                     ContactCheckCapabilitiesResponse.Capabilities.builder()
+                        .facetime(true)
                         .imessage(true)
                         .sms(true)
                         .build()
                 )
-                .contact("+1234567890")
-                .lastChecked(OffsetDateTime.parse("2024-01-01T00:00:00.000Z"))
+                .contact("contact")
+                .lastChecked(0L)
                 .type(ContactCheckCapabilitiesResponse.Type.PHONE)
                 .build()
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCreateParamsTest.kt
new file mode 100644
index 0000000..b5ce490
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactCreateParamsTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactCreateParamsTest {
+
+    @Test
+    fun create() {
+        ContactCreateParams.builder().identifier("+15551234567").name("John Doe").build()
+    }
+
+    @Test
+    fun body() {
+        val params =
+            ContactCreateParams.builder().identifier("+15551234567").name("John Doe").build()
+
+        val body = params._body()
+
+        assertThat(body.identifier()).isEqualTo("+15551234567")
+        assertThat(body.name()).contains("John Doe")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = ContactCreateParams.builder().identifier("+15551234567").build()
+
+        val body = params._body()
+
+        assertThat(body.identifier()).isEqualTo("+15551234567")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactDeleteParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactDeleteParamsTest.kt
new file mode 100644
index 0000000..177320a
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactDeleteParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactDeleteParamsTest {
+
+    @Test
+    fun create() {
+        ContactDeleteParams.builder().contactId("%2B15551234567").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactDeleteParams.builder().contactId("%2B15551234567").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListParamsTest.kt
new file mode 100644
index 0000000..a88aea4
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListParamsTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactListParamsTest {
+
+    @Test
+    fun create() {
+        ContactListParams.builder()
+            .limit(1L)
+            .offset(0L)
+            .q("q")
+            .sort(ContactListParams.Sort.RECENT)
+            .build()
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            ContactListParams.builder()
+                .limit(1L)
+                .offset(0L)
+                .q("q")
+                .sort(ContactListParams.Sort.RECENT)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("limit", "1")
+                    .put("offset", "0")
+                    .put("q", "q")
+                    .put("sort", "recent")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = ContactListParams.builder().build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListResponseTest.kt
new file mode 100644
index 0000000..b761d74
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactListResponseTest.kt
@@ -0,0 +1,77 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactListResponseTest {
+
+    @Test
+    fun create() {
+        val contactListResponse =
+            ContactListResponse.builder()
+                .addContact(
+                    Contact.builder()
+                        .id("id")
+                        .contactId("contact_id")
+                        .createdAt(0L)
+                        .identifier("identifier")
+                        .lastMessageTime(0L)
+                        .name("name")
+                        .addTag("string")
+                        .type(Contact.Type.PHONE)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        assertThat(contactListResponse.contacts().getOrNull())
+            .containsExactly(
+                Contact.builder()
+                    .id("id")
+                    .contactId("contact_id")
+                    .createdAt(0L)
+                    .identifier("identifier")
+                    .lastMessageTime(0L)
+                    .name("name")
+                    .addTag("string")
+                    .type(Contact.Type.PHONE)
+                    .build()
+            )
+        assertThat(contactListResponse.pagination())
+            .contains(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactListResponse =
+            ContactListResponse.builder()
+                .addContact(
+                    Contact.builder()
+                        .id("id")
+                        .contactId("contact_id")
+                        .createdAt(0L)
+                        .identifier("identifier")
+                        .lastMessageTime(0L)
+                        .name("name")
+                        .addTag("string")
+                        .type(Contact.Type.PHONE)
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        val roundtrippedContactListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactListResponse),
+                jacksonTypeRef<ContactListResponse>(),
+            )
+
+        assertThat(roundtrippedContactListResponse).isEqualTo(contactListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactRetrieveParamsTest.kt
new file mode 100644
index 0000000..99e418b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        ContactRetrieveParams.builder().contactId("%2B15551234567").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactRetrieveParams.builder().contactId("%2B15551234567").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactTest.kt
new file mode 100644
index 0000000..a6a48f4
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactTest.kt
@@ -0,0 +1,57 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactTest {
+
+    @Test
+    fun create() {
+        val contact =
+            Contact.builder()
+                .id("id")
+                .contactId("contact_id")
+                .createdAt(0L)
+                .identifier("identifier")
+                .lastMessageTime(0L)
+                .name("name")
+                .addTag("string")
+                .type(Contact.Type.PHONE)
+                .build()
+
+        assertThat(contact.id()).contains("id")
+        assertThat(contact.contactId()).contains("contact_id")
+        assertThat(contact.createdAt()).contains(0L)
+        assertThat(contact.identifier()).contains("identifier")
+        assertThat(contact.lastMessageTime()).contains(0L)
+        assertThat(contact.name()).contains("name")
+        assertThat(contact.tags().getOrNull()).containsExactly("string")
+        assertThat(contact.type()).contains(Contact.Type.PHONE)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contact =
+            Contact.builder()
+                .id("id")
+                .contactId("contact_id")
+                .createdAt(0L)
+                .identifier("identifier")
+                .lastMessageTime(0L)
+                .name("name")
+                .addTag("string")
+                .type(Contact.Type.PHONE)
+                .build()
+
+        val roundtrippedContact =
+            jsonMapper.readValue(jsonMapper.writeValueAsString(contact), jacksonTypeRef<Contact>())
+
+        assertThat(roundtrippedContact).isEqualTo(contact)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactUpdateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactUpdateParamsTest.kt
new file mode 100644
index 0000000..6d84975
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/ContactUpdateParamsTest.kt
@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactUpdateParamsTest {
+
+    @Test
+    fun create() {
+        ContactUpdateParams.builder().contactId("%2B15551234567").name("Jane Doe").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactUpdateParams.builder().contactId("%2B15551234567").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            ContactUpdateParams.builder().contactId("%2B15551234567").name("Jane Doe").build()
+
+        val body = params._body()
+
+        assertThat(body.name()).contains("Jane Doe")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = ContactUpdateParams.builder().contactId("%2B15551234567").build()
+
+        val body = params._body()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/DeleteResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/DeleteResponseTest.kt
new file mode 100644
index 0000000..66de176
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/DeleteResponseTest.kt
@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class DeleteResponseTest {
+
+    @Test
+    fun create() {
+        val deleteResponse = DeleteResponse.builder().deletedAt(0L).success(true).build()
+
+        assertThat(deleteResponse.deletedAt()).contains(0L)
+        assertThat(deleteResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val deleteResponse = DeleteResponse.builder().deletedAt(0L).success(true).build()
+
+        val roundtrippedDeleteResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(deleteResponse),
+                jacksonTypeRef<DeleteResponse>(),
+            )
+
+        assertThat(roundtrippedDeleteResponse).isEqualTo(deleteResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/PaginationTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/PaginationTest.kt
new file mode 100644
index 0000000..87765f7
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/PaginationTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PaginationTest {
+
+    @Test
+    fun create() {
+        val pagination = Pagination.builder().limit(0L).offset(0L).total(0L).build()
+
+        assertThat(pagination.limit()).contains(0L)
+        assertThat(pagination.offset()).contains(0L)
+        assertThat(pagination.total()).contains(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val pagination = Pagination.builder().limit(0L).offset(0L).total(0L).build()
+
+        val roundtrippedPagination =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(pagination),
+                jacksonTypeRef<Pagination>(),
+            )
+
+        assertThat(roundtrippedPagination).isEqualTo(pagination)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddParamsTest.kt
new file mode 100644
index 0000000..c082d33
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddParamsTest.kt
@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TagAddParamsTest {
+
+    @Test
+    fun create() {
+        TagAddParams.builder().contactId("%2B15551234567").addTag("vip").addTag("priority").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            TagAddParams.builder()
+                .contactId("%2B15551234567")
+                .addTag("vip")
+                .addTag("priority")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            TagAddParams.builder()
+                .contactId("%2B15551234567")
+                .addTag("vip")
+                .addTag("priority")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.tags()).containsExactly("vip", "priority")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddResponseTest.kt
new file mode 100644
index 0000000..64baf65
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagAddResponseTest.kt
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TagAddResponseTest {
+
+    @Test
+    fun create() {
+        val tagAddResponse =
+            TagAddResponse.builder()
+                .success(true)
+                .addTagsAdded("vip")
+                .addTagsAdded("priority")
+                .build()
+
+        assertThat(tagAddResponse.success()).contains(true)
+        assertThat(tagAddResponse.tagsAdded().getOrNull()).containsExactly("vip", "priority")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val tagAddResponse =
+            TagAddResponse.builder()
+                .success(true)
+                .addTagsAdded("vip")
+                .addTagsAdded("priority")
+                .build()
+
+        val roundtrippedTagAddResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(tagAddResponse),
+                jacksonTypeRef<TagAddResponse>(),
+            )
+
+        assertThat(roundtrippedTagAddResponse).isEqualTo(tagAddResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListParamsTest.kt
new file mode 100644
index 0000000..6d79a43
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TagListParamsTest {
+
+    @Test
+    fun create() {
+        TagListParams.builder().contactId("%2B15551234567").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = TagListParams.builder().contactId("%2B15551234567").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListResponseTest.kt
new file mode 100644
index 0000000..7fdcd63
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagListResponseTest.kt
@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TagListResponseTest {
+
+    @Test
+    fun create() {
+        val tagListResponse =
+            TagListResponse.builder()
+                .addTag(TagListResponse.Tag.builder().createdAt(0L).tag("vip").build())
+                .build()
+
+        assertThat(tagListResponse.tags().getOrNull())
+            .containsExactly(TagListResponse.Tag.builder().createdAt(0L).tag("vip").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val tagListResponse =
+            TagListResponse.builder()
+                .addTag(TagListResponse.Tag.builder().createdAt(0L).tag("vip").build())
+                .build()
+
+        val roundtrippedTagListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(tagListResponse),
+                jacksonTypeRef<TagListResponse>(),
+            )
+
+        assertThat(roundtrippedTagListResponse).isEqualTo(tagListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParamsTest.kt
new file mode 100644
index 0000000..e669dd0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/contacts/tags/TagRemoveParamsTest.kt
@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.contacts.tags
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class TagRemoveParamsTest {
+
+    @Test
+    fun create() {
+        TagRemoveParams.builder().contactId("%2B15551234567").tag("vip").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = TagRemoveParams.builder().contactId("%2B15551234567").tag("vip").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("%2B15551234567")
+        assertThat(params._pathParam(1)).isEqualTo("vip")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParamsTest.kt
new file mode 100644
index 0000000..ae392d4
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.facetime
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class FacetimeInitiateCallParamsTest {
+
+    @Test
+    fun create() {
+        FacetimeInitiateCallParams.builder().handle("+15551234567").build()
+    }
+
+    @Test
+    fun body() {
+        val params = FacetimeInitiateCallParams.builder().handle("+15551234567").build()
+
+        val body = params._body()
+
+        assertThat(body.handle()).isEqualTo("+15551234567")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponseTest.kt
new file mode 100644
index 0000000..20dd702
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponseTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.facetime
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class FacetimeInitiateCallResponseTest {
+
+    @Test
+    fun create() {
+        val facetimeInitiateCallResponse =
+            FacetimeInitiateCallResponse.builder()
+                .handle("handle")
+                .link("https://facetime.apple.com/join#v=1&p=xxx")
+                .success(true)
+                .build()
+
+        assertThat(facetimeInitiateCallResponse.handle()).contains("handle")
+        assertThat(facetimeInitiateCallResponse.link())
+            .contains("https://facetime.apple.com/join#v=1&p=xxx")
+        assertThat(facetimeInitiateCallResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val facetimeInitiateCallResponse =
+            FacetimeInitiateCallResponse.builder()
+                .handle("handle")
+                .link("https://facetime.apple.com/join#v=1&p=xxx")
+                .success(true)
+                .build()
+
+        val roundtrippedFacetimeInitiateCallResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(facetimeInitiateCallResponse),
+                jacksonTypeRef<FacetimeInitiateCallResponse>(),
+            )
+
+        assertThat(roundtrippedFacetimeInitiateCallResponse).isEqualTo(facetimeInitiateCallResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateParamsTest.kt
new file mode 100644
index 0000000..9ee9424
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateParamsTest.kt
@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupCreateParamsTest {
+
+    @Test
+    fun create() {
+        GroupCreateParams.builder()
+            .name("Sales Team")
+            .chatGuid("iMessage;+;chat123456789")
+            .addMember("+15551234567")
+            .addMember("+15559876543")
+            .build()
+    }
+
+    @Test
+    fun body() {
+        val params =
+            GroupCreateParams.builder()
+                .name("Sales Team")
+                .chatGuid("iMessage;+;chat123456789")
+                .addMember("+15551234567")
+                .addMember("+15559876543")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.name()).isEqualTo("Sales Team")
+        assertThat(body.chatGuid()).contains("iMessage;+;chat123456789")
+        assertThat(body.members().getOrNull()).containsExactly("+15551234567", "+15559876543")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = GroupCreateParams.builder().name("Sales Team").build()
+
+        val body = params._body()
+
+        assertThat(body.name()).isEqualTo("Sales Team")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateResponseTest.kt
new file mode 100644
index 0000000..b95b696
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupCreateResponseTest.kt
@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupCreateResponseTest {
+
+    @Test
+    fun create() {
+        val groupCreateResponse =
+            GroupCreateResponse.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .addAddedMember("string")
+                .addCreatedContact("string")
+                .build()
+
+        assertThat(groupCreateResponse.chatGuid()).contains("chat_guid")
+        assertThat(groupCreateResponse.createdAt()).contains(0L)
+        assertThat(groupCreateResponse.groupId()).contains("group_id")
+        assertThat(groupCreateResponse.iconUrl()).contains("icon_url")
+        assertThat(groupCreateResponse.lastMessageDirection())
+            .contains(Group.LastMessageDirection.INBOUND)
+        assertThat(groupCreateResponse.lastMessageText()).contains("last_message_text")
+        assertThat(groupCreateResponse.lastMessageTime()).contains(0L)
+        assertThat(groupCreateResponse.memberCount()).contains(0L)
+        assertThat(groupCreateResponse.messageCount()).contains(0L)
+        assertThat(groupCreateResponse.name()).contains("name")
+        assertThat(groupCreateResponse.addedMembers().getOrNull()).containsExactly("string")
+        assertThat(groupCreateResponse.createdContacts().getOrNull()).containsExactly("string")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupCreateResponse =
+            GroupCreateResponse.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .addAddedMember("string")
+                .addCreatedContact("string")
+                .build()
+
+        val roundtrippedGroupCreateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupCreateResponse),
+                jacksonTypeRef<GroupCreateResponse>(),
+            )
+
+        assertThat(roundtrippedGroupCreateResponse).isEqualTo(groupCreateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteParamsTest.kt
similarity index 51%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteParamsTest.kt
index 7282d04..936f2d0 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageGetStatusParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.messages
+package com.blooio.api.models.groups
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class MessageGetStatusParamsTest {
+internal class GroupDeleteParamsTest {
 
     @Test
     fun create() {
-        MessageGetStatusParams.builder().messageId("messageId").build()
+        GroupDeleteParams.builder().groupId("grp_abc123def456").build()
     }
 
     @Test
     fun pathParams() {
-        val params = MessageGetStatusParams.builder().messageId("messageId").build()
+        val params = GroupDeleteParams.builder().groupId("grp_abc123def456").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("messageId")
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteResponseTest.kt
new file mode 100644
index 0000000..869eb1b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupDeleteResponseTest.kt
@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupDeleteResponseTest {
+
+    @Test
+    fun create() {
+        val groupDeleteResponse = GroupDeleteResponse.builder().deletedAt(0L).success(true).build()
+
+        assertThat(groupDeleteResponse.deletedAt()).contains(0L)
+        assertThat(groupDeleteResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupDeleteResponse = GroupDeleteResponse.builder().deletedAt(0L).success(true).build()
+
+        val roundtrippedGroupDeleteResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupDeleteResponse),
+                jacksonTypeRef<GroupDeleteResponse>(),
+            )
+
+        assertThat(roundtrippedGroupDeleteResponse).isEqualTo(groupDeleteResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListParamsTest.kt
new file mode 100644
index 0000000..7e13873
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListParamsTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupListParamsTest {
+
+    @Test
+    fun create() {
+        GroupListParams.builder()
+            .limit(1L)
+            .offset(0L)
+            .q("q")
+            .sort(GroupListParams.Sort.RECENT)
+            .build()
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            GroupListParams.builder()
+                .limit(1L)
+                .offset(0L)
+                .q("q")
+                .sort(GroupListParams.Sort.RECENT)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("limit", "1")
+                    .put("offset", "0")
+                    .put("q", "q")
+                    .put("sort", "recent")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = GroupListParams.builder().build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListResponseTest.kt
new file mode 100644
index 0000000..2c77927
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupListResponseTest.kt
@@ -0,0 +1,84 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.jsonMapper
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupListResponseTest {
+
+    @Test
+    fun create() {
+        val groupListResponse =
+            GroupListResponse.builder()
+                .addGroup(
+                    Group.builder()
+                        .chatGuid("chat_guid")
+                        .createdAt(0L)
+                        .groupId("group_id")
+                        .iconUrl("icon_url")
+                        .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                        .lastMessageText("last_message_text")
+                        .lastMessageTime(0L)
+                        .memberCount(0L)
+                        .messageCount(0L)
+                        .name("name")
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        assertThat(groupListResponse.groups().getOrNull())
+            .containsExactly(
+                Group.builder()
+                    .chatGuid("chat_guid")
+                    .createdAt(0L)
+                    .groupId("group_id")
+                    .iconUrl("icon_url")
+                    .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                    .lastMessageText("last_message_text")
+                    .lastMessageTime(0L)
+                    .memberCount(0L)
+                    .messageCount(0L)
+                    .name("name")
+                    .build()
+            )
+        assertThat(groupListResponse.pagination())
+            .contains(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupListResponse =
+            GroupListResponse.builder()
+                .addGroup(
+                    Group.builder()
+                        .chatGuid("chat_guid")
+                        .createdAt(0L)
+                        .groupId("group_id")
+                        .iconUrl("icon_url")
+                        .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                        .lastMessageText("last_message_text")
+                        .lastMessageTime(0L)
+                        .memberCount(0L)
+                        .messageCount(0L)
+                        .name("name")
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        val roundtrippedGroupListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupListResponse),
+                jacksonTypeRef<GroupListResponse>(),
+            )
+
+        assertThat(roundtrippedGroupListResponse).isEqualTo(groupListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupRetrieveParamsTest.kt
new file mode 100644
index 0000000..e749942
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        GroupRetrieveParams.builder().groupId("grp_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = GroupRetrieveParams.builder().groupId("grp_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupTest.kt
new file mode 100644
index 0000000..8e7616f
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupTest.kt
@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupTest {
+
+    @Test
+    fun create() {
+        val group =
+            Group.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .build()
+
+        assertThat(group.chatGuid()).contains("chat_guid")
+        assertThat(group.createdAt()).contains(0L)
+        assertThat(group.groupId()).contains("group_id")
+        assertThat(group.iconUrl()).contains("icon_url")
+        assertThat(group.lastMessageDirection()).contains(Group.LastMessageDirection.INBOUND)
+        assertThat(group.lastMessageText()).contains("last_message_text")
+        assertThat(group.lastMessageTime()).contains(0L)
+        assertThat(group.memberCount()).contains(0L)
+        assertThat(group.messageCount()).contains(0L)
+        assertThat(group.name()).contains("name")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val group =
+            Group.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .build()
+
+        val roundtrippedGroup =
+            jsonMapper.readValue(jsonMapper.writeValueAsString(group), jacksonTypeRef<Group>())
+
+        assertThat(roundtrippedGroup).isEqualTo(group)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateParamsTest.kt
new file mode 100644
index 0000000..c77dfd2
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateParamsTest.kt
@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupUpdateParamsTest {
+
+    @Test
+    fun create() {
+        GroupUpdateParams.builder().groupId("grp_abc123def456").name("Marketing Team").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = GroupUpdateParams.builder().groupId("grp_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            GroupUpdateParams.builder().groupId("grp_abc123def456").name("Marketing Team").build()
+
+        val body = params._body()
+
+        assertThat(body.name()).contains("Marketing Team")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = GroupUpdateParams.builder().groupId("grp_abc123def456").build()
+
+        val body = params._body()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateResponseTest.kt
new file mode 100644
index 0000000..23d2bb0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/GroupUpdateResponseTest.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupUpdateResponseTest {
+
+    @Test
+    fun create() {
+        val groupUpdateResponse =
+            GroupUpdateResponse.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .deviceSync(
+                    GroupUpdateResponse.DeviceSync.builder()
+                        .action(GroupUpdateResponse.DeviceSync.Action.ADD_PARTICIPANT)
+                        .chatGuid("chat_guid")
+                        .error("error")
+                        .synced(true)
+                        .build()
+                )
+                .build()
+
+        assertThat(groupUpdateResponse.chatGuid()).contains("chat_guid")
+        assertThat(groupUpdateResponse.createdAt()).contains(0L)
+        assertThat(groupUpdateResponse.groupId()).contains("group_id")
+        assertThat(groupUpdateResponse.iconUrl()).contains("icon_url")
+        assertThat(groupUpdateResponse.lastMessageDirection())
+            .contains(Group.LastMessageDirection.INBOUND)
+        assertThat(groupUpdateResponse.lastMessageText()).contains("last_message_text")
+        assertThat(groupUpdateResponse.lastMessageTime()).contains(0L)
+        assertThat(groupUpdateResponse.memberCount()).contains(0L)
+        assertThat(groupUpdateResponse.messageCount()).contains(0L)
+        assertThat(groupUpdateResponse.name()).contains("name")
+        assertThat(groupUpdateResponse.deviceSync())
+            .contains(
+                GroupUpdateResponse.DeviceSync.builder()
+                    .action(GroupUpdateResponse.DeviceSync.Action.ADD_PARTICIPANT)
+                    .chatGuid("chat_guid")
+                    .error("error")
+                    .synced(true)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupUpdateResponse =
+            GroupUpdateResponse.builder()
+                .chatGuid("chat_guid")
+                .createdAt(0L)
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .lastMessageDirection(Group.LastMessageDirection.INBOUND)
+                .lastMessageText("last_message_text")
+                .lastMessageTime(0L)
+                .memberCount(0L)
+                .messageCount(0L)
+                .name("name")
+                .deviceSync(
+                    GroupUpdateResponse.DeviceSync.builder()
+                        .action(GroupUpdateResponse.DeviceSync.Action.ADD_PARTICIPANT)
+                        .chatGuid("chat_guid")
+                        .error("error")
+                        .synced(true)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedGroupUpdateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupUpdateResponse),
+                jacksonTypeRef<GroupUpdateResponse>(),
+            )
+
+        assertThat(roundtrippedGroupUpdateResponse).isEqualTo(groupUpdateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/GroupIconTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/GroupIconTest.kt
new file mode 100644
index 0000000..ad94e56
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/GroupIconTest.kt
@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.icon
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupIconTest {
+
+    @Test
+    fun create() {
+        val groupIcon =
+            GroupIcon.builder()
+                .chatGuid("chat_guid")
+                .deviceSync(
+                    GroupIcon.DeviceSync.builder()
+                        .chatGuid("chat_guid")
+                        .message("message")
+                        .synced(true)
+                        .build()
+                )
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .message("message")
+                .success(true)
+                .build()
+
+        assertThat(groupIcon.chatGuid()).contains("chat_guid")
+        assertThat(groupIcon.deviceSync())
+            .contains(
+                GroupIcon.DeviceSync.builder()
+                    .chatGuid("chat_guid")
+                    .message("message")
+                    .synced(true)
+                    .build()
+            )
+        assertThat(groupIcon.groupId()).contains("group_id")
+        assertThat(groupIcon.iconUrl()).contains("icon_url")
+        assertThat(groupIcon.message()).contains("message")
+        assertThat(groupIcon.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupIcon =
+            GroupIcon.builder()
+                .chatGuid("chat_guid")
+                .deviceSync(
+                    GroupIcon.DeviceSync.builder()
+                        .chatGuid("chat_guid")
+                        .message("message")
+                        .synced(true)
+                        .build()
+                )
+                .groupId("group_id")
+                .iconUrl("icon_url")
+                .message("message")
+                .success(true)
+                .build()
+
+        val roundtrippedGroupIcon =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupIcon),
+                jacksonTypeRef<GroupIcon>(),
+            )
+
+        assertThat(roundtrippedGroupIcon).isEqualTo(groupIcon)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconRemoveParamsTest.kt
similarity index 51%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconRemoveParamsTest.kt
index d2dbd1d..68f02b4 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchRetrieveStatusParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconRemoveParamsTest.kt
@@ -1,22 +1,22 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.groups.icon
 
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
-internal class BatchRetrieveStatusParamsTest {
+internal class IconRemoveParamsTest {
 
     @Test
     fun create() {
-        BatchRetrieveStatusParams.builder().batchId("batchId").build()
+        IconRemoveParams.builder().groupId("grp_abc123def456").build()
     }
 
     @Test
     fun pathParams() {
-        val params = BatchRetrieveStatusParams.builder().batchId("batchId").build()
+        val params = IconRemoveParams.builder().groupId("grp_abc123def456").build()
 
-        assertThat(params._pathParam(0)).isEqualTo("batchId")
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
         // out-of-bound path param
         assertThat(params._pathParam(1)).isEqualTo("")
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconSetParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconSetParamsTest.kt
new file mode 100644
index 0000000..0a00676
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/icon/IconSetParamsTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.icon
+
+import com.blooio.api.core.MultipartField
+import java.io.InputStream
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class IconSetParamsTest {
+
+    @Test
+    fun create() {
+        IconSetParams.builder()
+            .groupId("grp_abc123def456")
+            .icon("Example data".byteInputStream())
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            IconSetParams.builder()
+                .groupId("grp_abc123def456")
+                .icon("Example data".byteInputStream())
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            IconSetParams.builder()
+                .groupId("grp_abc123def456")
+                .icon("Example data".byteInputStream())
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.filterValues { !it.value.isNull() })
+            .usingRecursiveComparison()
+            // TODO(AssertJ): Replace this and the `mapValues` below with:
+            // https://github.com/assertj/assertj/issues/3165
+            .withEqualsForType(
+                { a, b -> a.readBytes() contentEquals b.readBytes() },
+                InputStream::class.java,
+            )
+            .isEqualTo(
+                mapOf("icon" to MultipartField.of("Example data".byteInputStream())).mapValues {
+                    (_, field) ->
+                    field.map { (it as? ByteArray)?.inputStream() ?: it }
+                }
+            )
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/GroupMemberTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/GroupMemberTest.kt
new file mode 100644
index 0000000..9e44718
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/GroupMemberTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class GroupMemberTest {
+
+    @Test
+    fun create() {
+        val groupMember =
+            GroupMember.builder()
+                .id("id")
+                .addedAt(0L)
+                .contactId("contact_id")
+                .identifier("identifier")
+                .name("name")
+                .build()
+
+        assertThat(groupMember.id()).contains("id")
+        assertThat(groupMember.addedAt()).contains(0L)
+        assertThat(groupMember.contactId()).contains("contact_id")
+        assertThat(groupMember.identifier()).contains("identifier")
+        assertThat(groupMember.name()).contains("name")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val groupMember =
+            GroupMember.builder()
+                .id("id")
+                .addedAt(0L)
+                .contactId("contact_id")
+                .identifier("identifier")
+                .name("name")
+                .build()
+
+        val roundtrippedGroupMember =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(groupMember),
+                jacksonTypeRef<GroupMember>(),
+            )
+
+        assertThat(roundtrippedGroupMember).isEqualTo(groupMember)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddParamsTest.kt
new file mode 100644
index 0000000..0791183
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddParamsTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberAddParamsTest {
+
+    @Test
+    fun create() {
+        MemberAddParams.builder().groupId("grp_abc123def456").contactId("+15551234567").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            MemberAddParams.builder().groupId("grp_abc123def456").contactId("+15551234567").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            MemberAddParams.builder().groupId("grp_abc123def456").contactId("+15551234567").build()
+
+        val body = params._body()
+
+        assertThat(body.contactId()).isEqualTo("+15551234567")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddResponseTest.kt
new file mode 100644
index 0000000..a85e9cc
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberAddResponseTest.kt
@@ -0,0 +1,66 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberAddResponseTest {
+
+    @Test
+    fun create() {
+        val memberAddResponse =
+            MemberAddResponse.builder()
+                .member(
+                    GroupMember.builder()
+                        .id("id")
+                        .addedAt(0L)
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .message("message")
+                .build()
+
+        assertThat(memberAddResponse.member())
+            .contains(
+                GroupMember.builder()
+                    .id("id")
+                    .addedAt(0L)
+                    .contactId("contact_id")
+                    .identifier("identifier")
+                    .name("name")
+                    .build()
+            )
+        assertThat(memberAddResponse.message()).contains("message")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val memberAddResponse =
+            MemberAddResponse.builder()
+                .member(
+                    GroupMember.builder()
+                        .id("id")
+                        .addedAt(0L)
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .message("message")
+                .build()
+
+        val roundtrippedMemberAddResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(memberAddResponse),
+                jacksonTypeRef<MemberAddResponse>(),
+            )
+
+        assertThat(roundtrippedMemberAddResponse).isEqualTo(memberAddResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListParamsTest.kt
new file mode 100644
index 0000000..ac77aba
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListParamsTest.kt
@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberListParamsTest {
+
+    @Test
+    fun create() {
+        MemberListParams.builder().groupId("grp_abc123def456").limit(1L).offset(0L).build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = MemberListParams.builder().groupId("grp_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            MemberListParams.builder().groupId("grp_abc123def456").limit(1L).offset(0L).build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(QueryParams.builder().put("limit", "1").put("offset", "0").build())
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = MemberListParams.builder().groupId("grp_abc123def456").build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListResponseTest.kt
new file mode 100644
index 0000000..d1c60b4
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberListResponseTest.kt
@@ -0,0 +1,78 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.jsonMapper
+import com.blooio.api.models.contacts.Pagination
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberListResponseTest {
+
+    @Test
+    fun create() {
+        val memberListResponse =
+            MemberListResponse.builder()
+                .groupId("group_id")
+                .groupName("group_name")
+                .iconUrl("icon_url")
+                .addMember(
+                    GroupMember.builder()
+                        .id("id")
+                        .addedAt(0L)
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        assertThat(memberListResponse.groupId()).contains("group_id")
+        assertThat(memberListResponse.groupName()).contains("group_name")
+        assertThat(memberListResponse.iconUrl()).contains("icon_url")
+        assertThat(memberListResponse.members().getOrNull())
+            .containsExactly(
+                GroupMember.builder()
+                    .id("id")
+                    .addedAt(0L)
+                    .contactId("contact_id")
+                    .identifier("identifier")
+                    .name("name")
+                    .build()
+            )
+        assertThat(memberListResponse.pagination())
+            .contains(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val memberListResponse =
+            MemberListResponse.builder()
+                .groupId("group_id")
+                .groupName("group_name")
+                .iconUrl("icon_url")
+                .addMember(
+                    GroupMember.builder()
+                        .id("id")
+                        .addedAt(0L)
+                        .contactId("contact_id")
+                        .identifier("identifier")
+                        .name("name")
+                        .build()
+                )
+                .pagination(Pagination.builder().limit(0L).offset(0L).total(0L).build())
+                .build()
+
+        val roundtrippedMemberListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(memberListResponse),
+                jacksonTypeRef<MemberListResponse>(),
+            )
+
+        assertThat(roundtrippedMemberListResponse).isEqualTo(memberListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveParamsTest.kt
new file mode 100644
index 0000000..754204f
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveParamsTest.kt
@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberRemoveParamsTest {
+
+    @Test
+    fun create() {
+        MemberRemoveParams.builder().groupId("grp_abc123def456").contactId("%2B15551234567").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            MemberRemoveParams.builder()
+                .groupId("grp_abc123def456")
+                .contactId("%2B15551234567")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("grp_abc123def456")
+        assertThat(params._pathParam(1)).isEqualTo("%2B15551234567")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponseTest.kt
new file mode 100644
index 0000000..ca5d802
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponseTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.groups.members
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class MemberRemoveResponseTest {
+
+    @Test
+    fun create() {
+        val memberRemoveResponse =
+            MemberRemoveResponse.builder().removedAt(0L).success(true).build()
+
+        assertThat(memberRemoveResponse.removedAt()).contains(0L)
+        assertThat(memberRemoveResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val memberRemoveResponse =
+            MemberRemoveResponse.builder().removedAt(0L).success(true).build()
+
+        val roundtrippedMemberRemoveResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(memberRemoveResponse),
+                jacksonTypeRef<MemberRemoveResponse>(),
+            )
+
+        assertThat(roundtrippedMemberRemoveResponse).isEqualTo(memberRemoveResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListParamsTest.kt
new file mode 100644
index 0000000..18753f0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListParamsTest.kt
@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import org.junit.jupiter.api.Test
+
+internal class ContactListParamsTest {
+
+    @Test
+    fun create() {
+        ContactListParams.builder().build()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListResponseTest.kt
new file mode 100644
index 0000000..cbd1302
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactListResponseTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactListResponseTest {
+
+    @Test
+    fun create() {
+        val contactListResponse =
+            ContactListResponse.builder()
+                .addFriend(
+                    ContactLocation.builder()
+                        .addCoordinate(0.0)
+                        .handle("handle")
+                        .lastUpdated(0L)
+                        .status("status")
+                        .build()
+                )
+                .build()
+
+        assertThat(contactListResponse.friends().getOrNull())
+            .containsExactly(
+                ContactLocation.builder()
+                    .addCoordinate(0.0)
+                    .handle("handle")
+                    .lastUpdated(0L)
+                    .status("status")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactListResponse =
+            ContactListResponse.builder()
+                .addFriend(
+                    ContactLocation.builder()
+                        .addCoordinate(0.0)
+                        .handle("handle")
+                        .lastUpdated(0L)
+                        .status("status")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedContactListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactListResponse),
+                jacksonTypeRef<ContactListResponse>(),
+            )
+
+        assertThat(roundtrippedContactListResponse).isEqualTo(contactListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactLocationTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactLocationTest.kt
new file mode 100644
index 0000000..25ddfc1
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactLocationTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactLocationTest {
+
+    @Test
+    fun create() {
+        val contactLocation =
+            ContactLocation.builder()
+                .addCoordinate(0.0)
+                .handle("handle")
+                .lastUpdated(0L)
+                .status("status")
+                .build()
+
+        assertThat(contactLocation.coordinates().getOrNull()).containsExactly(0.0)
+        assertThat(contactLocation.handle()).contains("handle")
+        assertThat(contactLocation.lastUpdated()).contains(0L)
+        assertThat(contactLocation.status()).contains("status")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactLocation =
+            ContactLocation.builder()
+                .addCoordinate(0.0)
+                .handle("handle")
+                .lastUpdated(0L)
+                .status("status")
+                .build()
+
+        val roundtrippedContactLocation =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactLocation),
+                jacksonTypeRef<ContactLocation>(),
+            )
+
+        assertThat(roundtrippedContactLocation).isEqualTo(contactLocation)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParamsTest.kt
new file mode 100644
index 0000000..ba77e57
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshParamsTest.kt
@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import org.junit.jupiter.api.Test
+
+internal class ContactRefreshParamsTest {
+
+    @Test
+    fun create() {
+        ContactRefreshParams.builder().build()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponseTest.kt
new file mode 100644
index 0000000..5957af2
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponseTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactRefreshResponseTest {
+
+    @Test
+    fun create() {
+        val contactRefreshResponse =
+            ContactRefreshResponse.builder()
+                .addFriend(
+                    ContactLocation.builder()
+                        .addCoordinate(0.0)
+                        .handle("handle")
+                        .lastUpdated(0L)
+                        .status("status")
+                        .build()
+                )
+                .success(true)
+                .build()
+
+        assertThat(contactRefreshResponse.friends().getOrNull())
+            .containsExactly(
+                ContactLocation.builder()
+                    .addCoordinate(0.0)
+                    .handle("handle")
+                    .lastUpdated(0L)
+                    .status("status")
+                    .build()
+            )
+        assertThat(contactRefreshResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactRefreshResponse =
+            ContactRefreshResponse.builder()
+                .addFriend(
+                    ContactLocation.builder()
+                        .addCoordinate(0.0)
+                        .handle("handle")
+                        .lastUpdated(0L)
+                        .status("status")
+                        .build()
+                )
+                .success(true)
+                .build()
+
+        val roundtrippedContactRefreshResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactRefreshResponse),
+                jacksonTypeRef<ContactRefreshResponse>(),
+            )
+
+        assertThat(roundtrippedContactRefreshResponse).isEqualTo(contactRefreshResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParamsTest.kt
new file mode 100644
index 0000000..80eea17
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/location/contacts/ContactRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.location.contacts
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        ContactRetrieveParams.builder().handle("handle").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactRetrieveParams.builder().handle("handle").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("handle")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
index eb84d00..defc66c 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
@@ -15,60 +15,69 @@ internal class MeRetrieveResponseTest {
     fun create() {
         val meRetrieveResponse =
             MeRetrieveResponse.builder()
-                .apiKey("VTAsewjhLz4KUcf3rt8tu")
+                .apiKey("api_key")
+                .authType(MeRetrieveResponse.AuthType.API_KEY)
                 .addDevice(
                     MeRetrieveResponse.Device.builder()
-                        .deviceHash("device_hash")
                         .isActive(true)
                         .lastActive(0L)
+                        .phoneNumber("phone_number")
                         .build()
                 )
-                .integrationDetails(
-                    MeRetrieveResponse.IntegrationDetails.builder()
-                        .customerWebhookUrl("https://example.com")
-                        .metadata(JsonValue.from(mapOf<String, Any>()))
+                .integrationDetails(JsonValue.from(mapOf<String, Any>()))
+                .metadata(JsonValue.from(mapOf<String, Any>()))
+                .organization(
+                    MeRetrieveResponse.Organization.builder()
+                        .countryCode("country_code")
+                        .createdAt(0L)
                         .name("name")
+                        .organizationId("organization_id")
                         .build()
                 )
-                .metadata(JsonValue.from(mapOf<String, Any>()))
-                .plan("trial")
+                .organizationId("organization_id")
                 .usage(
                     MeRetrieveResponse.Usage.builder()
-                        .inboundMessages(42L)
+                        .inboundMessages(0L)
                         .lastMessageSent(0L)
-                        .outboundMessages(156L)
+                        .outboundMessages(0L)
                         .build()
                 )
+                .userId("user_id")
                 .valid(true)
                 .build()
 
-        assertThat(meRetrieveResponse.apiKey()).contains("VTAsewjhLz4KUcf3rt8tu")
+        assertThat(meRetrieveResponse.apiKey()).contains("api_key")
+        assertThat(meRetrieveResponse.authType()).contains(MeRetrieveResponse.AuthType.API_KEY)
         assertThat(meRetrieveResponse.devices().getOrNull())
             .containsExactly(
                 MeRetrieveResponse.Device.builder()
-                    .deviceHash("device_hash")
                     .isActive(true)
                     .lastActive(0L)
+                    .phoneNumber("phone_number")
                     .build()
             )
-        assertThat(meRetrieveResponse.integrationDetails())
+        assertThat(meRetrieveResponse._integrationDetails())
+            .isEqualTo(JsonValue.from(mapOf<String, Any>()))
+        assertThat(meRetrieveResponse._metadata()).isEqualTo(JsonValue.from(mapOf<String, Any>()))
+        assertThat(meRetrieveResponse.organization())
             .contains(
-                MeRetrieveResponse.IntegrationDetails.builder()
-                    .customerWebhookUrl("https://example.com")
-                    .metadata(JsonValue.from(mapOf<String, Any>()))
+                MeRetrieveResponse.Organization.builder()
+                    .countryCode("country_code")
+                    .createdAt(0L)
                     .name("name")
+                    .organizationId("organization_id")
                     .build()
             )
-        assertThat(meRetrieveResponse._metadata()).isEqualTo(JsonValue.from(mapOf<String, Any>()))
-        assertThat(meRetrieveResponse.plan()).contains("trial")
+        assertThat(meRetrieveResponse.organizationId()).contains("organization_id")
         assertThat(meRetrieveResponse.usage())
             .contains(
                 MeRetrieveResponse.Usage.builder()
-                    .inboundMessages(42L)
+                    .inboundMessages(0L)
                     .lastMessageSent(0L)
-                    .outboundMessages(156L)
+                    .outboundMessages(0L)
                     .build()
             )
+        assertThat(meRetrieveResponse.userId()).contains("user_id")
         assertThat(meRetrieveResponse.valid()).contains(true)
     }
 
@@ -77,30 +86,34 @@ internal class MeRetrieveResponseTest {
         val jsonMapper = jsonMapper()
         val meRetrieveResponse =
             MeRetrieveResponse.builder()
-                .apiKey("VTAsewjhLz4KUcf3rt8tu")
+                .apiKey("api_key")
+                .authType(MeRetrieveResponse.AuthType.API_KEY)
                 .addDevice(
                     MeRetrieveResponse.Device.builder()
-                        .deviceHash("device_hash")
                         .isActive(true)
                         .lastActive(0L)
+                        .phoneNumber("phone_number")
                         .build()
                 )
-                .integrationDetails(
-                    MeRetrieveResponse.IntegrationDetails.builder()
-                        .customerWebhookUrl("https://example.com")
-                        .metadata(JsonValue.from(mapOf<String, Any>()))
+                .integrationDetails(JsonValue.from(mapOf<String, Any>()))
+                .metadata(JsonValue.from(mapOf<String, Any>()))
+                .organization(
+                    MeRetrieveResponse.Organization.builder()
+                        .countryCode("country_code")
+                        .createdAt(0L)
                         .name("name")
+                        .organizationId("organization_id")
                         .build()
                 )
-                .metadata(JsonValue.from(mapOf<String, Any>()))
-                .plan("trial")
+                .organizationId("organization_id")
                 .usage(
                     MeRetrieveResponse.Usage.builder()
-                        .inboundMessages(42L)
+                        .inboundMessages(0L)
                         .lastMessageSent(0L)
-                        .outboundMessages(156L)
+                        .outboundMessages(0L)
                         .build()
                 )
+                .userId("user_id")
                 .valid(true)
                 .build()
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListParamsTest.kt
similarity index 51%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchCreateParamsTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListParamsTest.kt
index 1ad1780..248a3cd 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/batches/BatchCreateParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListParamsTest.kt
@@ -1,13 +1,13 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.models.batches
+package com.blooio.api.models.me.numbers
 
 import org.junit.jupiter.api.Test
 
-internal class BatchCreateParamsTest {
+internal class NumberListParamsTest {
 
     @Test
     fun create() {
-        BatchCreateParams.builder().build()
+        NumberListParams.builder().build()
     }
 }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
new file mode 100644
index 0000000..2bb9da7
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import java.time.OffsetDateTime
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class NumberListResponseTest {
+
+    @Test
+    fun create() {
+        val numberListResponse =
+            NumberListResponse.builder()
+                .addNumber(
+                    NumberListResponse.Number.builder()
+                        .isActive(true)
+                        .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                        .phoneNumber("+15551234567")
+                        .build()
+                )
+                .build()
+
+        assertThat(numberListResponse.numbers().getOrNull())
+            .containsExactly(
+                NumberListResponse.Number.builder()
+                    .isActive(true)
+                    .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                    .phoneNumber("+15551234567")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val numberListResponse =
+            NumberListResponse.builder()
+                .addNumber(
+                    NumberListResponse.Number.builder()
+                        .isActive(true)
+                        .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
+                        .phoneNumber("+15551234567")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedNumberListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(numberListResponse),
+                jacksonTypeRef<NumberListResponse>(),
+            )
+
+        assertThat(roundtrippedNumberListResponse).isEqualTo(numberListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParamsTest.kt
new file mode 100644
index 0000000..3ca31d0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactCardRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        ContactCardRetrieveParams.builder().number("number").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactCardRetrieveParams.builder().number("number").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("number")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponseTest.kt
new file mode 100644
index 0000000..b984901
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponseTest.kt
@@ -0,0 +1,75 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactCardRetrieveResponseTest {
+
+    @Test
+    fun create() {
+        val contactCardRetrieveResponse =
+            ContactCardRetrieveResponse.builder()
+                .avatar("avatar")
+                .firstName("first_name")
+                .hasWallpaper(true)
+                .lastName("last_name")
+                .name("name")
+                .phoneNumber("phone_number")
+                .sharing(
+                    ContactCardRetrieveResponse.Sharing.builder()
+                        .audience(0L)
+                        .enabled(true)
+                        .nameFormat(0L)
+                        .build()
+                )
+                .build()
+
+        assertThat(contactCardRetrieveResponse.avatar()).contains("avatar")
+        assertThat(contactCardRetrieveResponse.firstName()).contains("first_name")
+        assertThat(contactCardRetrieveResponse.hasWallpaper()).contains(true)
+        assertThat(contactCardRetrieveResponse.lastName()).contains("last_name")
+        assertThat(contactCardRetrieveResponse.name()).contains("name")
+        assertThat(contactCardRetrieveResponse.phoneNumber()).contains("phone_number")
+        assertThat(contactCardRetrieveResponse.sharing())
+            .contains(
+                ContactCardRetrieveResponse.Sharing.builder()
+                    .audience(0L)
+                    .enabled(true)
+                    .nameFormat(0L)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactCardRetrieveResponse =
+            ContactCardRetrieveResponse.builder()
+                .avatar("avatar")
+                .firstName("first_name")
+                .hasWallpaper(true)
+                .lastName("last_name")
+                .name("name")
+                .phoneNumber("phone_number")
+                .sharing(
+                    ContactCardRetrieveResponse.Sharing.builder()
+                        .audience(0L)
+                        .enabled(true)
+                        .nameFormat(0L)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedContactCardRetrieveResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactCardRetrieveResponse),
+                jacksonTypeRef<ContactCardRetrieveResponse>(),
+            )
+
+        assertThat(roundtrippedContactCardRetrieveResponse).isEqualTo(contactCardRetrieveResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParamsTest.kt
new file mode 100644
index 0000000..2b49b81
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParamsTest.kt
@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactCardUpdateParamsTest {
+
+    @Test
+    fun create() {
+        ContactCardUpdateParams.builder()
+            .number("number")
+            .avatar("avatar")
+            .firstName("first_name")
+            .lastName("last_name")
+            .sharing(
+                ContactCardUpdateParams.Sharing.builder()
+                    .audience(0L)
+                    .enabled(true)
+                    .nameFormat(0L)
+                    .build()
+            )
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = ContactCardUpdateParams.builder().number("number").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("number")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            ContactCardUpdateParams.builder()
+                .number("number")
+                .avatar("avatar")
+                .firstName("first_name")
+                .lastName("last_name")
+                .sharing(
+                    ContactCardUpdateParams.Sharing.builder()
+                        .audience(0L)
+                        .enabled(true)
+                        .nameFormat(0L)
+                        .build()
+                )
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.avatar()).contains("avatar")
+        assertThat(body.firstName()).contains("first_name")
+        assertThat(body.lastName()).contains("last_name")
+        assertThat(body.sharing())
+            .contains(
+                ContactCardUpdateParams.Sharing.builder()
+                    .audience(0L)
+                    .enabled(true)
+                    .nameFormat(0L)
+                    .build()
+            )
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = ContactCardUpdateParams.builder().number("number").build()
+
+        val body = params._body()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponseTest.kt
new file mode 100644
index 0000000..4f7136c
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponseTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.me.numbers.contactcard
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ContactCardUpdateResponseTest {
+
+    @Test
+    fun create() {
+        val contactCardUpdateResponse =
+            ContactCardUpdateResponse.builder()
+                .firstName("first_name")
+                .lastName("last_name")
+                .phoneNumber("phone_number")
+                .success(true)
+                .build()
+
+        assertThat(contactCardUpdateResponse.firstName()).contains("first_name")
+        assertThat(contactCardUpdateResponse.lastName()).contains("last_name")
+        assertThat(contactCardUpdateResponse.phoneNumber()).contains("phone_number")
+        assertThat(contactCardUpdateResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val contactCardUpdateResponse =
+            ContactCardUpdateResponse.builder()
+                .firstName("first_name")
+                .lastName("last_name")
+                .phoneNumber("phone_number")
+                .success(true)
+                .build()
+
+        val roundtrippedContactCardUpdateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(contactCardUpdateResponse),
+                jacksonTypeRef<ContactCardUpdateResponse>(),
+            )
+
+        assertThat(roundtrippedContactCardUpdateResponse).isEqualTo(contactCardUpdateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelResponseTest.kt
deleted file mode 100644
index 616ddfd..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageCancelResponseTest.kt
+++ /dev/null
@@ -1,50 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.messages
-
-import com.blooio.api.core.jsonMapper
-import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class MessageCancelResponseTest {
-
-    @Test
-    fun create() {
-        val messageCancelResponse =
-            MessageCancelResponse.builder()
-                .cancelled(true)
-                .currentStatus("current_status")
-                .message("message")
-                .messageId("message_id")
-                .status("status")
-                .build()
-
-        assertThat(messageCancelResponse.cancelled()).contains(true)
-        assertThat(messageCancelResponse.currentStatus()).contains("current_status")
-        assertThat(messageCancelResponse.message()).contains("message")
-        assertThat(messageCancelResponse.messageId()).contains("message_id")
-        assertThat(messageCancelResponse.status()).contains("status")
-    }
-
-    @Test
-    fun roundtrip() {
-        val jsonMapper = jsonMapper()
-        val messageCancelResponse =
-            MessageCancelResponse.builder()
-                .cancelled(true)
-                .currentStatus("current_status")
-                .message("message")
-                .messageId("message_id")
-                .status("status")
-                .build()
-
-        val roundtrippedMessageCancelResponse =
-            jsonMapper.readValue(
-                jsonMapper.writeValueAsString(messageCancelResponse),
-                jacksonTypeRef<MessageCancelResponse>(),
-            )
-
-        assertThat(roundtrippedMessageCancelResponse).isEqualTo(messageCancelResponse)
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveResponseTest.kt
deleted file mode 100644
index 17c52dd..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageRetrieveResponseTest.kt
+++ /dev/null
@@ -1,69 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.messages
-
-import com.blooio.api.core.JsonValue
-import com.blooio.api.core.jsonMapper
-import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class MessageRetrieveResponseTest {
-
-    @Test
-    fun create() {
-        val messageRetrieveResponse =
-            MessageRetrieveResponse.builder()
-                .apiKey("api_key")
-                .attachmentsCount(0L)
-                .direction(MessageRetrieveResponse.Direction.OUTBOUND)
-                .externalId("external_id")
-                .messageId("message_id")
-                .metadata(JsonValue.from(mapOf<String, Any>()))
-                .protocol("imessage")
-                .status(MessageRetrieveResponse.Status.PENDING)
-                .textLength(0L)
-                .timeSent(0L)
-                .build()
-
-        assertThat(messageRetrieveResponse.apiKey()).contains("api_key")
-        assertThat(messageRetrieveResponse.attachmentsCount()).contains(0L)
-        assertThat(messageRetrieveResponse.direction())
-            .contains(MessageRetrieveResponse.Direction.OUTBOUND)
-        assertThat(messageRetrieveResponse.externalId()).contains("external_id")
-        assertThat(messageRetrieveResponse.messageId()).contains("message_id")
-        assertThat(messageRetrieveResponse._metadata())
-            .isEqualTo(JsonValue.from(mapOf<String, Any>()))
-        assertThat(messageRetrieveResponse.protocol()).contains("imessage")
-        assertThat(messageRetrieveResponse.status())
-            .contains(MessageRetrieveResponse.Status.PENDING)
-        assertThat(messageRetrieveResponse.textLength()).contains(0L)
-        assertThat(messageRetrieveResponse.timeSent()).contains(0L)
-    }
-
-    @Test
-    fun roundtrip() {
-        val jsonMapper = jsonMapper()
-        val messageRetrieveResponse =
-            MessageRetrieveResponse.builder()
-                .apiKey("api_key")
-                .attachmentsCount(0L)
-                .direction(MessageRetrieveResponse.Direction.OUTBOUND)
-                .externalId("external_id")
-                .messageId("message_id")
-                .metadata(JsonValue.from(mapOf<String, Any>()))
-                .protocol("imessage")
-                .status(MessageRetrieveResponse.Status.PENDING)
-                .textLength(0L)
-                .timeSent(0L)
-                .build()
-
-        val roundtrippedMessageRetrieveResponse =
-            jsonMapper.readValue(
-                jsonMapper.writeValueAsString(messageRetrieveResponse),
-                jacksonTypeRef<MessageRetrieveResponse>(),
-            )
-
-        assertThat(roundtrippedMessageRetrieveResponse).isEqualTo(messageRetrieveResponse)
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendParamsTest.kt
deleted file mode 100644
index ade1660..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendParamsTest.kt
+++ /dev/null
@@ -1,77 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.messages
-
-import com.blooio.api.core.JsonValue
-import com.blooio.api.core.http.Headers
-import kotlin.jvm.optionals.getOrNull
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class MessageSendParamsTest {
-
-    @Test
-    fun create() {
-        MessageSendParams.builder()
-            .idempotencyKey("Idempotency-Key")
-            .to("+15551234567")
-            .addAttachment("https://example.com/image.png")
-            .metadata(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-            .text("Hello world!")
-            .build()
-    }
-
-    @Test
-    fun headers() {
-        val params =
-            MessageSendParams.builder()
-                .idempotencyKey("Idempotency-Key")
-                .to("+15551234567")
-                .addAttachment("https://example.com/image.png")
-                .metadata(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-                .text("Hello world!")
-                .build()
-
-        val headers = params._headers()
-
-        assertThat(headers)
-            .isEqualTo(Headers.builder().put("Idempotency-Key", "Idempotency-Key").build())
-    }
-
-    @Test
-    fun headersWithoutOptionalFields() {
-        val params = MessageSendParams.builder().to("+15551234567").build()
-
-        val headers = params._headers()
-
-        assertThat(headers).isEqualTo(Headers.builder().build())
-    }
-
-    @Test
-    fun body() {
-        val params =
-            MessageSendParams.builder()
-                .idempotencyKey("Idempotency-Key")
-                .to("+15551234567")
-                .addAttachment("https://example.com/image.png")
-                .metadata(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-                .text("Hello world!")
-                .build()
-
-        val body = params._body()
-
-        assertThat(body.to()).isEqualTo("+15551234567")
-        assertThat(body.attachments().getOrNull()).containsExactly("https://example.com/image.png")
-        assertThat(body._metadata()).isEqualTo(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-        assertThat(body.text()).contains("Hello world!")
-    }
-
-    @Test
-    fun bodyWithoutOptionalFields() {
-        val params = MessageSendParams.builder().to("+15551234567").build()
-
-        val body = params._body()
-
-        assertThat(body.to()).isEqualTo("+15551234567")
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendResponseTest.kt
deleted file mode 100644
index 4b1ebc3..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/messages/MessageSendResponseTest.kt
+++ /dev/null
@@ -1,35 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.models.messages
-
-import com.blooio.api.core.jsonMapper
-import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
-import org.assertj.core.api.Assertions.assertThat
-import org.junit.jupiter.api.Test
-
-internal class MessageSendResponseTest {
-
-    @Test
-    fun create() {
-        val messageSendResponse =
-            MessageSendResponse.builder().messageId("Qm8FhbH3P7R").status("queued").build()
-
-        assertThat(messageSendResponse.messageId()).contains("Qm8FhbH3P7R")
-        assertThat(messageSendResponse.status()).contains("queued")
-    }
-
-    @Test
-    fun roundtrip() {
-        val jsonMapper = jsonMapper()
-        val messageSendResponse =
-            MessageSendResponse.builder().messageId("Qm8FhbH3P7R").status("queued").build()
-
-        val roundtrippedMessageSendResponse =
-            jsonMapper.readValue(
-                jsonMapper.writeValueAsString(messageSendResponse),
-                jacksonTypeRef<MessageSendResponse>(),
-            )
-
-        assertThat(roundtrippedMessageSendResponse).isEqualTo(messageSendResponse)
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParamsTest.kt
new file mode 100644
index 0000000..9dbc7ac
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParamsTest.kt
@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PhoneNumberBatchCreateParamsTest {
+
+    @Test
+    fun create() {
+        PhoneNumberBatchCreateParams.builder()
+            .numbers(listOf("+12125551234", "+14155551234", "+18582849901"))
+            .build()
+    }
+
+    @Test
+    fun body() {
+        val params =
+            PhoneNumberBatchCreateParams.builder()
+                .numbers(listOf("+12125551234", "+14155551234", "+18582849901"))
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.numbers()).containsExactly("+12125551234", "+14155551234", "+18582849901")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponseTest.kt
new file mode 100644
index 0000000..0c7ca75
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponseTest.kt
@@ -0,0 +1,111 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers
+
+import com.blooio.api.core.jsonMapper
+import com.blooio.api.models.phonenumbers.lookup.PhoneNumberLookupResult
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PhoneNumberBatchCreateResponseTest {
+
+    @Test
+    fun create() {
+        val phoneNumberBatchCreateResponse =
+            PhoneNumberBatchCreateResponse.builder()
+                .addResult(
+                    PhoneNumberLookupResult.builder()
+                        .areaCode("212")
+                        .areaCodeRegion("New York, NY")
+                        .country("US")
+                        .countryCallingCode("1")
+                        .e164("+12125551234")
+                        .exchange("555")
+                        .input("+12125551234")
+                        .international("+1 212 555 1234")
+                        .location(
+                            PhoneNumberLookupResult.Location.builder()
+                                .city("New York")
+                                .region("NY")
+                                .regionName("New York")
+                                .build()
+                        )
+                        .national("(212) 555-1234")
+                        .nationalNumber("2125551234")
+                        .possible(true)
+                        .type(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+                        .valid(true)
+                        .build()
+                )
+                .build()
+
+        assertThat(phoneNumberBatchCreateResponse.results().getOrNull())
+            .containsExactly(
+                PhoneNumberLookupResult.builder()
+                    .areaCode("212")
+                    .areaCodeRegion("New York, NY")
+                    .country("US")
+                    .countryCallingCode("1")
+                    .e164("+12125551234")
+                    .exchange("555")
+                    .input("+12125551234")
+                    .international("+1 212 555 1234")
+                    .location(
+                        PhoneNumberLookupResult.Location.builder()
+                            .city("New York")
+                            .region("NY")
+                            .regionName("New York")
+                            .build()
+                    )
+                    .national("(212) 555-1234")
+                    .nationalNumber("2125551234")
+                    .possible(true)
+                    .type(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+                    .valid(true)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val phoneNumberBatchCreateResponse =
+            PhoneNumberBatchCreateResponse.builder()
+                .addResult(
+                    PhoneNumberLookupResult.builder()
+                        .areaCode("212")
+                        .areaCodeRegion("New York, NY")
+                        .country("US")
+                        .countryCallingCode("1")
+                        .e164("+12125551234")
+                        .exchange("555")
+                        .input("+12125551234")
+                        .international("+1 212 555 1234")
+                        .location(
+                            PhoneNumberLookupResult.Location.builder()
+                                .city("New York")
+                                .region("NY")
+                                .regionName("New York")
+                                .build()
+                        )
+                        .national("(212) 555-1234")
+                        .nationalNumber("2125551234")
+                        .possible(true)
+                        .type(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+                        .valid(true)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedPhoneNumberBatchCreateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(phoneNumberBatchCreateResponse),
+                jacksonTypeRef<PhoneNumberBatchCreateResponse>(),
+            )
+
+        assertThat(roundtrippedPhoneNumberBatchCreateResponse)
+            .isEqualTo(phoneNumberBatchCreateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParamsTest.kt
new file mode 100644
index 0000000..0d918f9
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LookupCreateParamsTest {
+
+    @Test
+    fun create() {
+        LookupCreateParams.builder().number("+12125551234").build()
+    }
+
+    @Test
+    fun body() {
+        val params = LookupCreateParams.builder().number("+12125551234").build()
+
+        val body = params._body()
+
+        assertThat(body.number()).isEqualTo("+12125551234")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParamsTest.kt
new file mode 100644
index 0000000..f3fb266
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupRetrieveParamsTest.kt
@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LookupRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        LookupRetrieveParams.builder().number("+12125551234").build()
+    }
+
+    @Test
+    fun queryParams() {
+        val params = LookupRetrieveParams.builder().number("+12125551234").build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(QueryParams.builder().put("number", "+12125551234").build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResultTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResultTest.kt
new file mode 100644
index 0000000..0979134
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResultTest.kt
@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.phonenumbers.lookup
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class PhoneNumberLookupResultTest {
+
+    @Test
+    fun create() {
+        val phoneNumberLookupResult =
+            PhoneNumberLookupResult.builder()
+                .areaCode("212")
+                .areaCodeRegion("New York, NY")
+                .country("US")
+                .countryCallingCode("1")
+                .e164("+12125551234")
+                .exchange("555")
+                .input("+12125551234")
+                .international("+1 212 555 1234")
+                .location(
+                    PhoneNumberLookupResult.Location.builder()
+                        .city("New York")
+                        .region("NY")
+                        .regionName("New York")
+                        .build()
+                )
+                .national("(212) 555-1234")
+                .nationalNumber("2125551234")
+                .possible(true)
+                .type(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+                .valid(true)
+                .build()
+
+        assertThat(phoneNumberLookupResult.areaCode()).contains("212")
+        assertThat(phoneNumberLookupResult.areaCodeRegion()).contains("New York, NY")
+        assertThat(phoneNumberLookupResult.country()).contains("US")
+        assertThat(phoneNumberLookupResult.countryCallingCode()).contains("1")
+        assertThat(phoneNumberLookupResult.e164()).contains("+12125551234")
+        assertThat(phoneNumberLookupResult.exchange()).contains("555")
+        assertThat(phoneNumberLookupResult.input()).contains("+12125551234")
+        assertThat(phoneNumberLookupResult.international()).contains("+1 212 555 1234")
+        assertThat(phoneNumberLookupResult.location())
+            .contains(
+                PhoneNumberLookupResult.Location.builder()
+                    .city("New York")
+                    .region("NY")
+                    .regionName("New York")
+                    .build()
+            )
+        assertThat(phoneNumberLookupResult.national()).contains("(212) 555-1234")
+        assertThat(phoneNumberLookupResult.nationalNumber()).contains("2125551234")
+        assertThat(phoneNumberLookupResult.possible()).contains(true)
+        assertThat(phoneNumberLookupResult.type())
+            .contains(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+        assertThat(phoneNumberLookupResult.valid()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val phoneNumberLookupResult =
+            PhoneNumberLookupResult.builder()
+                .areaCode("212")
+                .areaCodeRegion("New York, NY")
+                .country("US")
+                .countryCallingCode("1")
+                .e164("+12125551234")
+                .exchange("555")
+                .input("+12125551234")
+                .international("+1 212 555 1234")
+                .location(
+                    PhoneNumberLookupResult.Location.builder()
+                        .city("New York")
+                        .region("NY")
+                        .regionName("New York")
+                        .build()
+                )
+                .national("(212) 555-1234")
+                .nationalNumber("2125551234")
+                .possible(true)
+                .type(PhoneNumberLookupResult.Type.FIXED_LINE_OR_MOBILE)
+                .valid(true)
+                .build()
+
+        val roundtrippedPhoneNumberLookupResult =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(phoneNumberLookupResult),
+                jacksonTypeRef<PhoneNumberLookupResult>(),
+            )
+
+        assertThat(roundtrippedPhoneNumberLookupResult).isEqualTo(phoneNumberLookupResult)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateParamsTest.kt
new file mode 100644
index 0000000..3770964
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateParamsTest.kt
@@ -0,0 +1,43 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookCreateParamsTest {
+
+    @Test
+    fun create() {
+        WebhookCreateParams.builder()
+            .webhookUrl("https://example.com/webhook")
+            .validUntil(0L)
+            .webhookType(WebhookCreateParams.WebhookType.MESSAGE)
+            .build()
+    }
+
+    @Test
+    fun body() {
+        val params =
+            WebhookCreateParams.builder()
+                .webhookUrl("https://example.com/webhook")
+                .validUntil(0L)
+                .webhookType(WebhookCreateParams.WebhookType.MESSAGE)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.webhookUrl()).isEqualTo("https://example.com/webhook")
+        assertThat(body.validUntil()).contains(0L)
+        assertThat(body.webhookType()).contains(WebhookCreateParams.WebhookType.MESSAGE)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = WebhookCreateParams.builder().webhookUrl("https://example.com/webhook").build()
+
+        val body = params._body()
+
+        assertThat(body.webhookUrl()).isEqualTo("https://example.com/webhook")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponseTest.kt
new file mode 100644
index 0000000..20cfd30
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponseTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookCreateResponseTest {
+
+    @Test
+    fun create() {
+        val webhookCreateResponse =
+            WebhookCreateResponse.builder()
+                .message("message")
+                .scope(WebhookCreateResponse.Scope.API_KEY)
+                .webhookId("webhook_id")
+                .webhookUrl("webhook_url")
+                .build()
+
+        assertThat(webhookCreateResponse.message()).contains("message")
+        assertThat(webhookCreateResponse.scope()).contains(WebhookCreateResponse.Scope.API_KEY)
+        assertThat(webhookCreateResponse.webhookId()).contains("webhook_id")
+        assertThat(webhookCreateResponse.webhookUrl()).contains("webhook_url")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val webhookCreateResponse =
+            WebhookCreateResponse.builder()
+                .message("message")
+                .scope(WebhookCreateResponse.Scope.API_KEY)
+                .webhookId("webhook_id")
+                .webhookUrl("webhook_url")
+                .build()
+
+        val roundtrippedWebhookCreateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(webhookCreateResponse),
+                jacksonTypeRef<WebhookCreateResponse>(),
+            )
+
+        assertThat(roundtrippedWebhookCreateResponse).isEqualTo(webhookCreateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParamsTest.kt
new file mode 100644
index 0000000..437ecf5
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookDeleteParamsTest {
+
+    @Test
+    fun create() {
+        WebhookDeleteParams.builder().webhookId("wh_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = WebhookDeleteParams.builder().webhookId("wh_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponseTest.kt
new file mode 100644
index 0000000..b591995
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponseTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookDeleteResponseTest {
+
+    @Test
+    fun create() {
+        val webhookDeleteResponse =
+            WebhookDeleteResponse.builder().message("Webhook deleted").success(true).build()
+
+        assertThat(webhookDeleteResponse.message()).contains("Webhook deleted")
+        assertThat(webhookDeleteResponse.success()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val webhookDeleteResponse =
+            WebhookDeleteResponse.builder().message("Webhook deleted").success(true).build()
+
+        val roundtrippedWebhookDeleteResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(webhookDeleteResponse),
+                jacksonTypeRef<WebhookDeleteResponse>(),
+            )
+
+        assertThat(roundtrippedWebhookDeleteResponse).isEqualTo(webhookDeleteResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListParamsTest.kt
new file mode 100644
index 0000000..7192d2e
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListParamsTest.kt
@@ -0,0 +1,13 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import org.junit.jupiter.api.Test
+
+internal class WebhookListParamsTest {
+
+    @Test
+    fun create() {
+        WebhookListParams.builder().build()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListResponseTest.kt
new file mode 100644
index 0000000..d6f0167
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookListResponseTest.kt
@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookListResponseTest {
+
+    @Test
+    fun create() {
+        val webhookListResponse =
+            WebhookListResponse.builder()
+                .addWebhook(
+                    Webhook.builder()
+                        .apiKeyName("api_key_name")
+                        .createdAt(0L)
+                        .deprecatedAt(0L)
+                        .failureCount(0L)
+                        .integrationName("integration_name")
+                        .isActive(true)
+                        .lastTriggered(0L)
+                        .scope(Webhook.Scope.API_KEY)
+                        .validUntil(0L)
+                        .webhookId("webhook_id")
+                        .webhookType(Webhook.WebhookType.MESSAGE)
+                        .webhookUrl("https://example.com")
+                        .build()
+                )
+                .build()
+
+        assertThat(webhookListResponse.webhooks().getOrNull())
+            .containsExactly(
+                Webhook.builder()
+                    .apiKeyName("api_key_name")
+                    .createdAt(0L)
+                    .deprecatedAt(0L)
+                    .failureCount(0L)
+                    .integrationName("integration_name")
+                    .isActive(true)
+                    .lastTriggered(0L)
+                    .scope(Webhook.Scope.API_KEY)
+                    .validUntil(0L)
+                    .webhookId("webhook_id")
+                    .webhookType(Webhook.WebhookType.MESSAGE)
+                    .webhookUrl("https://example.com")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val webhookListResponse =
+            WebhookListResponse.builder()
+                .addWebhook(
+                    Webhook.builder()
+                        .apiKeyName("api_key_name")
+                        .createdAt(0L)
+                        .deprecatedAt(0L)
+                        .failureCount(0L)
+                        .integrationName("integration_name")
+                        .isActive(true)
+                        .lastTriggered(0L)
+                        .scope(Webhook.Scope.API_KEY)
+                        .validUntil(0L)
+                        .webhookId("webhook_id")
+                        .webhookType(Webhook.WebhookType.MESSAGE)
+                        .webhookUrl("https://example.com")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedWebhookListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(webhookListResponse),
+                jacksonTypeRef<WebhookListResponse>(),
+            )
+
+        assertThat(roundtrippedWebhookListResponse).isEqualTo(webhookListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParamsTest.kt
new file mode 100644
index 0000000..b1b2a77
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookRetrieveParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        WebhookRetrieveParams.builder().webhookId("wh_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = WebhookRetrieveParams.builder().webhookId("wh_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookTest.kt
new file mode 100644
index 0000000..b3b8c9a
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookTest.kt
@@ -0,0 +1,68 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookTest {
+
+    @Test
+    fun create() {
+        val webhook =
+            Webhook.builder()
+                .apiKeyName("api_key_name")
+                .createdAt(0L)
+                .deprecatedAt(0L)
+                .failureCount(0L)
+                .integrationName("integration_name")
+                .isActive(true)
+                .lastTriggered(0L)
+                .scope(Webhook.Scope.API_KEY)
+                .validUntil(0L)
+                .webhookId("webhook_id")
+                .webhookType(Webhook.WebhookType.MESSAGE)
+                .webhookUrl("https://example.com")
+                .build()
+
+        assertThat(webhook.apiKeyName()).contains("api_key_name")
+        assertThat(webhook.createdAt()).contains(0L)
+        assertThat(webhook.deprecatedAt()).contains(0L)
+        assertThat(webhook.failureCount()).contains(0L)
+        assertThat(webhook.integrationName()).contains("integration_name")
+        assertThat(webhook.isActive()).contains(true)
+        assertThat(webhook.lastTriggered()).contains(0L)
+        assertThat(webhook.scope()).contains(Webhook.Scope.API_KEY)
+        assertThat(webhook.validUntil()).contains(0L)
+        assertThat(webhook.webhookId()).contains("webhook_id")
+        assertThat(webhook.webhookType()).contains(Webhook.WebhookType.MESSAGE)
+        assertThat(webhook.webhookUrl()).contains("https://example.com")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val webhook =
+            Webhook.builder()
+                .apiKeyName("api_key_name")
+                .createdAt(0L)
+                .deprecatedAt(0L)
+                .failureCount(0L)
+                .integrationName("integration_name")
+                .isActive(true)
+                .lastTriggered(0L)
+                .scope(Webhook.Scope.API_KEY)
+                .validUntil(0L)
+                .webhookId("webhook_id")
+                .webhookType(Webhook.WebhookType.MESSAGE)
+                .webhookUrl("https://example.com")
+                .build()
+
+        val roundtrippedWebhook =
+            jsonMapper.readValue(jsonMapper.writeValueAsString(webhook), jacksonTypeRef<Webhook>())
+
+        assertThat(roundtrippedWebhook).isEqualTo(webhook)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParamsTest.kt
new file mode 100644
index 0000000..60f870e
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParamsTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class WebhookUpdateParamsTest {
+
+    @Test
+    fun create() {
+        WebhookUpdateParams.builder()
+            .webhookId("wh_abc123def456")
+            .deprecate(true)
+            .validUntil(0L)
+            .webhookType(WebhookUpdateParams.WebhookType.MESSAGE)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = WebhookUpdateParams.builder().webhookId("wh_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun body() {
+        val params =
+            WebhookUpdateParams.builder()
+                .webhookId("wh_abc123def456")
+                .deprecate(true)
+                .validUntil(0L)
+                .webhookType(WebhookUpdateParams.WebhookType.MESSAGE)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.deprecate()).contains(true)
+        assertThat(body.validUntil()).contains(0L)
+        assertThat(body.webhookType()).contains(WebhookUpdateParams.WebhookType.MESSAGE)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = WebhookUpdateParams.builder().webhookId("wh_abc123def456").build()
+
+        val body = params._body()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListParamsTest.kt
new file mode 100644
index 0000000..9c1659b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListParamsTest.kt
@@ -0,0 +1,69 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LogListParamsTest {
+
+    @Test
+    fun create() {
+        LogListParams.builder()
+            .webhookId("wh_abc123def456")
+            .limit(1L)
+            .maxStatus(0L)
+            .minStatus(0L)
+            .offset(0L)
+            .sort(LogListParams.Sort.ASC)
+            .status(0L)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = LogListParams.builder().webhookId("wh_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            LogListParams.builder()
+                .webhookId("wh_abc123def456")
+                .limit(1L)
+                .maxStatus(0L)
+                .minStatus(0L)
+                .offset(0L)
+                .sort(LogListParams.Sort.ASC)
+                .status(0L)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("limit", "1")
+                    .put("max_status", "0")
+                    .put("min_status", "0")
+                    .put("offset", "0")
+                    .put("sort", "asc")
+                    .put("status", "0")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = LogListParams.builder().webhookId("wh_abc123def456").build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
new file mode 100644
index 0000000..9fb98dc
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
@@ -0,0 +1,231 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LogListResponseTest {
+
+    @Test
+    fun create() {
+        val logListResponse =
+            LogListResponse.builder()
+                .addLog(
+                    LogListResponse.Log.builder()
+                        .attemptedTime(0L)
+                        .eventBody(
+                            LogListResponse.Log.EventBody.builder()
+                                .addAttachment(
+                                    LogListResponse.Log.EventBody.Attachment.builder()
+                                        .name("name")
+                                        .url("url")
+                                        .build()
+                                )
+                                .deliveredAt(0L)
+                                .errorCode("error_code")
+                                .errorMessage("error_message")
+                                .event("message.sent")
+                                .externalId("external_id")
+                                .groupId("group_id")
+                                .groupName("group_name")
+                                .internalId("internal_id")
+                                .isGroup(true)
+                                .messageId("message_id")
+                                .addParticipant(
+                                    LogListResponse.Log.EventBody.Participant.builder()
+                                        .contactId("contact_id")
+                                        .identifier("identifier")
+                                        .name("name")
+                                        .build()
+                                )
+                                .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                                .readAt(0L)
+                                .sender("sender")
+                                .sentAt(0L)
+                                .status(LogListResponse.Log.EventBody.Status.QUEUED)
+                                .text("text")
+                                .timestamp(0L)
+                                .build()
+                        )
+                        .eventId("event_id")
+                        .metadata(
+                            LogListResponse.Log.Metadata.builder()
+                                .durationMs(0L)
+                                .eventName("event_name")
+                                .isReplay(true)
+                                .messageId("message_id")
+                                .organizationId("organization_id")
+                                .originalEventId("original_event_id")
+                                .build()
+                        )
+                        .responseJson(JsonValue.from(mapOf<String, Any>()))
+                        .responseReceivedAt(0L)
+                        .responseStatus(0L)
+                        .scope(LogListResponse.Log.Scope.API)
+                        .webhookUrl("webhook_url")
+                        .build()
+                )
+                .pagination(
+                    LogListResponse.Pagination.builder()
+                        .hasMore(true)
+                        .limit(0L)
+                        .offset(0L)
+                        .returned(0L)
+                        .total(0L)
+                        .build()
+                )
+                .build()
+
+        assertThat(logListResponse.logs().getOrNull())
+            .containsExactly(
+                LogListResponse.Log.builder()
+                    .attemptedTime(0L)
+                    .eventBody(
+                        LogListResponse.Log.EventBody.builder()
+                            .addAttachment(
+                                LogListResponse.Log.EventBody.Attachment.builder()
+                                    .name("name")
+                                    .url("url")
+                                    .build()
+                            )
+                            .deliveredAt(0L)
+                            .errorCode("error_code")
+                            .errorMessage("error_message")
+                            .event("message.sent")
+                            .externalId("external_id")
+                            .groupId("group_id")
+                            .groupName("group_name")
+                            .internalId("internal_id")
+                            .isGroup(true)
+                            .messageId("message_id")
+                            .addParticipant(
+                                LogListResponse.Log.EventBody.Participant.builder()
+                                    .contactId("contact_id")
+                                    .identifier("identifier")
+                                    .name("name")
+                                    .build()
+                            )
+                            .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                            .readAt(0L)
+                            .sender("sender")
+                            .sentAt(0L)
+                            .status(LogListResponse.Log.EventBody.Status.QUEUED)
+                            .text("text")
+                            .timestamp(0L)
+                            .build()
+                    )
+                    .eventId("event_id")
+                    .metadata(
+                        LogListResponse.Log.Metadata.builder()
+                            .durationMs(0L)
+                            .eventName("event_name")
+                            .isReplay(true)
+                            .messageId("message_id")
+                            .organizationId("organization_id")
+                            .originalEventId("original_event_id")
+                            .build()
+                    )
+                    .responseJson(JsonValue.from(mapOf<String, Any>()))
+                    .responseReceivedAt(0L)
+                    .responseStatus(0L)
+                    .scope(LogListResponse.Log.Scope.API)
+                    .webhookUrl("webhook_url")
+                    .build()
+            )
+        assertThat(logListResponse.pagination())
+            .contains(
+                LogListResponse.Pagination.builder()
+                    .hasMore(true)
+                    .limit(0L)
+                    .offset(0L)
+                    .returned(0L)
+                    .total(0L)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val logListResponse =
+            LogListResponse.builder()
+                .addLog(
+                    LogListResponse.Log.builder()
+                        .attemptedTime(0L)
+                        .eventBody(
+                            LogListResponse.Log.EventBody.builder()
+                                .addAttachment(
+                                    LogListResponse.Log.EventBody.Attachment.builder()
+                                        .name("name")
+                                        .url("url")
+                                        .build()
+                                )
+                                .deliveredAt(0L)
+                                .errorCode("error_code")
+                                .errorMessage("error_message")
+                                .event("message.sent")
+                                .externalId("external_id")
+                                .groupId("group_id")
+                                .groupName("group_name")
+                                .internalId("internal_id")
+                                .isGroup(true)
+                                .messageId("message_id")
+                                .addParticipant(
+                                    LogListResponse.Log.EventBody.Participant.builder()
+                                        .contactId("contact_id")
+                                        .identifier("identifier")
+                                        .name("name")
+                                        .build()
+                                )
+                                .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                                .readAt(0L)
+                                .sender("sender")
+                                .sentAt(0L)
+                                .status(LogListResponse.Log.EventBody.Status.QUEUED)
+                                .text("text")
+                                .timestamp(0L)
+                                .build()
+                        )
+                        .eventId("event_id")
+                        .metadata(
+                            LogListResponse.Log.Metadata.builder()
+                                .durationMs(0L)
+                                .eventName("event_name")
+                                .isReplay(true)
+                                .messageId("message_id")
+                                .organizationId("organization_id")
+                                .originalEventId("original_event_id")
+                                .build()
+                        )
+                        .responseJson(JsonValue.from(mapOf<String, Any>()))
+                        .responseReceivedAt(0L)
+                        .responseStatus(0L)
+                        .scope(LogListResponse.Log.Scope.API)
+                        .webhookUrl("webhook_url")
+                        .build()
+                )
+                .pagination(
+                    LogListResponse.Pagination.builder()
+                        .hasMore(true)
+                        .limit(0L)
+                        .offset(0L)
+                        .returned(0L)
+                        .total(0L)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedLogListResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(logListResponse),
+                jacksonTypeRef<LogListResponse>(),
+            )
+
+        assertThat(roundtrippedLogListResponse).isEqualTo(logListResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParamsTest.kt
new file mode 100644
index 0000000..b3f4260
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayParamsTest.kt
@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LogReplayParamsTest {
+
+    @Test
+    fun create() {
+        LogReplayParams.builder().webhookId("wh_abc123def456").eventId("eventId").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            LogReplayParams.builder().webhookId("wh_abc123def456").eventId("eventId").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        assertThat(params._pathParam(1)).isEqualTo("eventId")
+        // out-of-bound path param
+        assertThat(params._pathParam(2)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponseTest.kt
new file mode 100644
index 0000000..4d36cd1
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponseTest.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.logs
+
+import com.blooio.api.core.JsonValue
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class LogReplayResponseTest {
+
+    @Test
+    fun create() {
+        val logReplayResponse =
+            LogReplayResponse.builder()
+                .durationMs(0L)
+                .originalEventId("original_event_id")
+                .replayEventId("replay_event_id")
+                .responseData(
+                    LogReplayResponse.ResponseData.builder()
+                        .body(JsonValue.from(mapOf<String, Any>()))
+                        .contentType("contentType")
+                        .duration(0L)
+                        .error("error")
+                        .errorType("errorType")
+                        .headers(JsonValue.from(mapOf<String, Any>()))
+                        .size(0L)
+                        .build()
+                )
+                .responseStatus(0L)
+                .success(true)
+                .webhookId("webhook_id")
+                .webhookUrl("webhook_url")
+                .build()
+
+        assertThat(logReplayResponse.durationMs()).contains(0L)
+        assertThat(logReplayResponse.originalEventId()).contains("original_event_id")
+        assertThat(logReplayResponse.replayEventId()).contains("replay_event_id")
+        assertThat(logReplayResponse.responseData())
+            .contains(
+                LogReplayResponse.ResponseData.builder()
+                    .body(JsonValue.from(mapOf<String, Any>()))
+                    .contentType("contentType")
+                    .duration(0L)
+                    .error("error")
+                    .errorType("errorType")
+                    .headers(JsonValue.from(mapOf<String, Any>()))
+                    .size(0L)
+                    .build()
+            )
+        assertThat(logReplayResponse.responseStatus()).contains(0L)
+        assertThat(logReplayResponse.success()).contains(true)
+        assertThat(logReplayResponse.webhookId()).contains("webhook_id")
+        assertThat(logReplayResponse.webhookUrl()).contains("webhook_url")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val logReplayResponse =
+            LogReplayResponse.builder()
+                .durationMs(0L)
+                .originalEventId("original_event_id")
+                .replayEventId("replay_event_id")
+                .responseData(
+                    LogReplayResponse.ResponseData.builder()
+                        .body(JsonValue.from(mapOf<String, Any>()))
+                        .contentType("contentType")
+                        .duration(0L)
+                        .error("error")
+                        .errorType("errorType")
+                        .headers(JsonValue.from(mapOf<String, Any>()))
+                        .size(0L)
+                        .build()
+                )
+                .responseStatus(0L)
+                .success(true)
+                .webhookId("webhook_id")
+                .webhookUrl("webhook_url")
+                .build()
+
+        val roundtrippedLogReplayResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(logReplayResponse),
+                jacksonTypeRef<LogReplayResponse>(),
+            )
+
+        assertThat(roundtrippedLogReplayResponse).isEqualTo(logReplayResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParamsTest.kt
new file mode 100644
index 0000000..11807c0
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateParamsTest.kt
@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.secret
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class SecretRotateParamsTest {
+
+    @Test
+    fun create() {
+        SecretRotateParams.builder().webhookId("wh_abc123def456").build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = SecretRotateParams.builder().webhookId("wh_abc123def456").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("wh_abc123def456")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponseTest.kt
new file mode 100644
index 0000000..ff75213
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponseTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.models.webhooks.secret
+
+import com.blooio.api.core.jsonMapper
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class SecretRotateResponseTest {
+
+    @Test
+    fun create() {
+        val secretRotateResponse =
+            SecretRotateResponse.builder()
+                .rotatedAt(0L)
+                .rotatedBy("rotated_by")
+                .rotationCount(0L)
+                .signingSecret("signing_secret")
+                .webhookId("webhook_id")
+                .build()
+
+        assertThat(secretRotateResponse.rotatedAt()).contains(0L)
+        assertThat(secretRotateResponse.rotatedBy()).contains("rotated_by")
+        assertThat(secretRotateResponse.rotationCount()).contains(0L)
+        assertThat(secretRotateResponse.signingSecret()).contains("signing_secret")
+        assertThat(secretRotateResponse.webhookId()).contains("webhook_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val secretRotateResponse =
+            SecretRotateResponse.builder()
+                .rotatedAt(0L)
+                .rotatedBy("rotated_by")
+                .rotationCount(0L)
+                .signingSecret("signing_secret")
+                .webhookId("webhook_id")
+                .build()
+
+        val roundtrippedSecretRotateResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(secretRotateResponse),
+                jacksonTypeRef<SecretRotateResponse>(),
+            )
+
+        assertThat(roundtrippedSecretRotateResponse).isEqualTo(secretRotateResponse)
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
deleted file mode 100644
index 4c2ef1e..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/BatchServiceAsyncTest.kt
+++ /dev/null
@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
-import org.junit.jupiter.api.Disabled
-import org.junit.jupiter.api.Test
-
-internal class BatchServiceAsyncTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun create() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val batchServiceAsync = client.batches()
-
-        val future = batchServiceAsync.create()
-
-        val response = future.get()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieve() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val batchServiceAsync = client.batches()
-
-        val future = batchServiceAsync.retrieve("batchId")
-
-        val response = future.get()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun listMessages() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val batchServiceAsync = client.batches()
-
-        val future = batchServiceAsync.listMessages("batchId")
-
-        val response = future.get()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieveStatus() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val batchServiceAsync = client.batches()
-
-        val future = batchServiceAsync.retrieveStatus("batchId")
-
-        val response = future.get()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ChatServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ChatServiceAsyncTest.kt
new file mode 100644
index 0000000..0018f06
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ChatServiceAsyncTest.kt
@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.chats.ChatListParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class ChatServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val chatServiceAsync = client.chats()
+
+        val chatFuture = chatServiceAsync.retrieve("chatId")
+
+        val chat = chatFuture.get()
+        chat.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val chatServiceAsync = client.chats()
+
+        val chatsFuture =
+            chatServiceAsync.list(
+                ChatListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(ChatListParams.Sort.RECENT)
+                    .build()
+            )
+
+        val chats = chatsFuture.get()
+        chats.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun markAsRead() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val chatServiceAsync = client.chats()
+
+        val responseFuture = chatServiceAsync.markAsRead("chatId")
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun shareContactCard() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val chatServiceAsync = client.chats()
+
+        val responseFuture = chatServiceAsync.shareContactCard("chatId")
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
index 514c6b7..a4203d7 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/ContactServiceAsyncTest.kt
@@ -3,18 +3,95 @@
 package com.blooio.api.services.async
 
 import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactUpdateParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
 
 internal class ContactServiceAsyncTest {
 
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.contacts()
+
+        val contactFuture =
+            contactServiceAsync.create(
+                ContactCreateParams.builder().identifier("+15551234567").name("John Doe").build()
+            )
+
+        val contact = contactFuture.get()
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.contacts()
+
+        val contactFuture = contactServiceAsync.retrieve("%2B15551234567")
+
+        val contact = contactFuture.get()
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.contacts()
+
+        val contactFuture =
+            contactServiceAsync.update(
+                ContactUpdateParams.builder().contactId("%2B15551234567").name("Jane Doe").build()
+            )
+
+        val contact = contactFuture.get()
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.contacts()
+
+        val contactsFuture =
+            contactServiceAsync.list(
+                ContactListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(ContactListParams.Sort.RECENT)
+                    .build()
+            )
+
+        val contacts = contactsFuture.get()
+        contacts.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.contacts()
+
+        val deleteResponseFuture = contactServiceAsync.delete("%2B15551234567")
+
+        val deleteResponse = deleteResponseFuture.get()
+        deleteResponse.validate()
+    }
+
     @Disabled("Mock server tests are disabled")
     @Test
     fun checkCapabilities() {
         val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
         val contactServiceAsync = client.contacts()
 
-        val responseFuture = contactServiceAsync.checkCapabilities("contact")
+        val responseFuture = contactServiceAsync.checkCapabilities("%2B15551234567")
 
         val response = responseFuture.get()
         response.validate()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncTest.kt
new file mode 100644
index 0000000..32843f4
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/FacetimeServiceAsyncTest.kt
@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class FacetimeServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun initiateCall() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val facetimeServiceAsync = client.facetime()
+
+        val responseFuture =
+            facetimeServiceAsync.initiateCall(
+                FacetimeInitiateCallParams.builder().handle("+15551234567").build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/GroupServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/GroupServiceAsyncTest.kt
new file mode 100644
index 0000000..7d8b389
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/GroupServiceAsyncTest.kt
@@ -0,0 +1,95 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class GroupServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val groupServiceAsync = client.groups()
+
+        val groupFuture =
+            groupServiceAsync.create(
+                GroupCreateParams.builder()
+                    .name("Sales Team")
+                    .chatGuid("iMessage;+;chat123456789")
+                    .addMember("+15551234567")
+                    .addMember("+15559876543")
+                    .build()
+            )
+
+        val group = groupFuture.get()
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val groupServiceAsync = client.groups()
+
+        val groupFuture = groupServiceAsync.retrieve("grp_abc123def456")
+
+        val group = groupFuture.get()
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val groupServiceAsync = client.groups()
+
+        val groupFuture =
+            groupServiceAsync.update(
+                GroupUpdateParams.builder()
+                    .groupId("grp_abc123def456")
+                    .name("Marketing Team")
+                    .build()
+            )
+
+        val group = groupFuture.get()
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val groupServiceAsync = client.groups()
+
+        val groupsFuture =
+            groupServiceAsync.list(
+                GroupListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(GroupListParams.Sort.RECENT)
+                    .build()
+            )
+
+        val groups = groupsFuture.get()
+        groups.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val groupServiceAsync = client.groups()
+
+        val groupFuture = groupServiceAsync.delete("grp_abc123def456")
+
+        val group = groupFuture.get()
+        group.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
deleted file mode 100644
index a738bdc..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/MessageServiceAsyncTest.kt
+++ /dev/null
@@ -1,69 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async
-
-import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
-import com.blooio.api.core.JsonValue
-import com.blooio.api.models.messages.MessageSendParams
-import org.junit.jupiter.api.Disabled
-import org.junit.jupiter.api.Test
-
-internal class MessageServiceAsyncTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieve() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val messageServiceAsync = client.messages()
-
-        val messageFuture = messageServiceAsync.retrieve("messageId")
-
-        val message = messageFuture.get()
-        message.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun cancel() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val messageServiceAsync = client.messages()
-
-        val responseFuture = messageServiceAsync.cancel("messageId")
-
-        val response = responseFuture.get()
-        response.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun getStatus() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val messageServiceAsync = client.messages()
-
-        val responseFuture = messageServiceAsync.getStatus("messageId")
-
-        val response = responseFuture.get()
-        response.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun send() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val messageServiceAsync = client.messages()
-
-        val responseFuture =
-            messageServiceAsync.send(
-                MessageSendParams.builder()
-                    .idempotencyKey("Idempotency-Key")
-                    .to("+15551234567")
-                    .addAttachment("https://example.com/image.png")
-                    .metadata(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-                    .text("Hello world!")
-                    .build()
-            )
-
-        val response = responseFuture.get()
-        response.validate()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncTest.kt
new file mode 100644
index 0000000..c7712d3
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/PhoneNumberServiceAsyncTest.kt
@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class PhoneNumberServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun batchCreate() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val phoneNumberServiceAsync = client.phoneNumbers()
+
+        val responseFuture =
+            phoneNumberServiceAsync.batchCreate(
+                PhoneNumberBatchCreateParams.builder()
+                    .numbers(listOf("+12125551234", "+14155551234", "+18582849901"))
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/WebhookServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/WebhookServiceAsyncTest.kt
new file mode 100644
index 0000000..f05481b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/WebhookServiceAsyncTest.kt
@@ -0,0 +1,87 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class WebhookServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val webhookServiceAsync = client.webhooks()
+
+        val webhookFuture =
+            webhookServiceAsync.create(
+                WebhookCreateParams.builder()
+                    .webhookUrl("https://example.com/webhook")
+                    .validUntil(0L)
+                    .webhookType(WebhookCreateParams.WebhookType.MESSAGE)
+                    .build()
+            )
+
+        val webhook = webhookFuture.get()
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val webhookServiceAsync = client.webhooks()
+
+        val webhookFuture = webhookServiceAsync.retrieve("wh_abc123def456")
+
+        val webhook = webhookFuture.get()
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val webhookServiceAsync = client.webhooks()
+
+        val webhookFuture =
+            webhookServiceAsync.update(
+                WebhookUpdateParams.builder()
+                    .webhookId("wh_abc123def456")
+                    .deprecate(true)
+                    .validUntil(0L)
+                    .webhookType(WebhookUpdateParams.WebhookType.MESSAGE)
+                    .build()
+            )
+
+        val webhook = webhookFuture.get()
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val webhookServiceAsync = client.webhooks()
+
+        val webhooksFuture = webhookServiceAsync.list()
+
+        val webhooks = webhooksFuture.get()
+        webhooks.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val webhookServiceAsync = client.webhooks()
+
+        val webhookFuture = webhookServiceAsync.delete("wh_abc123def456")
+
+        val webhook = webhookFuture.get()
+        webhook.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncTest.kt
new file mode 100644
index 0000000..02cc62d
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncTest.kt
@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class BackgroundServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val backgroundServiceAsync = client.chats().background()
+
+        val chatBackgroundResponseFuture = backgroundServiceAsync.retrieve("chatId")
+
+        val chatBackgroundResponse = chatBackgroundResponseFuture.get()
+        chatBackgroundResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val backgroundServiceAsync = client.chats().background()
+
+        val chatBackgroundResponseFuture = backgroundServiceAsync.remove("chatId")
+
+        val chatBackgroundResponse = chatBackgroundResponseFuture.get()
+        chatBackgroundResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun set() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val backgroundServiceAsync = client.chats().background()
+
+        val chatBackgroundResponseFuture =
+            backgroundServiceAsync.set(
+                BackgroundSetParams.builder()
+                    .chatId("chatId")
+                    .background("Example data".byteInputStream())
+                    .build()
+            )
+
+        val chatBackgroundResponse = chatBackgroundResponseFuture.get()
+        chatBackgroundResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
new file mode 100644
index 0000000..0ba1dec
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
@@ -0,0 +1,135 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.chats.messages.LinkPreview
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageSendParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class MessageServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val messageServiceAsync = client.chats().messages()
+
+        val messageFuture =
+            messageServiceAsync.retrieve(
+                MessageRetrieveParams.builder()
+                    .chatId("chatId")
+                    .messageId("msg_abc123def456")
+                    .build()
+            )
+
+        val message = messageFuture.get()
+        message.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val messageServiceAsync = client.chats().messages()
+
+        val messagesFuture =
+            messageServiceAsync.list(
+                MessageListParams.builder()
+                    .chatId("chatId")
+                    .direction(MessageListParams.Direction.INBOUND)
+                    .limit(1L)
+                    .offset(0L)
+                    .since(0L)
+                    .sort(MessageListParams.Sort.ASC)
+                    .until(0L)
+                    .build()
+            )
+
+        val messages = messagesFuture.get()
+        messages.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun getStatus() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val messageServiceAsync = client.chats().messages()
+
+        val responseFuture =
+            messageServiceAsync.getStatus(
+                MessageGetStatusParams.builder()
+                    .chatId("chatId")
+                    .messageId("msg_abc123def456")
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun react() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val messageServiceAsync = client.chats().messages()
+
+        val responseFuture =
+            messageServiceAsync.react(
+                MessageReactParams.builder()
+                    .chatId("chatId")
+                    .messageId("messageId")
+                    .reaction("+love")
+                    .direction(MessageReactParams.Direction.INBOUND)
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun send() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val messageServiceAsync = client.chats().messages()
+
+        val responseFuture =
+            messageServiceAsync.send(
+                MessageSendParams.builder()
+                    .chatId("chatId")
+                    .idempotencyKey("Idempotency-Key")
+                    .addAttachment("string")
+                    .fromNumber("from_number")
+                    .linkPreview(
+                        LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                    )
+                    .addPart(
+                        MessageSendParams.Part.builder()
+                            .linkPreview(
+                                LinkPreview.builder()
+                                    .imageUrl("https://example.com")
+                                    .title("title")
+                                    .build()
+                            )
+                            .mention("mention")
+                            .name("name")
+                            .text("text")
+                            .url("url")
+                            .build()
+                    )
+                    .shareContact(true)
+                    .text("string")
+                    .useTypingIndicator(true)
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncTest.kt
new file mode 100644
index 0000000..8790dfe
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/PollServiceAsyncTest.kt
@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollSendParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class PollServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun getResults() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val pollServiceAsync = client.chats().polls()
+
+        val responseFuture =
+            pollServiceAsync.getResults(
+                PollGetResultsParams.builder().chatId("chatId").pollId("pollId").build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun send() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val pollServiceAsync = client.chats().polls()
+
+        val responseFuture =
+            pollServiceAsync.send(
+                PollSendParams.builder()
+                    .chatId("chatId")
+                    .addOption("string")
+                    .addOption("string")
+                    .title("title")
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncTest.kt
new file mode 100644
index 0000000..4543646
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/TypingServiceAsyncTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class TypingServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun start() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val typingServiceAsync = client.chats().typing()
+
+        val typingResponseFuture = typingServiceAsync.start("chatId")
+
+        val typingResponse = typingResponseFuture.get()
+        typingResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun stop() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val typingServiceAsync = client.chats().typing()
+
+        val typingResponseFuture = typingServiceAsync.stop("chatId")
+
+        val typingResponse = typingResponseFuture.get()
+        typingResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
deleted file mode 100644
index c05c0a4..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/config/WebhookServiceAsyncTest.kt
+++ /dev/null
@@ -1,38 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.async.config
-
-import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import org.junit.jupiter.api.Disabled
-import org.junit.jupiter.api.Test
-
-internal class WebhookServiceAsyncTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieve() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val webhookServiceAsync = client.config().webhook()
-
-        val webhookFuture = webhookServiceAsync.retrieve()
-
-        val webhook = webhookFuture.get()
-        webhook.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun update() {
-        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
-        val webhookServiceAsync = client.config().webhook()
-
-        val webhookFuture =
-            webhookServiceAsync.update(
-                WebhookUpdateParams.builder().webhookUrl("https://example.com/mywebhook").build()
-            )
-
-        val webhook = webhookFuture.get()
-        webhook.validate()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncTest.kt
new file mode 100644
index 0000000..03e9c7e
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/contacts/TagServiceAsyncTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.contacts
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class TagServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val tagServiceAsync = client.contacts().tags()
+
+        val tagsFuture = tagServiceAsync.list("%2B15551234567")
+
+        val tags = tagsFuture.get()
+        tags.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun add() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val tagServiceAsync = client.contacts().tags()
+
+        val responseFuture =
+            tagServiceAsync.add(
+                TagAddParams.builder()
+                    .contactId("%2B15551234567")
+                    .addTag("vip")
+                    .addTag("priority")
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val tagServiceAsync = client.contacts().tags()
+
+        val deleteResponseFuture =
+            tagServiceAsync.remove(
+                TagRemoveParams.builder().contactId("%2B15551234567").tag("vip").build()
+            )
+
+        val deleteResponse = deleteResponseFuture.get()
+        deleteResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncTest.kt
new file mode 100644
index 0000000..adaeb23
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/IconServiceAsyncTest.kt
@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.groups.icon.IconSetParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class IconServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val iconServiceAsync = client.groups().icon()
+
+        val groupIconFuture = iconServiceAsync.remove("grp_abc123def456")
+
+        val groupIcon = groupIconFuture.get()
+        groupIcon.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun set() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val iconServiceAsync = client.groups().icon()
+
+        val groupIconFuture =
+            iconServiceAsync.set(
+                IconSetParams.builder()
+                    .groupId("grp_abc123def456")
+                    .icon("Example data".byteInputStream())
+                    .build()
+            )
+
+        val groupIcon = groupIconFuture.get()
+        groupIcon.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncTest.kt
new file mode 100644
index 0000000..d006a16
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/groups/MemberServiceAsyncTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.groups
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class MemberServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val memberServiceAsync = client.groups().members()
+
+        val membersFuture =
+            memberServiceAsync.list(
+                MemberListParams.builder().groupId("grp_abc123def456").limit(1L).offset(0L).build()
+            )
+
+        val members = membersFuture.get()
+        members.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun add() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val memberServiceAsync = client.groups().members()
+
+        val responseFuture =
+            memberServiceAsync.add(
+                MemberAddParams.builder()
+                    .groupId("grp_abc123def456")
+                    .contactId("+15551234567")
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val memberServiceAsync = client.groups().members()
+
+        val memberFuture =
+            memberServiceAsync.remove(
+                MemberRemoveParams.builder()
+                    .groupId("grp_abc123def456")
+                    .contactId("%2B15551234567")
+                    .build()
+            )
+
+        val member = memberFuture.get()
+        member.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncTest.kt
new file mode 100644
index 0000000..d0eb5d1
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/location/ContactServiceAsyncTest.kt
@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.location
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class ContactServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.location().contacts()
+
+        val contactLocationFuture = contactServiceAsync.retrieve("handle")
+
+        val contactLocation = contactLocationFuture.get()
+        contactLocation.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.location().contacts()
+
+        val contactsFuture = contactServiceAsync.list()
+
+        val contacts = contactsFuture.get()
+        contacts.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun refresh() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactServiceAsync = client.location().contacts()
+
+        val responseFuture = contactServiceAsync.refresh()
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncTest.kt
new file mode 100644
index 0000000..963255a
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/NumberServiceAsyncTest.kt
@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class NumberServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val numberServiceAsync = client.me().numbers()
+
+        val numbersFuture = numberServiceAsync.list()
+
+        val numbers = numbersFuture.get()
+        numbers.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncTest.kt
new file mode 100644
index 0000000..ef66328
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsyncTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.me.numbers
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class ContactCardServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactCardServiceAsync = client.me().numbers().contactCard()
+
+        val contactCardFuture = contactCardServiceAsync.retrieve("number")
+
+        val contactCard = contactCardFuture.get()
+        contactCard.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val contactCardServiceAsync = client.me().numbers().contactCard()
+
+        val contactCardFuture =
+            contactCardServiceAsync.update(
+                ContactCardUpdateParams.builder()
+                    .number("number")
+                    .avatar("avatar")
+                    .firstName("first_name")
+                    .lastName("last_name")
+                    .sharing(
+                        ContactCardUpdateParams.Sharing.builder()
+                            .audience(0L)
+                            .enabled(true)
+                            .nameFormat(0L)
+                            .build()
+                    )
+                    .build()
+            )
+
+        val contactCard = contactCardFuture.get()
+        contactCard.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncTest.kt
new file mode 100644
index 0000000..cfa6729
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/phonenumbers/LookupServiceAsyncTest.kt
@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.phonenumbers
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class LookupServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val lookupServiceAsync = client.phoneNumbers().lookup()
+
+        val phoneNumberLookupResultFuture =
+            lookupServiceAsync.create(LookupCreateParams.builder().number("+12125551234").build())
+
+        val phoneNumberLookupResult = phoneNumberLookupResultFuture.get()
+        phoneNumberLookupResult.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val lookupServiceAsync = client.phoneNumbers().lookup()
+
+        val phoneNumberLookupResultFuture =
+            lookupServiceAsync.retrieve(
+                LookupRetrieveParams.builder().number("+12125551234").build()
+            )
+
+        val phoneNumberLookupResult = phoneNumberLookupResultFuture.get()
+        phoneNumberLookupResult.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncTest.kt
new file mode 100644
index 0000000..4399653
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/LogServiceAsyncTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class LogServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val logServiceAsync = client.webhooks().logs()
+
+        val logsFuture =
+            logServiceAsync.list(
+                LogListParams.builder()
+                    .webhookId("wh_abc123def456")
+                    .limit(1L)
+                    .maxStatus(0L)
+                    .minStatus(0L)
+                    .offset(0L)
+                    .sort(LogListParams.Sort.ASC)
+                    .status(0L)
+                    .build()
+            )
+
+        val logs = logsFuture.get()
+        logs.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun replay() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val logServiceAsync = client.webhooks().logs()
+
+        val responseFuture =
+            logServiceAsync.replay(
+                LogReplayParams.builder().webhookId("wh_abc123def456").eventId("eventId").build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncTest.kt
new file mode 100644
index 0000000..046bcf8
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/webhooks/SecretServiceAsyncTest.kt
@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.async.webhooks
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClientAsync
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class SecretServiceAsyncTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun rotate() {
+        val client = BlooioOkHttpClientAsync.builder().apiKey("My API Key").build()
+        val secretServiceAsync = client.webhooks().secret()
+
+        val responseFuture = secretServiceAsync.rotate("wh_abc123def456")
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ChatServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ChatServiceTest.kt
new file mode 100644
index 0000000..e598a97
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ChatServiceTest.kt
@@ -0,0 +1,63 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.chats.ChatListParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class ChatServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val chatService = client.chats()
+
+        val chat = chatService.retrieve("chatId")
+
+        chat.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val chatService = client.chats()
+
+        val chats =
+            chatService.list(
+                ChatListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(ChatListParams.Sort.RECENT)
+                    .build()
+            )
+
+        chats.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun markAsRead() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val chatService = client.chats()
+
+        val response = chatService.markAsRead("chatId")
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun shareContactCard() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val chatService = client.chats()
+
+        val response = chatService.shareContactCard("chatId")
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
index 4d44676..974a10c 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/ContactServiceTest.kt
@@ -3,18 +3,90 @@
 package com.blooio.api.services.blocking
 
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.contacts.ContactCreateParams
+import com.blooio.api.models.contacts.ContactListParams
+import com.blooio.api.models.contacts.ContactUpdateParams
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
 
 internal class ContactServiceTest {
 
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactService = client.contacts()
+
+        val contact =
+            contactService.create(
+                ContactCreateParams.builder().identifier("+15551234567").name("John Doe").build()
+            )
+
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactService = client.contacts()
+
+        val contact = contactService.retrieve("%2B15551234567")
+
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactService = client.contacts()
+
+        val contact =
+            contactService.update(
+                ContactUpdateParams.builder().contactId("%2B15551234567").name("Jane Doe").build()
+            )
+
+        contact.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactService = client.contacts()
+
+        val contacts =
+            contactService.list(
+                ContactListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(ContactListParams.Sort.RECENT)
+                    .build()
+            )
+
+        contacts.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactService = client.contacts()
+
+        val deleteResponse = contactService.delete("%2B15551234567")
+
+        deleteResponse.validate()
+    }
+
     @Disabled("Mock server tests are disabled")
     @Test
     fun checkCapabilities() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
         val contactService = client.contacts()
 
-        val response = contactService.checkCapabilities("contact")
+        val response = contactService.checkCapabilities("%2B15551234567")
 
         response.validate()
     }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/FacetimeServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/FacetimeServiceTest.kt
new file mode 100644
index 0000000..f4cf95f
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/FacetimeServiceTest.kt
@@ -0,0 +1,25 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.facetime.FacetimeInitiateCallParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class FacetimeServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun initiateCall() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val facetimeService = client.facetime()
+
+        val response =
+            facetimeService.initiateCall(
+                FacetimeInitiateCallParams.builder().handle("+15551234567").build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/GroupServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/GroupServiceTest.kt
new file mode 100644
index 0000000..189555a
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/GroupServiceTest.kt
@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.groups.GroupCreateParams
+import com.blooio.api.models.groups.GroupListParams
+import com.blooio.api.models.groups.GroupUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class GroupServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val groupService = client.groups()
+
+        val group =
+            groupService.create(
+                GroupCreateParams.builder()
+                    .name("Sales Team")
+                    .chatGuid("iMessage;+;chat123456789")
+                    .addMember("+15551234567")
+                    .addMember("+15559876543")
+                    .build()
+            )
+
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val groupService = client.groups()
+
+        val group = groupService.retrieve("grp_abc123def456")
+
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val groupService = client.groups()
+
+        val group =
+            groupService.update(
+                GroupUpdateParams.builder()
+                    .groupId("grp_abc123def456")
+                    .name("Marketing Team")
+                    .build()
+            )
+
+        group.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val groupService = client.groups()
+
+        val groups =
+            groupService.list(
+                GroupListParams.builder()
+                    .limit(1L)
+                    .offset(0L)
+                    .q("q")
+                    .sort(GroupListParams.Sort.RECENT)
+                    .build()
+            )
+
+        groups.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val groupService = client.groups()
+
+        val group = groupService.delete("grp_abc123def456")
+
+        group.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
deleted file mode 100644
index 04c796e..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/MessageServiceTest.kt
+++ /dev/null
@@ -1,65 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking
-
-import com.blooio.api.client.okhttp.BlooioOkHttpClient
-import com.blooio.api.core.JsonValue
-import com.blooio.api.models.messages.MessageSendParams
-import org.junit.jupiter.api.Disabled
-import org.junit.jupiter.api.Test
-
-internal class MessageServiceTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieve() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val messageService = client.messages()
-
-        val message = messageService.retrieve("messageId")
-
-        message.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun cancel() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val messageService = client.messages()
-
-        val response = messageService.cancel("messageId")
-
-        response.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun getStatus() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val messageService = client.messages()
-
-        val response = messageService.getStatus("messageId")
-
-        response.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun send() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val messageService = client.messages()
-
-        val response =
-            messageService.send(
-                MessageSendParams.builder()
-                    .idempotencyKey("Idempotency-Key")
-                    .to("+15551234567")
-                    .addAttachment("https://example.com/image.png")
-                    .metadata(JsonValue.from(mapOf("ticket_id" to "TCK-123")))
-                    .text("Hello world!")
-                    .build()
-            )
-
-        response.validate()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceTest.kt
new file mode 100644
index 0000000..0f0b692
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/PhoneNumberServiceTest.kt
@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.phonenumbers.PhoneNumberBatchCreateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class PhoneNumberServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun batchCreate() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val phoneNumberService = client.phoneNumbers()
+
+        val response =
+            phoneNumberService.batchCreate(
+                PhoneNumberBatchCreateParams.builder()
+                    .numbers(listOf("+12125551234", "+14155551234", "+18582849901"))
+                    .build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/WebhookServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/WebhookServiceTest.kt
new file mode 100644
index 0000000..a1c147c
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/WebhookServiceTest.kt
@@ -0,0 +1,82 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.webhooks.WebhookCreateParams
+import com.blooio.api.models.webhooks.WebhookUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class WebhookServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val webhookService = client.webhooks()
+
+        val webhook =
+            webhookService.create(
+                WebhookCreateParams.builder()
+                    .webhookUrl("https://example.com/webhook")
+                    .validUntil(0L)
+                    .webhookType(WebhookCreateParams.WebhookType.MESSAGE)
+                    .build()
+            )
+
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val webhookService = client.webhooks()
+
+        val webhook = webhookService.retrieve("wh_abc123def456")
+
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val webhookService = client.webhooks()
+
+        val webhook =
+            webhookService.update(
+                WebhookUpdateParams.builder()
+                    .webhookId("wh_abc123def456")
+                    .deprecate(true)
+                    .validUntil(0L)
+                    .webhookType(WebhookUpdateParams.WebhookType.MESSAGE)
+                    .build()
+            )
+
+        webhook.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val webhookService = client.webhooks()
+
+        val webhooks = webhookService.list()
+
+        webhooks.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun delete() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val webhookService = client.webhooks()
+
+        val webhook = webhookService.delete("wh_abc123def456")
+
+        webhook.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceTest.kt
new file mode 100644
index 0000000..3e278a1
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceTest.kt
@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.chats.background.BackgroundSetParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class BackgroundServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val backgroundService = client.chats().background()
+
+        val chatBackgroundResponse = backgroundService.retrieve("chatId")
+
+        chatBackgroundResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val backgroundService = client.chats().background()
+
+        val chatBackgroundResponse = backgroundService.remove("chatId")
+
+        chatBackgroundResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun set() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val backgroundService = client.chats().background()
+
+        val chatBackgroundResponse =
+            backgroundService.set(
+                BackgroundSetParams.builder()
+                    .chatId("chatId")
+                    .background("Example data".byteInputStream())
+                    .build()
+            )
+
+        chatBackgroundResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
new file mode 100644
index 0000000..3e29307
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
@@ -0,0 +1,130 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.chats.messages.LinkPreview
+import com.blooio.api.models.chats.messages.MessageGetStatusParams
+import com.blooio.api.models.chats.messages.MessageListParams
+import com.blooio.api.models.chats.messages.MessageReactParams
+import com.blooio.api.models.chats.messages.MessageRetrieveParams
+import com.blooio.api.models.chats.messages.MessageSendParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class MessageServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val messageService = client.chats().messages()
+
+        val message =
+            messageService.retrieve(
+                MessageRetrieveParams.builder()
+                    .chatId("chatId")
+                    .messageId("msg_abc123def456")
+                    .build()
+            )
+
+        message.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val messageService = client.chats().messages()
+
+        val messages =
+            messageService.list(
+                MessageListParams.builder()
+                    .chatId("chatId")
+                    .direction(MessageListParams.Direction.INBOUND)
+                    .limit(1L)
+                    .offset(0L)
+                    .since(0L)
+                    .sort(MessageListParams.Sort.ASC)
+                    .until(0L)
+                    .build()
+            )
+
+        messages.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun getStatus() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val messageService = client.chats().messages()
+
+        val response =
+            messageService.getStatus(
+                MessageGetStatusParams.builder()
+                    .chatId("chatId")
+                    .messageId("msg_abc123def456")
+                    .build()
+            )
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun react() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val messageService = client.chats().messages()
+
+        val response =
+            messageService.react(
+                MessageReactParams.builder()
+                    .chatId("chatId")
+                    .messageId("messageId")
+                    .reaction("+love")
+                    .direction(MessageReactParams.Direction.INBOUND)
+                    .build()
+            )
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun send() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val messageService = client.chats().messages()
+
+        val response =
+            messageService.send(
+                MessageSendParams.builder()
+                    .chatId("chatId")
+                    .idempotencyKey("Idempotency-Key")
+                    .addAttachment("string")
+                    .fromNumber("from_number")
+                    .linkPreview(
+                        LinkPreview.builder().imageUrl("https://example.com").title("title").build()
+                    )
+                    .addPart(
+                        MessageSendParams.Part.builder()
+                            .linkPreview(
+                                LinkPreview.builder()
+                                    .imageUrl("https://example.com")
+                                    .title("title")
+                                    .build()
+                            )
+                            .mention("mention")
+                            .name("name")
+                            .text("text")
+                            .url("url")
+                            .build()
+                    )
+                    .shareContact(true)
+                    .text("string")
+                    .useTypingIndicator(true)
+                    .build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/PollServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/PollServiceTest.kt
new file mode 100644
index 0000000..470bd5d
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/PollServiceTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.chats.polls.PollGetResultsParams
+import com.blooio.api.models.chats.polls.PollSendParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class PollServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun getResults() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val pollService = client.chats().polls()
+
+        val response =
+            pollService.getResults(
+                PollGetResultsParams.builder().chatId("chatId").pollId("pollId").build()
+            )
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun send() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val pollService = client.chats().polls()
+
+        val response =
+            pollService.send(
+                PollSendParams.builder()
+                    .chatId("chatId")
+                    .addOption("string")
+                    .addOption("string")
+                    .title("title")
+                    .build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/TypingServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/TypingServiceTest.kt
new file mode 100644
index 0000000..6077006
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/TypingServiceTest.kt
@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.chats
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class TypingServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun start() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val typingService = client.chats().typing()
+
+        val typingResponse = typingService.start("chatId")
+
+        typingResponse.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun stop() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val typingService = client.chats().typing()
+
+        val typingResponse = typingService.stop("chatId")
+
+        typingResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
deleted file mode 100644
index aae8744..0000000
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/config/WebhookServiceTest.kt
+++ /dev/null
@@ -1,36 +0,0 @@
-// File generated from our OpenAPI spec by Stainless.
-
-package com.blooio.api.services.blocking.config
-
-import com.blooio.api.client.okhttp.BlooioOkHttpClient
-import com.blooio.api.models.config.webhook.WebhookUpdateParams
-import org.junit.jupiter.api.Disabled
-import org.junit.jupiter.api.Test
-
-internal class WebhookServiceTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun retrieve() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val webhookService = client.config().webhook()
-
-        val webhook = webhookService.retrieve()
-
-        webhook.validate()
-    }
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun update() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val webhookService = client.config().webhook()
-
-        val webhook =
-            webhookService.update(
-                WebhookUpdateParams.builder().webhookUrl("https://example.com/mywebhook").build()
-            )
-
-        webhook.validate()
-    }
-}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/contacts/TagServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/contacts/TagServiceTest.kt
new file mode 100644
index 0000000..b6d680b
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/contacts/TagServiceTest.kt
@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.contacts
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.contacts.tags.TagAddParams
+import com.blooio.api.models.contacts.tags.TagRemoveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class TagServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val tagService = client.contacts().tags()
+
+        val tags = tagService.list("%2B15551234567")
+
+        tags.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun add() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val tagService = client.contacts().tags()
+
+        val response =
+            tagService.add(
+                TagAddParams.builder()
+                    .contactId("%2B15551234567")
+                    .addTag("vip")
+                    .addTag("priority")
+                    .build()
+            )
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val tagService = client.contacts().tags()
+
+        val deleteResponse =
+            tagService.remove(
+                TagRemoveParams.builder().contactId("%2B15551234567").tag("vip").build()
+            )
+
+        deleteResponse.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/IconServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/IconServiceTest.kt
new file mode 100644
index 0000000..8c9c31f
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/IconServiceTest.kt
@@ -0,0 +1,39 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.groups.icon.IconSetParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class IconServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val iconService = client.groups().icon()
+
+        val groupIcon = iconService.remove("grp_abc123def456")
+
+        groupIcon.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun set() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val iconService = client.groups().icon()
+
+        val groupIcon =
+            iconService.set(
+                IconSetParams.builder()
+                    .groupId("grp_abc123def456")
+                    .icon("Example data".byteInputStream())
+                    .build()
+            )
+
+        groupIcon.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/MemberServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/MemberServiceTest.kt
new file mode 100644
index 0000000..7741c2f
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/groups/MemberServiceTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.groups
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.groups.members.MemberAddParams
+import com.blooio.api.models.groups.members.MemberListParams
+import com.blooio.api.models.groups.members.MemberRemoveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class MemberServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val memberService = client.groups().members()
+
+        val members =
+            memberService.list(
+                MemberListParams.builder().groupId("grp_abc123def456").limit(1L).offset(0L).build()
+            )
+
+        members.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun add() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val memberService = client.groups().members()
+
+        val response =
+            memberService.add(
+                MemberAddParams.builder()
+                    .groupId("grp_abc123def456")
+                    .contactId("+15551234567")
+                    .build()
+            )
+
+        response.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun remove() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val memberService = client.groups().members()
+
+        val member =
+            memberService.remove(
+                MemberRemoveParams.builder()
+                    .groupId("grp_abc123def456")
+                    .contactId("%2B15551234567")
+                    .build()
+            )
+
+        member.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/location/ContactServiceTest.kt
similarity index 50%
rename from blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
rename to blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/location/ContactServiceTest.kt
index c85ee5d..9f8a23a 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/BatchServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/location/ContactServiceTest.kt
@@ -1,46 +1,43 @@
 // File generated from our OpenAPI spec by Stainless.
 
-package com.blooio.api.services.blocking
+package com.blooio.api.services.blocking.location
 
 import com.blooio.api.client.okhttp.BlooioOkHttpClient
 import org.junit.jupiter.api.Disabled
 import org.junit.jupiter.api.Test
 
-internal class BatchServiceTest {
-
-    @Disabled("Mock server tests are disabled")
-    @Test
-    fun create() {
-        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val batchService = client.batches()
-
-        batchService.create()
-    }
+internal class ContactServiceTest {
 
     @Disabled("Mock server tests are disabled")
     @Test
     fun retrieve() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val batchService = client.batches()
+        val contactService = client.location().contacts()
+
+        val contactLocation = contactService.retrieve("handle")
 
-        batchService.retrieve("batchId")
+        contactLocation.validate()
     }
 
     @Disabled("Mock server tests are disabled")
     @Test
-    fun listMessages() {
+    fun list() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val batchService = client.batches()
+        val contactService = client.location().contacts()
 
-        batchService.listMessages("batchId")
+        val contacts = contactService.list()
+
+        contacts.validate()
     }
 
     @Disabled("Mock server tests are disabled")
     @Test
-    fun retrieveStatus() {
+    fun refresh() {
         val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
-        val batchService = client.batches()
+        val contactService = client.location().contacts()
+
+        val response = contactService.refresh()
 
-        batchService.retrieveStatus("batchId")
+        response.validate()
     }
 }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/NumberServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/NumberServiceTest.kt
new file mode 100644
index 0000000..7b46a47
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/NumberServiceTest.kt
@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class NumberServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val numberService = client.me().numbers()
+
+        val numbers = numberService.list()
+
+        numbers.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceTest.kt
new file mode 100644
index 0000000..54abda5
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardServiceTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.me.numbers
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.me.numbers.contactcard.ContactCardUpdateParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class ContactCardServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactCardService = client.me().numbers().contactCard()
+
+        val contactCard = contactCardService.retrieve("number")
+
+        contactCard.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun update() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val contactCardService = client.me().numbers().contactCard()
+
+        val contactCard =
+            contactCardService.update(
+                ContactCardUpdateParams.builder()
+                    .number("number")
+                    .avatar("avatar")
+                    .firstName("first_name")
+                    .lastName("last_name")
+                    .sharing(
+                        ContactCardUpdateParams.Sharing.builder()
+                            .audience(0L)
+                            .enabled(true)
+                            .nameFormat(0L)
+                            .build()
+                    )
+                    .build()
+            )
+
+        contactCard.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceTest.kt
new file mode 100644
index 0000000..f2f42a3
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/phonenumbers/LookupServiceTest.kt
@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.phonenumbers
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.phonenumbers.lookup.LookupCreateParams
+import com.blooio.api.models.phonenumbers.lookup.LookupRetrieveParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class LookupServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun create() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val lookupService = client.phoneNumbers().lookup()
+
+        val phoneNumberLookupResult =
+            lookupService.create(LookupCreateParams.builder().number("+12125551234").build())
+
+        phoneNumberLookupResult.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun retrieve() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val lookupService = client.phoneNumbers().lookup()
+
+        val phoneNumberLookupResult =
+            lookupService.retrieve(LookupRetrieveParams.builder().number("+12125551234").build())
+
+        phoneNumberLookupResult.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceTest.kt
new file mode 100644
index 0000000..76768d2
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/LogServiceTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import com.blooio.api.models.webhooks.logs.LogListParams
+import com.blooio.api.models.webhooks.logs.LogReplayParams
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class LogServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun list() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val logService = client.webhooks().logs()
+
+        val logs =
+            logService.list(
+                LogListParams.builder()
+                    .webhookId("wh_abc123def456")
+                    .limit(1L)
+                    .maxStatus(0L)
+                    .minStatus(0L)
+                    .offset(0L)
+                    .sort(LogListParams.Sort.ASC)
+                    .status(0L)
+                    .build()
+            )
+
+        logs.validate()
+    }
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun replay() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val logService = client.webhooks().logs()
+
+        val response =
+            logService.replay(
+                LogReplayParams.builder().webhookId("wh_abc123def456").eventId("eventId").build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceTest.kt
new file mode 100644
index 0000000..e95aaba
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/webhooks/SecretServiceTest.kt
@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.services.blocking.webhooks
+
+import com.blooio.api.client.okhttp.BlooioOkHttpClient
+import org.junit.jupiter.api.Disabled
+import org.junit.jupiter.api.Test
+
+internal class SecretServiceTest {
+
+    @Disabled("Mock server tests are disabled")
+    @Test
+    fun rotate() {
+        val client = BlooioOkHttpClient.builder().apiKey("My API Key").build()
+        val secretService = client.webhooks().secret()
+
+        val response = secretService.rotate("wh_abc123def456")
+
+        response.validate()
+    }
+}
diff --git a/blooio-java-example/build.gradle.kts b/blooio-java-example/build.gradle.kts
index a4e7ea2..e31925b 100644
--- a/blooio-java-example/build.gradle.kts
+++ b/blooio-java-example/build.gradle.kts
@@ -8,7 +8,8 @@ repositories {
 }
 
 dependencies {
-    implementation(project(":blooio-java"))
+    implementation(project(":blooio-java-core"))
+    implementation(project(":blooio-java-client-okhttp"))
 }
 
 tasks.withType<JavaCompile>().configureEach {
diff --git a/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt b/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
index b638f47..fc26fbe 100644
--- a/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
+++ b/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
@@ -50,9 +50,12 @@ internal class ProGuardCompatibilityTest {
         assertThat(client).isNotNull()
         assertThat(client.me()).isNotNull()
         assertThat(client.contacts()).isNotNull()
-        assertThat(client.messages()).isNotNull()
-        assertThat(client.config()).isNotNull()
-        assertThat(client.batches()).isNotNull()
+        assertThat(client.location()).isNotNull()
+        assertThat(client.facetime()).isNotNull()
+        assertThat(client.groups()).isNotNull()
+        assertThat(client.webhooks()).isNotNull()
+        assertThat(client.chats()).isNotNull()
+        assertThat(client.phoneNumbers()).isNotNull()
     }
 
     @Test
@@ -60,30 +63,34 @@ internal class ProGuardCompatibilityTest {
         val jsonMapper = jsonMapper()
         val meRetrieveResponse =
             MeRetrieveResponse.builder()
-                .apiKey("VTAsewjhLz4KUcf3rt8tu")
+                .apiKey("api_key")
+                .authType(MeRetrieveResponse.AuthType.API_KEY)
                 .addDevice(
                     MeRetrieveResponse.Device.builder()
-                        .deviceHash("device_hash")
                         .isActive(true)
                         .lastActive(0L)
+                        .phoneNumber("phone_number")
                         .build()
                 )
-                .integrationDetails(
-                    MeRetrieveResponse.IntegrationDetails.builder()
-                        .customerWebhookUrl("https://example.com")
-                        .metadata(JsonValue.from(mapOf<String, Any>()))
+                .integrationDetails(JsonValue.from(mapOf<String, Any>()))
+                .metadata(JsonValue.from(mapOf<String, Any>()))
+                .organization(
+                    MeRetrieveResponse.Organization.builder()
+                        .countryCode("country_code")
+                        .createdAt(0L)
                         .name("name")
+                        .organizationId("organization_id")
                         .build()
                 )
-                .metadata(JsonValue.from(mapOf<String, Any>()))
-                .plan("trial")
+                .organizationId("organization_id")
                 .usage(
                     MeRetrieveResponse.Usage.builder()
-                        .inboundMessages(42L)
+                        .inboundMessages(0L)
                         .lastMessageSent(0L)
-                        .outboundMessages(156L)
+                        .outboundMessages(0L)
                         .build()
                 )
+                .userId("user_id")
                 .valid(true)
                 .build()
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 3773229..1d80ad0 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -9,7 +9,7 @@ repositories {
 
 allprojects {
     group = "com.blooio.api"
-    version = "0.0.4" // x-release-please-version
+    version = "0.0.4"
 }
 
 subprojects {
diff --git a/buildSrc/src/main/kotlin/blooio.java.gradle.kts b/buildSrc/src/main/kotlin/blooio.java.gradle.kts
index 81d5d32..a3cfe28 100644
--- a/buildSrc/src/main/kotlin/blooio.java.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.java.gradle.kts
@@ -54,7 +54,7 @@ tasks.withType<Test>().configureEach {
 
 val palantir by configurations.creating
 dependencies {
-    palantir("com.palantir.javaformat:palantir-java-format:2.73.0")
+    palantir("com.palantir.javaformat:palantir-java-format:2.89.0")
 }
 
 fun registerPalantir(
diff --git a/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts b/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts
index 2ae7785..2a61b69 100644
--- a/buildSrc/src/main/kotlin/blooio.kotlin.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.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(
diff --git a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
index e83dae5..031188c 100644
--- a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
@@ -9,9 +9,9 @@ configure<PublishingExtension> {
             from(components["java"])
 
             pom {
-                name.set("Blooio Messaging API (v3)")
-                description.set("Public HTTP API for sending and managing iMessage/SMS messages through Blooio.\nAll endpoints are prefixed with `/v1/api` and secured with a Bearer API key.")
-                url.set("https://www.github.com/Blooio/blooio-java-sdk")
+                name.set("Blooio API v2")
+                description.set("RESTful API for iMessage automation. Send messages, manage contacts, groups, and\nwebhooks.")
+                url.set("https://blooio.com")
 
                 licenses {
                     license {
@@ -22,13 +22,14 @@ configure<PublishingExtension> {
                 developers {
                     developer {
                         name.set("Blooio")
+                        email.set("support@blooio.com")
                     }
                 }
 
                 scm {
-                    connection.set("scm:git:git://github.com/Blooio/blooio-java-sdk.git")
-                    developerConnection.set("scm:git:git://github.com/Blooio/blooio-java-sdk.git")
-                    url.set("https://github.com/Blooio/blooio-java-sdk")
+                    connection.set("scm:git:git://github.com/stainless-sdks/blooio-java.git")
+                    developerConnection.set("scm:git:git://github.com/stainless-sdks/blooio-java.git")
+                    url.set("https://github.com/stainless-sdks/blooio-java")
                 }
 
                 versionMapping {
diff --git a/release-please-config.json b/release-please-config.json
deleted file mode 100644
index 8f98719..0000000
--- a/release-please-config.json
+++ /dev/null
@@ -1,67 +0,0 @@
-{
-  "packages": {
-    ".": {}
-  },
-  "$schema": "https://raw.githubusercontent.com/stainless-api/release-please/main/schemas/config.json",
-  "include-v-in-tag": true,
-  "include-component-in-tag": false,
-  "versioning": "prerelease",
-  "prerelease": true,
-  "bump-minor-pre-major": true,
-  "bump-patch-for-minor-pre-major": false,
-  "pull-request-header": "Automated Release PR",
-  "pull-request-title-pattern": "release: ${version}",
-  "changelog-sections": [
-    {
-      "type": "feat",
-      "section": "Features"
-    },
-    {
-      "type": "fix",
-      "section": "Bug Fixes"
-    },
-    {
-      "type": "perf",
-      "section": "Performance Improvements"
-    },
-    {
-      "type": "revert",
-      "section": "Reverts"
-    },
-    {
-      "type": "chore",
-      "section": "Chores"
-    },
-    {
-      "type": "docs",
-      "section": "Documentation"
-    },
-    {
-      "type": "style",
-      "section": "Styles"
-    },
-    {
-      "type": "refactor",
-      "section": "Refactors"
-    },
-    {
-      "type": "test",
-      "section": "Tests",
-      "hidden": true
-    },
-    {
-      "type": "build",
-      "section": "Build System"
-    },
-    {
-      "type": "ci",
-      "section": "Continuous Integration",
-      "hidden": true
-    }
-  ],
-  "release-type": "simple",
-  "extra-files": [
-    "README.md",
-    "build.gradle.kts"
-  ]
-}
\ No newline at end of file
diff --git a/scripts/fast-format b/scripts/fast-format
index 1b3bc47..35a1dee 100755
--- a/scripts/fast-format
+++ b/scripts/fast-format
@@ -24,8 +24,8 @@ if [ ! -f "$FILE_LIST" ]; then
     exit 1
 fi
 
-if ! command -v ktfmt-fast-format &> /dev/null; then
-    echo "Error: ktfmt-fast-format not found"
+if ! command -v ktfmt &> /dev/null; then
+    echo "Error: ktfmt not found"
     exit 1
 fi
 
@@ -36,7 +36,7 @@ echo "==> Done looking for Kotlin files"
 
 if [[ -n "$kt_files" ]]; then
     echo "==> will format Kotlin files"
-    echo "$kt_files" | tr '\n' '\0' | xargs -0 ktfmt-fast-format --kotlinlang-style "$@"
+    echo "$kt_files" | tr '\n' '\0' | xargs -0 ktfmt --kotlinlang-style "$@"
 else
     echo "No Kotlin files to format -- expected outcome during incremental formatting"
 fi

From c9c5703b19a1cb9a3bf235488a960335bebee5a9 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:06:06 +0000
Subject: [PATCH 27/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 85efcf0..4bf7d2b 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: 6b6c2172dff7ef13c233830fab6efadb
+config_hash: 2f87beb285dc1b9468a6634ff8ddcd10

From 910daecd661010b09460080fc221fb91fa27f840 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:06:22 +0000
Subject: [PATCH 28/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 4bf7d2b..465f6d4 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: 2f87beb285dc1b9468a6634ff8ddcd10
+config_hash: c77767bcf98950900544545367f00c21

From c05f9fb421415ac928f815b14c27c794cf0e771e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:06:49 +0000
Subject: [PATCH 29/63] chore: update SDK settings

---
 .github/workflows/publish-sonatype.yml        | 41 ++++++++++++
 .github/workflows/release-doctor.yml          | 24 +++++++
 .release-please-manifest.json                 |  3 +
 .stats.yml                                    |  2 +-
 README.md                                     | 14 +++-
 bin/check-release-environment                 | 33 +++++++++
 .../main/kotlin/com/blooio/api/core/Check.kt  |  2 +-
 build.gradle.kts                              |  2 +-
 .../src/main/kotlin/blooio.publish.gradle.kts |  6 +-
 release-please-config.json                    | 67 +++++++++++++++++++
 10 files changed, 187 insertions(+), 7 deletions(-)
 create mode 100644 .github/workflows/publish-sonatype.yml
 create mode 100644 .github/workflows/release-doctor.yml
 create mode 100644 .release-please-manifest.json
 create mode 100644 bin/check-release-environment
 create mode 100644 release-please-config.json

diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
new file mode 100644
index 0000000..2d81e3a
--- /dev/null
+++ b/.github/workflows/publish-sonatype.yml
@@ -0,0 +1,41 @@
+# This workflow is triggered when a GitHub release is created.
+# It can also be run manually to re-publish to Sonatype in case it failed for some reason.
+# You can run this workflow by navigating to https://www.github.com/Blooio/blooio-java-sdk/actions/workflows/publish-sonatype.yml
+name: Publish Sonatype
+on:
+  workflow_dispatch:
+
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Java
+        uses: actions/setup-java@v5
+        with:
+          distribution: temurin
+          java-version: |
+            8
+            21
+          cache: gradle
+
+      - name: Set up Gradle
+        uses: gradle/gradle-build-action@v2
+
+      - name: Publish to Sonatype
+        run: |-
+          export -- GPG_SIGNING_KEY_ID
+          printenv -- GPG_SIGNING_KEY | gpg --batch --passphrase-fd 3 --import 3<<< "$GPG_SIGNING_PASSWORD"
+          GPG_SIGNING_KEY_ID="$(gpg --with-colons --list-keys | awk -F : -- '/^pub:/ { getline; print "0x" substr($10, length($10) - 7) }')"
+          ./gradlew publish --no-configuration-cache
+        env:
+          SONATYPE_USERNAME: ${{ secrets.BLOOIO_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
+          SONATYPE_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
+          GPG_SIGNING_KEY: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_KEY || secrets.GPG_SIGNING_KEY }}
+          GPG_SIGNING_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_PASSWORD || secrets.GPG_SIGNING_PASSWORD }}
\ No newline at end of file
diff --git a/.github/workflows/release-doctor.yml b/.github/workflows/release-doctor.yml
new file mode 100644
index 0000000..2d36b26
--- /dev/null
+++ b/.github/workflows/release-doctor.yml
@@ -0,0 +1,24 @@
+name: Release Doctor
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  release_doctor:
+    name: release doctor
+    runs-on: ubuntu-latest
+    if: github.repository == 'Blooio/blooio-java-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Check release environment
+        run: |
+          bash ./bin/check-release-environment
+        env:
+          SONATYPE_USERNAME: ${{ secrets.BLOOIO_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
+          SONATYPE_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
+          GPG_SIGNING_KEY: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_KEY || secrets.GPG_SIGNING_KEY }}
+          GPG_SIGNING_PASSWORD: ${{ secrets.BLOOIO_SONATYPE_GPG_SIGNING_PASSWORD || secrets.GPG_SIGNING_PASSWORD }}
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
new file mode 100644
index 0000000..2ed3b71
--- /dev/null
+++ b/.release-please-manifest.json
@@ -0,0 +1,3 @@
+{
+  ".": "0.0.4"
+}
\ No newline at end of file
diff --git a/.stats.yml b/.stats.yml
index 465f6d4..862ba02 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: c77767bcf98950900544545367f00c21
+config_hash: ee4cb1d6948586595c5bd0b7ba74526d
diff --git a/README.md b/README.md
index 0c60ca5..690295a 100644
--- a/README.md
+++ b/README.md
@@ -1,16 +1,26 @@
 # Blooio Java API Library
 
+<!-- x-release-please-start-version -->
+
 [![Maven Central](https://img.shields.io/maven-central/v/com.blooio.api/blooio-java)](https://central.sonatype.com/artifact/com.blooio.api/blooio-java/0.0.4)
 [![javadoc](https://javadoc.io/badge2/com.blooio.api/blooio-java/0.0.4/javadoc.svg)](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4)
 
+<!-- x-release-please-end -->
+
 The Blooio Java SDK provides convenient access to the [Blooio REST API](https://blooio.com) from applications written in Java.
 
 It is generated with [Stainless](https://www.stainless.com/).
 
+<!-- x-release-please-start-version -->
+
 The REST API documentation can be found on [blooio.com](https://blooio.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4).
 
+<!-- x-release-please-end -->
+
 ## Installation
 
+<!-- x-release-please-start-version -->
+
 ### Gradle
 
 ```kotlin
@@ -27,6 +37,8 @@ implementation("com.blooio.api:blooio-java:0.0.4")
 </dependency>
 ```
 
+<!-- x-release-please-end -->
+
 ## Requirements
 
 This library requires Java 8 or later.
@@ -684,4 +696,4 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/stainless-sdks/blooio-java/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/Blooio/blooio-java-sdk/issues) with questions, bugs, or suggestions.
diff --git a/bin/check-release-environment b/bin/check-release-environment
new file mode 100644
index 0000000..3a6a7b4
--- /dev/null
+++ b/bin/check-release-environment
@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+
+errors=()
+
+if [ -z "${SONATYPE_USERNAME}" ]; then
+  errors+=("The SONATYPE_USERNAME secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+fi
+
+if [ -z "${SONATYPE_PASSWORD}" ]; then
+  errors+=("The SONATYPE_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+fi
+
+if [ -z "${GPG_SIGNING_KEY}" ]; then
+  errors+=("The GPG_SIGNING_KEY secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+fi
+
+if [ -z "${GPG_SIGNING_PASSWORD}" ]; then
+  errors+=("The GPG_SIGNING_PASSWORD secret has not been set. Please set it in either this repository's secrets or your organization secrets")
+fi
+
+lenErrors=${#errors[@]}
+
+if [[ lenErrors -gt 0 ]]; then
+  echo -e "Found the following errors in the release environment:\n"
+
+  for error in "${errors[@]}"; do
+    echo -e "- $error\n"
+  done
+
+  exit 1
+fi
+
+echo "The environment is ready to push releases!"
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
index 77df705..83da259 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Check.kt
@@ -77,7 +77,7 @@ This can happen if you are either:
 
 Double-check that you are depending on compatible Jackson versions.
 
-See https://www.github.com/stainless-sdks/blooio-java#jackson for more information.
+See https://www.github.com/Blooio/blooio-java-sdk#jackson for more information.
         """
             .trimIndent()
     }
diff --git a/build.gradle.kts b/build.gradle.kts
index 1d80ad0..3773229 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -9,7 +9,7 @@ repositories {
 
 allprojects {
     group = "com.blooio.api"
-    version = "0.0.4"
+    version = "0.0.4" // x-release-please-version
 }
 
 subprojects {
diff --git a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
index 031188c..720ed98 100644
--- a/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
+++ b/buildSrc/src/main/kotlin/blooio.publish.gradle.kts
@@ -27,9 +27,9 @@ configure<PublishingExtension> {
                 }
 
                 scm {
-                    connection.set("scm:git:git://github.com/stainless-sdks/blooio-java.git")
-                    developerConnection.set("scm:git:git://github.com/stainless-sdks/blooio-java.git")
-                    url.set("https://github.com/stainless-sdks/blooio-java")
+                    connection.set("scm:git:git://github.com/Blooio/blooio-java-sdk.git")
+                    developerConnection.set("scm:git:git://github.com/Blooio/blooio-java-sdk.git")
+                    url.set("https://github.com/Blooio/blooio-java-sdk")
                 }
 
                 versionMapping {
diff --git a/release-please-config.json b/release-please-config.json
new file mode 100644
index 0000000..8f98719
--- /dev/null
+++ b/release-please-config.json
@@ -0,0 +1,67 @@
+{
+  "packages": {
+    ".": {}
+  },
+  "$schema": "https://raw.githubusercontent.com/stainless-api/release-please/main/schemas/config.json",
+  "include-v-in-tag": true,
+  "include-component-in-tag": false,
+  "versioning": "prerelease",
+  "prerelease": true,
+  "bump-minor-pre-major": true,
+  "bump-patch-for-minor-pre-major": false,
+  "pull-request-header": "Automated Release PR",
+  "pull-request-title-pattern": "release: ${version}",
+  "changelog-sections": [
+    {
+      "type": "feat",
+      "section": "Features"
+    },
+    {
+      "type": "fix",
+      "section": "Bug Fixes"
+    },
+    {
+      "type": "perf",
+      "section": "Performance Improvements"
+    },
+    {
+      "type": "revert",
+      "section": "Reverts"
+    },
+    {
+      "type": "chore",
+      "section": "Chores"
+    },
+    {
+      "type": "docs",
+      "section": "Documentation"
+    },
+    {
+      "type": "style",
+      "section": "Styles"
+    },
+    {
+      "type": "refactor",
+      "section": "Refactors"
+    },
+    {
+      "type": "test",
+      "section": "Tests",
+      "hidden": true
+    },
+    {
+      "type": "build",
+      "section": "Build System"
+    },
+    {
+      "type": "ci",
+      "section": "Continuous Integration",
+      "hidden": true
+    }
+  ],
+  "release-type": "simple",
+  "extra-files": [
+    "README.md",
+    "build.gradle.kts"
+  ]
+}
\ No newline at end of file

From 5cf75d9b4b87b9602f9460d77079bbf2fe2e1849 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:08:25 +0000
Subject: [PATCH 30/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 862ba02..068bc0b 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: ee4cb1d6948586595c5bd0b7ba74526d
+config_hash: 835365f7f56a88f670612d481274cb27

From 13a5d39ce2dbd29400b0856799c3c9d3102dbe50 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:09:10 +0000
Subject: [PATCH 31/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 068bc0b..453579c 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: 835365f7f56a88f670612d481274cb27
+config_hash: cade0be519ddc10336c13b95a97fa66b

From 03d22e810a43ea6a223f5d5a5fadc62c12802bb9 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:10:37 +0000
Subject: [PATCH 32/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index 453579c..a68d811 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: cade0be519ddc10336c13b95a97fa66b
+config_hash: 4ff31ba8291fe7e41408e5213e21bdd8

From 7a18b3cb09b0bbf13c6974d6ae188b6dcb7f4c4e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:11:48 +0000
Subject: [PATCH 33/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index a68d811..f636f8e 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: 4ff31ba8291fe7e41408e5213e21bdd8
+config_hash: 822e67821aff6a6627a8f51033b6b04e

From 629a1f4911582eddb074d432c9adf8a042ac2b09 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:14:18 +0000
Subject: [PATCH 34/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index f636f8e..84cbe08 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: 822e67821aff6a6627a8f51033b6b04e
+config_hash: e54325f70a68da7960475794affd2d67

From 1ae97f141b08fc16fba03a7d99d6eace0e512001 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 30 Apr 2026 07:19:22 +0000
Subject: [PATCH 35/63] feat(api): manual updates

---
 .stats.yml                                    |  4 +-
 .../chats/messages/MessageSendParams.kt       | 86 +++++++++++--------
 2 files changed, 52 insertions(+), 38 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 84cbe08..c528af3 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-da8c56bcab4e4ad076aacfdd5f7d5650de8ad6c3a4bb4be17ee3dca2e14724bc.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-9977c183d7c79cffceaa822571a2d33ea0b8f3b7522afb3e6037641b0d9ab843.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
-config_hash: e54325f70a68da7960475794affd2d67
+config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index c9c5b51..9278e99 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -257,9 +257,12 @@ private constructor(
         /** Alias for calling [addAttachment] with `Attachment.ofString(string)`. */
         fun addAttachment(string: String) = apply { body.addAttachment(string) }
 
-        /** Alias for calling [addAttachment] with `Attachment.ofUnionMember1(unionMember1)`. */
-        fun addAttachment(unionMember1: Attachment.UnionMember1) = apply {
-            body.addAttachment(unionMember1)
+        /**
+         * Alias for calling [addAttachment] with
+         * `Attachment.ofUnionObjectVariant1(unionObjectVariant1)`.
+         */
+        fun addAttachment(unionObjectVariant1: Attachment.UnionObjectVariant1) = apply {
+            body.addAttachment(unionObjectVariant1)
         }
 
         /**
@@ -778,9 +781,12 @@ private constructor(
             /** Alias for calling [addAttachment] with `Attachment.ofString(string)`. */
             fun addAttachment(string: String) = addAttachment(Attachment.ofString(string))
 
-            /** Alias for calling [addAttachment] with `Attachment.ofUnionMember1(unionMember1)`. */
-            fun addAttachment(unionMember1: Attachment.UnionMember1) =
-                addAttachment(Attachment.ofUnionMember1(unionMember1))
+            /**
+             * Alias for calling [addAttachment] with
+             * `Attachment.ofUnionObjectVariant1(unionObjectVariant1)`.
+             */
+            fun addAttachment(unionObjectVariant1: Attachment.UnionObjectVariant1) =
+                addAttachment(Attachment.ofUnionObjectVariant1(unionObjectVariant1))
 
             /**
              * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted,
@@ -1031,30 +1037,32 @@ private constructor(
     class Attachment
     private constructor(
         private val string: String? = null,
-        private val unionMember1: UnionMember1? = null,
+        private val unionObjectVariant1: UnionObjectVariant1? = null,
         private val _json: JsonValue? = null,
     ) {
 
         /** URL to the attachment */
         fun string(): Optional<String> = Optional.ofNullable(string)
 
-        fun unionMember1(): Optional<UnionMember1> = Optional.ofNullable(unionMember1)
+        fun unionObjectVariant1(): Optional<UnionObjectVariant1> =
+            Optional.ofNullable(unionObjectVariant1)
 
         fun isString(): Boolean = string != null
 
-        fun isUnionMember1(): Boolean = unionMember1 != null
+        fun isUnionObjectVariant1(): Boolean = unionObjectVariant1 != null
 
         /** URL to the attachment */
         fun asString(): String = string.getOrThrow("string")
 
-        fun asUnionMember1(): UnionMember1 = unionMember1.getOrThrow("unionMember1")
+        fun asUnionObjectVariant1(): UnionObjectVariant1 =
+            unionObjectVariant1.getOrThrow("unionObjectVariant1")
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
         fun <T> accept(visitor: Visitor<T>): T =
             when {
                 string != null -> visitor.visitString(string)
-                unionMember1 != null -> visitor.visitUnionMember1(unionMember1)
+                unionObjectVariant1 != null -> visitor.visitUnionObjectVariant1(unionObjectVariant1)
                 else -> visitor.unknown(_json)
             }
 
@@ -1069,8 +1077,10 @@ private constructor(
                 object : Visitor<Unit> {
                     override fun visitString(string: String) {}
 
-                    override fun visitUnionMember1(unionMember1: UnionMember1) {
-                        unionMember1.validate()
+                    override fun visitUnionObjectVariant1(
+                        unionObjectVariant1: UnionObjectVariant1
+                    ) {
+                        unionObjectVariant1.validate()
                     }
                 }
             )
@@ -1097,8 +1107,9 @@ private constructor(
                 object : Visitor<Int> {
                     override fun visitString(string: String) = 1
 
-                    override fun visitUnionMember1(unionMember1: UnionMember1) =
-                        unionMember1.validity()
+                    override fun visitUnionObjectVariant1(
+                        unionObjectVariant1: UnionObjectVariant1
+                    ) = unionObjectVariant1.validity()
 
                     override fun unknown(json: JsonValue?) = 0
                 }
@@ -1111,15 +1122,16 @@ private constructor(
 
             return other is Attachment &&
                 string == other.string &&
-                unionMember1 == other.unionMember1
+                unionObjectVariant1 == other.unionObjectVariant1
         }
 
-        override fun hashCode(): Int = Objects.hash(string, unionMember1)
+        override fun hashCode(): Int = Objects.hash(string, unionObjectVariant1)
 
         override fun toString(): String =
             when {
                 string != null -> "Attachment{string=$string}"
-                unionMember1 != null -> "Attachment{unionMember1=$unionMember1}"
+                unionObjectVariant1 != null ->
+                    "Attachment{unionObjectVariant1=$unionObjectVariant1}"
                 _json != null -> "Attachment{_unknown=$_json}"
                 else -> throw IllegalStateException("Invalid Attachment")
             }
@@ -1130,7 +1142,8 @@ private constructor(
             @JvmStatic fun ofString(string: String) = Attachment(string = string)
 
             @JvmStatic
-            fun ofUnionMember1(unionMember1: UnionMember1) = Attachment(unionMember1 = unionMember1)
+            fun ofUnionObjectVariant1(unionObjectVariant1: UnionObjectVariant1) =
+                Attachment(unionObjectVariant1 = unionObjectVariant1)
         }
 
         /**
@@ -1141,7 +1154,7 @@ private constructor(
             /** URL to the attachment */
             fun visitString(string: String): T
 
-            fun visitUnionMember1(unionMember1: UnionMember1): T
+            fun visitUnionObjectVariant1(unionObjectVariant1: UnionObjectVariant1): T
 
             /**
              * Maps an unknown variant of [Attachment] to a value of type [T].
@@ -1165,8 +1178,8 @@ private constructor(
 
                 val bestMatches =
                     sequenceOf(
-                            tryDeserialize(node, jacksonTypeRef<UnionMember1>())?.let {
-                                Attachment(unionMember1 = it, _json = json)
+                            tryDeserialize(node, jacksonTypeRef<UnionObjectVariant1>())?.let {
+                                Attachment(unionObjectVariant1 = it, _json = json)
                             },
                             tryDeserialize(node, jacksonTypeRef<String>())?.let {
                                 Attachment(string = it, _json = json)
@@ -1197,14 +1210,15 @@ private constructor(
             ) {
                 when {
                     value.string != null -> generator.writeObject(value.string)
-                    value.unionMember1 != null -> generator.writeObject(value.unionMember1)
+                    value.unionObjectVariant1 != null ->
+                        generator.writeObject(value.unionObjectVariant1)
                     value._json != null -> generator.writeObject(value._json)
                     else -> throw IllegalStateException("Invalid Attachment")
                 }
             }
         }
 
-        class UnionMember1
+        class UnionObjectVariant1
         @JsonCreator(mode = JsonCreator.Mode.DISABLED)
         private constructor(
             private val url: JsonField<String>,
@@ -1260,7 +1274,7 @@ private constructor(
             companion object {
 
                 /**
-                 * Returns a mutable builder for constructing an instance of [UnionMember1].
+                 * Returns a mutable builder for constructing an instance of [UnionObjectVariant1].
                  *
                  * The following fields are required:
                  * ```java
@@ -1270,7 +1284,7 @@ private constructor(
                 @JvmStatic fun builder() = Builder()
             }
 
-            /** A builder for [UnionMember1]. */
+            /** A builder for [UnionObjectVariant1]. */
             class Builder internal constructor() {
 
                 private var url: JsonField<String>? = null
@@ -1278,10 +1292,10 @@ private constructor(
                 private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
                 @JvmSynthetic
-                internal fun from(unionMember1: UnionMember1) = apply {
-                    url = unionMember1.url
-                    name = unionMember1.name
-                    additionalProperties = unionMember1.additionalProperties.toMutableMap()
+                internal fun from(unionObjectVariant1: UnionObjectVariant1) = apply {
+                    url = unionObjectVariant1.url
+                    name = unionObjectVariant1.name
+                    additionalProperties = unionObjectVariant1.additionalProperties.toMutableMap()
                 }
 
                 fun url(url: String) = url(JsonField.of(url))
@@ -1329,7 +1343,7 @@ private constructor(
                 }
 
                 /**
-                 * Returns an immutable instance of [UnionMember1].
+                 * Returns an immutable instance of [UnionObjectVariant1].
                  *
                  * Further updates to this [Builder] will not mutate the returned instance.
                  *
@@ -1340,8 +1354,8 @@ private constructor(
                  *
                  * @throws IllegalStateException if any required field is unset.
                  */
-                fun build(): UnionMember1 =
-                    UnionMember1(
+                fun build(): UnionObjectVariant1 =
+                    UnionObjectVariant1(
                         checkRequired("url", url),
                         name,
                         additionalProperties.toMutableMap(),
@@ -1350,7 +1364,7 @@ private constructor(
 
             private var validated: Boolean = false
 
-            fun validate(): UnionMember1 = apply {
+            fun validate(): UnionObjectVariant1 = apply {
                 if (validated) {
                     return@apply
                 }
@@ -1383,7 +1397,7 @@ private constructor(
                     return true
                 }
 
-                return other is UnionMember1 &&
+                return other is UnionObjectVariant1 &&
                     url == other.url &&
                     name == other.name &&
                     additionalProperties == other.additionalProperties
@@ -1394,7 +1408,7 @@ private constructor(
             override fun hashCode(): Int = hashCode
 
             override fun toString() =
-                "UnionMember1{url=$url, name=$name, additionalProperties=$additionalProperties}"
+                "UnionObjectVariant1{url=$url, name=$name, additionalProperties=$additionalProperties}"
         }
     }
 

From 0d98d0f37a54379ea97127b681677a18fd2ad39c Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 1 May 2026 02:26:19 +0000
Subject: [PATCH 36/63] codegen metadata

---
 .stats.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.stats.yml b/.stats.yml
index c528af3..6af5371 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-9977c183d7c79cffceaa822571a2d33ea0b8f3b7522afb3e6037641b0d9ab843.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-d20a6894e43fc5f309725d0a11b326a41749ec949fdff6d3f33267358e40d4a7.yml
 openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
 config_hash: 839e191496287972d18d39dcab8b19b7

From d05e295ff73aeb1af17db057f1903375d8719bef Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 02:09:44 +0000
Subject: [PATCH 37/63] docs: clarify forwards compat behavior

---
 README.md                                     |   4 +-
 .../api/client/okhttp/BlooioOkHttpClient.kt   |   3 +
 .../client/okhttp/BlooioOkHttpClientAsync.kt  |   3 +
 .../com/blooio/api/core/ClientOptions.kt      |   6 +
 .../com/blooio/api/core/RequestOptions.kt     |   9 ++
 .../blooio/api/models/chats/ChatListParams.kt |   9 ++
 .../api/models/chats/ChatListResponse.kt      |  37 +++++++
 .../models/chats/ChatMarkAsReadResponse.kt    |  17 +++
 .../api/models/chats/ChatRetrieveResponse.kt  |  26 +++++
 .../chats/ChatShareContactCardResponse.kt     |   8 ++
 .../blooio/api/models/chats/LastMessage.kt    |  17 +++
 .../chats/background/BackgroundSetParams.kt   |   9 ++
 .../background/ChatBackgroundResponse.kt      |   8 ++
 .../api/models/chats/messages/LinkPreview.kt  |   8 ++
 .../messages/MessageGetStatusResponse.kt      |  35 ++++++
 .../chats/messages/MessageListParams.kt       |  18 +++
 .../chats/messages/MessageListResponse.kt     |  47 ++++++++
 .../chats/messages/MessageReactParams.kt      |  18 +++
 .../chats/messages/MessageReactResponse.kt    |  17 +++
 .../chats/messages/MessageRetrieveResponse.kt |  44 ++++++++
 .../chats/messages/MessageSendParams.kt       | 104 ++++++++++++++++++
 .../chats/messages/MessageSendResponse.kt     |  17 +++
 .../api/models/chats/messages/Reaction.kt     |   8 ++
 .../chats/polls/PollGetResultsResponse.kt     |  17 +++
 .../api/models/chats/polls/PollSendParams.kt  |   9 ++
 .../models/chats/polls/PollSendResponse.kt    |  17 +++
 .../api/models/chats/typing/TypingResponse.kt |   8 ++
 .../com/blooio/api/models/contacts/Contact.kt |  17 +++
 .../ContactCheckCapabilitiesResponse.kt       |  26 +++++
 .../models/contacts/ContactCreateParams.kt    |   9 ++
 .../api/models/contacts/ContactListParams.kt  |   9 ++
 .../models/contacts/ContactListResponse.kt    |   8 ++
 .../models/contacts/ContactUpdateParams.kt    |   9 ++
 .../api/models/contacts/DeleteResponse.kt     |   8 ++
 .../blooio/api/models/contacts/Pagination.kt  |   8 ++
 .../api/models/contacts/tags/TagAddParams.kt  |   9 ++
 .../models/contacts/tags/TagAddResponse.kt    |   8 ++
 .../models/contacts/tags/TagListResponse.kt   |  17 +++
 .../facetime/FacetimeInitiateCallParams.kt    |   9 ++
 .../facetime/FacetimeInitiateCallResponse.kt  |   8 ++
 .../com/blooio/api/models/groups/Group.kt     |  17 +++
 .../api/models/groups/GroupCreateParams.kt    |   9 ++
 .../api/models/groups/GroupCreateResponse.kt  |   8 ++
 .../api/models/groups/GroupDeleteResponse.kt  |   8 ++
 .../api/models/groups/GroupListParams.kt      |   9 ++
 .../api/models/groups/GroupListResponse.kt    |   8 ++
 .../api/models/groups/GroupUpdateParams.kt    |   9 ++
 .../api/models/groups/GroupUpdateResponse.kt  |  27 +++++
 .../api/models/groups/icon/GroupIcon.kt       |  17 +++
 .../api/models/groups/icon/IconSetParams.kt   |   9 ++
 .../api/models/groups/members/GroupMember.kt  |   8 ++
 .../models/groups/members/MemberAddParams.kt  |   9 ++
 .../groups/members/MemberAddResponse.kt       |   8 ++
 .../groups/members/MemberListResponse.kt      |   8 ++
 .../groups/members/MemberRemoveResponse.kt    |   8 ++
 .../location/contacts/ContactListResponse.kt  |   8 ++
 .../location/contacts/ContactLocation.kt      |   8 ++
 .../contacts/ContactRefreshResponse.kt        |   8 ++
 .../api/models/me/MeRetrieveResponse.kt       |  44 ++++++++
 .../models/me/numbers/NumberListResponse.kt   |  17 +++
 .../ContactCardRetrieveResponse.kt            |  17 +++
 .../contactcard/ContactCardUpdateParams.kt    |  18 +++
 .../contactcard/ContactCardUpdateResponse.kt  |   8 ++
 .../PhoneNumberBatchCreateParams.kt           |   9 ++
 .../PhoneNumberBatchCreateResponse.kt         |   8 ++
 .../phonenumbers/lookup/LookupCreateParams.kt |   9 ++
 .../lookup/PhoneNumberLookupResult.kt         |  26 +++++
 .../com/blooio/api/models/webhooks/Webhook.kt |  26 +++++
 .../models/webhooks/WebhookCreateParams.kt    |  18 +++
 .../models/webhooks/WebhookCreateResponse.kt  |  17 +++
 .../models/webhooks/WebhookDeleteResponse.kt  |   8 ++
 .../models/webhooks/WebhookListResponse.kt    |   8 ++
 .../models/webhooks/WebhookUpdateParams.kt    |  18 +++
 .../api/models/webhooks/logs/LogListParams.kt |   9 ++
 .../models/webhooks/logs/LogListResponse.kt   |  96 ++++++++++++++++
 .../models/webhooks/logs/LogReplayResponse.kt |  17 +++
 .../webhooks/secret/SecretRotateResponse.kt   |   8 ++
 77 files changed, 1234 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 690295a..c4afd0d 100644
--- a/README.md
+++ b/README.md
@@ -630,7 +630,9 @@ In rare cases, the API may return a response that doesn't match the expected typ
 
 By default, the SDK will not throw an exception in this case. It will throw [`BlooioInvalidDataException`](blooio-java-core/src/main/kotlin/com/blooio/api/errors/BlooioInvalidDataException.kt) only if you directly access the property.
 
-If you would prefer to check that the response is completely well-typed upfront, then either call `validate()`:
+Validating the response is _not_ forwards compatible with new types from the API for existing fields.
+
+If you would still prefer to check that the response is completely well-typed upfront, then either call `validate()`:
 
 ```java
 import com.blooio.api.models.me.MeRetrieveResponse;
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index 12f120f..0fba40f 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -217,6 +217,9 @@ class BlooioOkHttpClient private constructor() {
         /**
          * Whether to call `validate` on every response before returning it.
          *
+         * Setting this to `true` is _not_ forwards compatible with new types from the API for
+         * existing fields.
+         *
          * Defaults to false, which means the shape of the response will not be validated upfront.
          * Instead, validation will only occur for the parts of the response that are accessed.
          */
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index 2cd6ba7..77d0a82 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -217,6 +217,9 @@ class BlooioOkHttpClientAsync private constructor() {
         /**
          * Whether to call `validate` on every response before returning it.
          *
+         * Setting this to `true` is _not_ forwards compatible with new types from the API for
+         * existing fields.
+         *
          * Defaults to false, which means the shape of the response will not be validated upfront.
          * Instead, validation will only occur for the parts of the response that are accessed.
          */
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
index a256292..0c07496 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
@@ -66,6 +66,9 @@ private constructor(
     /**
      * Whether to call `validate` on every response before returning it.
      *
+     * Setting this to `true` is _not_ forwards compatible with new types from the API for existing
+     * fields.
+     *
      * Defaults to false, which means the shape of the response will not be validated upfront.
      * Instead, validation will only occur for the parts of the response that are accessed.
      */
@@ -230,6 +233,9 @@ private constructor(
         /**
          * Whether to call `validate` on every response before returning it.
          *
+         * Setting this to `true` is _not_ forwards compatible with new types from the API for
+         * existing fields.
+         *
          * Defaults to false, which means the shape of the response will not be validated upfront.
          * Instead, validation will only occur for the parts of the response that are accessed.
          */
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/RequestOptions.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/RequestOptions.kt
index 33976b6..9547b58 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/RequestOptions.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/RequestOptions.kt
@@ -33,6 +33,15 @@ class RequestOptions private constructor(val responseValidation: Boolean?, val t
         private var responseValidation: Boolean? = null
         private var timeout: Timeout? = null
 
+        /**
+         * Whether to call `validate` on the response before returning it.
+         *
+         * Setting this to `true` is _not_ forwards compatible with new types from the API for
+         * existing fields.
+         *
+         * Defaults to false, which means the shape of the response will not be validated upfront.
+         * Instead, validation will only occur for the parts of the response that are accessed.
+         */
         fun responseValidation(responseValidation: Boolean) = apply {
             this.responseValidation = responseValidation
         }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
index 0c2c079..31fd4ff 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
@@ -325,6 +325,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sort = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
index ab5e950..35791ee 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
@@ -164,6 +164,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ChatListResponse = apply {
         if (validated) {
             return@apply
@@ -795,6 +803,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Chat = apply {
             if (validated) {
                 return@apply
@@ -1019,6 +1036,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Contact = apply {
                 if (validated) {
                     return@apply
@@ -1167,6 +1194,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Type = apply {
                 if (validated) {
                     return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
index b8539e0..8d7d65a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatMarkAsReadResponse.kt
@@ -175,6 +175,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ChatMarkAsReadResponse = apply {
         if (validated) {
             return@apply
@@ -287,6 +295,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Status = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
index 2dc1e56..78f609c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
@@ -634,6 +634,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ChatRetrieveResponse = apply {
         if (validated) {
             return@apply
@@ -850,6 +858,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Contact = apply {
             if (validated) {
                 return@apply
@@ -996,6 +1013,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Type = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
index 10e4993..794f529 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardResponse.kt
@@ -174,6 +174,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ChatShareContactCardResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
index e062062..e0f63a5 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/LastMessage.kt
@@ -200,6 +200,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): LastMessage = apply {
         if (validated) {
             return@apply
@@ -321,6 +329,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Direction = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
index 39638a6..af51c69 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
@@ -405,6 +405,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
index 262582e..1e35e39 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
@@ -280,6 +280,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ChatBackgroundResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
index e3d3ebf..98a3e2c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/LinkPreview.kt
@@ -159,6 +159,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): LinkPreview = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
index 6aaf8b0..e39d007 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
@@ -352,6 +352,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MessageGetStatusResponse = apply {
         if (validated) {
             return@apply
@@ -481,6 +489,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Direction = apply {
             if (validated) {
                 return@apply
@@ -618,6 +635,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Protocol = apply {
             if (validated) {
                 return@apply
@@ -773,6 +799,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Status = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
index 6761c61..ff7429b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
@@ -386,6 +386,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Direction = apply {
             if (validated) {
                 return@apply
@@ -512,6 +521,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sort = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
index 819c4b0..2a496eb 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -196,6 +196,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MessageListResponse = apply {
         if (validated) {
             return@apply
@@ -793,6 +801,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Message = apply {
             if (validated) {
                 return@apply
@@ -937,6 +954,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Direction = apply {
                 if (validated) {
                     return@apply
@@ -1079,6 +1106,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Protocol = apply {
                 if (validated) {
                     return@apply
@@ -1238,6 +1275,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Status = apply {
                 if (validated) {
                     return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
index abd189b..642ee86 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
@@ -496,6 +496,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
@@ -636,6 +645,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Direction = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
index 7d92561..1c6f1e0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactResponse.kt
@@ -216,6 +216,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MessageReactResponse = apply {
         if (validated) {
             return@apply
@@ -336,6 +344,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Action = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
index 3d96814..165f086 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -594,6 +594,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MessageRetrieveResponse = apply {
         if (validated) {
             return@apply
@@ -810,6 +818,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Contact = apply {
             if (validated) {
                 return@apply
@@ -952,6 +969,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Direction = apply {
             if (validated) {
                 return@apply
@@ -1089,6 +1115,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Protocol = apply {
             if (validated) {
                 return@apply
@@ -1244,6 +1279,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Status = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index 9278e99..32bf6af 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -957,6 +957,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
@@ -1059,6 +1068,35 @@ private constructor(
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.blooio.api.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = attachment.accept(new Attachment.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws BlooioInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
         fun <T> accept(visitor: Visitor<T>): T =
             when {
                 string != null -> visitor.visitString(string)
@@ -1068,6 +1106,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Attachment = apply {
             if (validated) {
                 return@apply
@@ -1364,6 +1411,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): UnionObjectVariant1 = apply {
                 if (validated) {
                     return@apply
@@ -1660,6 +1717,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Part = apply {
             if (validated) {
                 return@apply
@@ -1745,6 +1811,35 @@ private constructor(
 
         fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.blooio.api.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = text.accept(new Text.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws BlooioInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
         fun <T> accept(visitor: Visitor<T>): T =
             when {
                 string != null -> visitor.visitString(string)
@@ -1754,6 +1849,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Text = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
index ad427b2..9204c59 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -366,6 +366,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MessageSendResponse = apply {
         if (validated) {
             return@apply
@@ -492,6 +500,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Status = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
index a63dd51..6c3ad0f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/Reaction.kt
@@ -215,6 +215,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): Reaction = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
index e9d889f..76969a9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollGetResultsResponse.kt
@@ -245,6 +245,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): PollGetResultsResponse = apply {
         if (validated) {
             return@apply
@@ -402,6 +410,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Option = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
index 65f79d2..a2a9344 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendParams.kt
@@ -464,6 +464,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
index 3324a44..9e2ba3b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/polls/PollSendResponse.kt
@@ -197,6 +197,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): PollSendResponse = apply {
         if (validated) {
             return@apply
@@ -373,6 +381,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Poll = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
index a2432e8..3e17968 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
@@ -209,6 +209,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): TypingResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
index 9790f8b..cfc63e2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Contact.kt
@@ -370,6 +370,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): Contact = apply {
         if (validated) {
             return@apply
@@ -497,6 +505,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Type = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
index bf667f0..1877f81 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCheckCapabilitiesResponse.kt
@@ -220,6 +220,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactCheckCapabilitiesResponse = apply {
         if (validated) {
             return@apply
@@ -417,6 +425,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Capabilities = apply {
             if (validated) {
                 return@apply
@@ -557,6 +574,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Type = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
index e384936..28d7cb7 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactCreateParams.kt
@@ -422,6 +422,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
index 06da038..ac09196 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
@@ -337,6 +337,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sort = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
index 68dac3e..5cd1f9a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListResponse.kt
@@ -166,6 +166,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactListResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
index 13fcd6e..ab8ebd1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactUpdateParams.kt
@@ -351,6 +351,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
index e028688..21afc0a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/DeleteResponse.kt
@@ -137,6 +137,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): DeleteResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
index 674e00c..321c6cf 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/Pagination.kt
@@ -164,6 +164,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): Pagination = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
index 3185a04..1bc689a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddParams.kt
@@ -401,6 +401,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
index b63c89a..acb6a0b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagAddResponse.kt
@@ -166,6 +166,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): TagAddResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
index 498c8c4..db21cdf 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/tags/TagListResponse.kt
@@ -125,6 +125,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): TagListResponse = apply {
         if (validated) {
             return@apply
@@ -282,6 +290,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Tag = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
index e0f86a7..b961377 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallParams.kt
@@ -361,6 +361,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
index 28f184b..a3b15d1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/facetime/FacetimeInitiateCallResponse.kt
@@ -172,6 +172,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): FacetimeInitiateCallResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
index c774541..6fb47c5 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/Group.kt
@@ -465,6 +465,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): Group = apply {
         if (validated) {
             return@apply
@@ -603,6 +611,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): LastMessageDirection = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
index 17a7c89..5bdc640 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateParams.kt
@@ -536,6 +536,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
index 4c6ba8a..fef8d0b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupCreateResponse.kt
@@ -584,6 +584,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupCreateResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
index 722dc01..c298eca 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupDeleteResponse.kt
@@ -137,6 +137,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupDeleteResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
index 5e5096c..87540f8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
@@ -337,6 +337,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sort = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
index bebc048..9feb161 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListResponse.kt
@@ -165,6 +165,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupListResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
index 9529f5c..d5d7d78 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateParams.kt
@@ -349,6 +349,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
index 8885adf..f5d56c4 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupUpdateResponse.kt
@@ -517,6 +517,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupUpdateResponse = apply {
         if (validated) {
             return@apply
@@ -761,6 +769,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): DeviceSync = apply {
             if (validated) {
                 return@apply
@@ -892,6 +909,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Action = apply {
                 if (validated) {
                     return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
index 7afcfc0..c7be10d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/GroupIcon.kt
@@ -269,6 +269,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupIcon = apply {
         if (validated) {
             return@apply
@@ -470,6 +478,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): DeviceSync = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
index 0c6da27..84f4b58 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/icon/IconSetParams.kt
@@ -398,6 +398,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
index ea64df7..56b1c6f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/GroupMember.kt
@@ -236,6 +236,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): GroupMember = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
index e2e1b1e..332f9b1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddParams.kt
@@ -381,6 +381,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
index 5f93257..e37d59c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberAddResponse.kt
@@ -139,6 +139,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MemberAddResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
index 2afb88b..6ceb12b 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListResponse.kt
@@ -267,6 +267,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MemberListResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
index 660e0ec..85d9f10 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberRemoveResponse.kt
@@ -137,6 +137,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MemberRemoveResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
index 3b50b28..baecd49 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactListResponse.kt
@@ -135,6 +135,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactListResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
index b237893..d646e76 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactLocation.kt
@@ -234,6 +234,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactLocation = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
index a81e437..26c66d8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/location/contacts/ContactRefreshResponse.kt
@@ -163,6 +163,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactRefreshResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
index 4529a59..5347cc8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
@@ -430,6 +430,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): MeRetrieveResponse = apply {
         if (validated) {
             return@apply
@@ -558,6 +566,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): AuthType = apply {
             if (validated) {
                 return@apply
@@ -774,6 +791,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Device = apply {
             if (validated) {
                 return@apply
@@ -1032,6 +1058,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Organization = apply {
             if (validated) {
                 return@apply
@@ -1281,6 +1316,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Usage = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
index 0717517..b64a42d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
@@ -132,6 +132,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): NumberListResponse = apply {
         if (validated) {
             return@apply
@@ -329,6 +337,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Number = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
index 6719141..ca02299 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardRetrieveResponse.kt
@@ -315,6 +315,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactCardRetrieveResponse = apply {
         if (validated) {
             return@apply
@@ -516,6 +524,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sharing = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
index 9780ac2..fb2cead 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
@@ -522,6 +522,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
@@ -741,6 +750,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sharing = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
index d4658b1..fbaf5ea 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateResponse.kt
@@ -212,6 +212,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): ContactCardUpdateResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
index 5215301..41f5557 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateParams.kt
@@ -389,6 +389,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
index a907de4..a346dfa 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/PhoneNumberBatchCreateResponse.kt
@@ -140,6 +140,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): PhoneNumberBatchCreateResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
index d307837..aec565e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/LookupCreateParams.kt
@@ -359,6 +359,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
index ce97483..dcec3ba 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/phonenumbers/lookup/PhoneNumberLookupResult.kt
@@ -579,6 +579,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): PhoneNumberLookupResult = apply {
         if (validated) {
             return@apply
@@ -806,6 +814,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Location = apply {
             if (validated) {
                 return@apply
@@ -1001,6 +1018,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Type = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
index 9d3278f..94a5ae7 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/Webhook.kt
@@ -516,6 +516,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): Webhook = apply {
         if (validated) {
             return@apply
@@ -657,6 +665,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Scope = apply {
             if (validated) {
                 return@apply
@@ -791,6 +808,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): WebhookType = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
index 7f70739..eecb7c9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateParams.kt
@@ -494,6 +494,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
@@ -644,6 +653,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): WebhookType = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
index 8339d10..ebba697 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookCreateResponse.kt
@@ -203,6 +203,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): WebhookCreateResponse = apply {
         if (validated) {
             return@apply
@@ -322,6 +330,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Scope = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
index 8efbe99..7801cd2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookDeleteResponse.kt
@@ -137,6 +137,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): WebhookDeleteResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
index 2a25bfb..9d60846 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookListResponse.kt
@@ -133,6 +133,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): WebhookListResponse = apply {
         if (validated) {
             return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
index faca872..2b9ffb4 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/WebhookUpdateParams.kt
@@ -477,6 +477,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Body = apply {
             if (validated) {
                 return@apply
@@ -627,6 +636,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): WebhookType = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
index dac42c3..6e6f7b2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
@@ -391,6 +391,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Sort = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
index 6b9e42e..52774a7 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
@@ -159,6 +159,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): LogListResponse = apply {
         if (validated) {
             return@apply
@@ -593,6 +601,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Log = apply {
             if (validated) {
                 return@apply
@@ -1508,6 +1525,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): EventBody = apply {
                 if (validated) {
                     return@apply
@@ -1704,6 +1731,16 @@ private constructor(
 
                 private var validated: Boolean = false
 
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws BlooioInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
                 fun validate(): Attachment = apply {
                     if (validated) {
                         return@apply
@@ -1930,6 +1967,16 @@ private constructor(
 
                 private var validated: Boolean = false
 
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws BlooioInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
                 fun validate(): Participant = apply {
                     if (validated) {
                         return@apply
@@ -2089,6 +2136,16 @@ private constructor(
 
                 private var validated: Boolean = false
 
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws BlooioInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
                 fun validate(): Protocol = apply {
                     if (validated) {
                         return@apply
@@ -2251,6 +2308,16 @@ private constructor(
 
                 private var validated: Boolean = false
 
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws BlooioInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
                 fun validate(): Status = apply {
                     if (validated) {
                         return@apply
@@ -2641,6 +2708,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Metadata = apply {
                 if (validated) {
                     return@apply
@@ -2808,6 +2885,16 @@ private constructor(
 
             private var validated: Boolean = false
 
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
             fun validate(): Scope = apply {
                 if (validated) {
                     return@apply
@@ -3111,6 +3198,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): Pagination = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
index a5f1f4a..c9f3211 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogReplayResponse.kt
@@ -371,6 +371,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): LogReplayResponse = apply {
         if (validated) {
             return@apply
@@ -674,6 +682,15 @@ private constructor(
 
         private var validated: Boolean = false
 
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
         fun validate(): ResponseData = apply {
             if (validated) {
                 return@apply
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
index 0675b46..7af1621 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/secret/SecretRotateResponse.kt
@@ -253,6 +253,14 @@ private constructor(
 
     private var validated: Boolean = false
 
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
     fun validate(): SecretRotateResponse = apply {
         if (validated) {
             return@apply

From 8d94c9ea92fb107cb3bbf301db7132cf0e70feb5 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 02:11:35 +0000
Subject: [PATCH 38/63] feat(client): more robust error parsing

---
 .../kotlin/com/blooio/api/errors/BadRequestException.kt    | 6 +++++-
 .../com/blooio/api/errors/InternalServerException.kt       | 7 ++++++-
 .../main/kotlin/com/blooio/api/errors/NotFoundException.kt | 6 +++++-
 .../com/blooio/api/errors/PermissionDeniedException.kt     | 6 +++++-
 .../kotlin/com/blooio/api/errors/RateLimitException.kt     | 6 +++++-
 .../kotlin/com/blooio/api/errors/UnauthorizedException.kt  | 6 +++++-
 .../com/blooio/api/errors/UnexpectedStatusCodeException.kt | 7 ++++++-
 .../com/blooio/api/errors/UnprocessableEntityException.kt  | 6 +++++-
 8 files changed, 42 insertions(+), 8 deletions(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/BadRequestException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/BadRequestException.kt
index 4474405..abc5aa2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/BadRequestException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/BadRequestException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class BadRequestException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("400: $body", cause) {
+    BlooioServiceException(
+        "400: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 400
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/InternalServerException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/InternalServerException.kt
index 8597337..dea69e8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/InternalServerException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/InternalServerException.kt
@@ -5,6 +5,7 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
@@ -14,7 +15,11 @@ private constructor(
     private val headers: Headers,
     private val body: JsonValue,
     cause: Throwable?,
-) : BlooioServiceException("$statusCode: $body", cause) {
+) :
+    BlooioServiceException(
+        "$statusCode: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = statusCode
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/NotFoundException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/NotFoundException.kt
index 6fd595e..a3f41c3 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/NotFoundException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/NotFoundException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class NotFoundException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("404: $body", cause) {
+    BlooioServiceException(
+        "404: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 404
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/PermissionDeniedException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/PermissionDeniedException.kt
index 664a509..3c343bc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/PermissionDeniedException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/PermissionDeniedException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class PermissionDeniedException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("403: $body", cause) {
+    BlooioServiceException(
+        "403: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 403
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/RateLimitException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/RateLimitException.kt
index 6f2e923..9227447 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/RateLimitException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/RateLimitException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class RateLimitException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("429: $body", cause) {
+    BlooioServiceException(
+        "429: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 429
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnauthorizedException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnauthorizedException.kt
index ffa0075..bd54fc0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnauthorizedException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnauthorizedException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class UnauthorizedException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("401: $body", cause) {
+    BlooioServiceException(
+        "401: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 401
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnexpectedStatusCodeException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnexpectedStatusCodeException.kt
index 03bae54..ff324db 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnexpectedStatusCodeException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnexpectedStatusCodeException.kt
@@ -5,6 +5,7 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
@@ -14,7 +15,11 @@ private constructor(
     private val headers: Headers,
     private val body: JsonValue,
     cause: Throwable?,
-) : BlooioServiceException("$statusCode: $body", cause) {
+) :
+    BlooioServiceException(
+        "$statusCode: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = statusCode
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnprocessableEntityException.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnprocessableEntityException.kt
index ba5ee08..bdd02cc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnprocessableEntityException.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/errors/UnprocessableEntityException.kt
@@ -5,12 +5,16 @@ package com.blooio.api.errors
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkRequired
 import com.blooio.api.core.http.Headers
+import com.blooio.api.core.jsonMapper
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 class UnprocessableEntityException
 private constructor(private val headers: Headers, private val body: JsonValue, cause: Throwable?) :
-    BlooioServiceException("422: $body", cause) {
+    BlooioServiceException(
+        "422: ${if (body.isMissing()) "Unknown" else jsonMapper().writeValueAsString(body)}",
+        cause,
+    ) {
 
     override fun statusCode(): Int = 422
 

From c0c274e30b1bbee4384bd90848bb2ba78be70cae Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 02:14:34 +0000
Subject: [PATCH 39/63] chore: remove duplicated dokka setup

---
 build.gradle.kts | 1 -
 1 file changed, 1 deletion(-)

diff --git a/build.gradle.kts b/build.gradle.kts
index 3773229..b711e00 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -22,7 +22,6 @@ subprojects {
         group = "Verification"
         description = "Verifies all source files are formatted."
     }
-    apply(plugin = "org.jetbrains.dokka")
 }
 
 subprojects {

From 6ef289e91429c1d6e5b7eea1746b0bb9ce24645b Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 5 May 2026 02:16:38 +0000
Subject: [PATCH 40/63] perf(client): create one json mapper

---
 .../src/main/kotlin/com/blooio/api/core/ObjectMappers.kt      | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
index 47b2466..5bf6b78 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ObjectMappers.kt
@@ -29,7 +29,9 @@ import java.time.ZoneId
 import java.time.format.DateTimeFormatter
 import java.time.temporal.ChronoField
 
-fun jsonMapper(): JsonMapper =
+fun jsonMapper(): JsonMapper = JSON_MAPPER
+
+private val JSON_MAPPER: JsonMapper =
     JsonMapper.builder()
         .addModule(kotlinModule())
         .addModule(Jdk8Module())

From 8e5c00ecbd7d4ba6e9c3f06d0001c2a953ac564e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 6 May 2026 02:02:06 +0000
Subject: [PATCH 41/63] feat(client): support proxy authentication

---
 README.md                                     |  15 ++
 .../api/client/okhttp/BlooioOkHttpClient.kt   |  17 ++
 .../client/okhttp/BlooioOkHttpClientAsync.kt  |  17 ++
 .../blooio/api/client/okhttp/OkHttpClient.kt  | 234 +++++++++++-------
 .../api/core/http/ProxyAuthenticator.kt       |  59 +++++
 5 files changed, 257 insertions(+), 85 deletions(-)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/core/http/ProxyAuthenticator.kt

diff --git a/README.md b/README.md
index c4afd0d..3557676 100644
--- a/README.md
+++ b/README.md
@@ -397,6 +397,21 @@ BlooioClient client = BlooioOkHttpClient.builder()
     .build();
 ```
 
+If the proxy responds with `407 Proxy Authentication Required`, supply credentials by also configuring `proxyAuthenticator`:
+
+```java
+import com.blooio.api.client.BlooioClient;
+import com.blooio.api.client.okhttp.BlooioOkHttpClient;
+import com.blooio.api.core.http.ProxyAuthenticator;
+
+BlooioClient client = BlooioOkHttpClient.builder()
+    .fromEnv()
+    .proxy(...)
+    // Or a custom implementation of `ProxyAuthenticator`.
+    .proxyAuthenticator(ProxyAuthenticator.basic("username", "password"))
+    .build();
+```
+
 ### Connection pooling
 
 To customize the underlying OkHttp connection pool, configure the client using the `maxIdleConnections` and `keepAliveDuration` methods:
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index 0fba40f..1444f33 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -9,6 +9,7 @@ import com.blooio.api.core.Sleeper
 import com.blooio.api.core.Timeout
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.HttpClient
+import com.blooio.api.core.http.ProxyAuthenticator
 import com.blooio.api.core.http.QueryParams
 import com.blooio.api.core.jsonMapper
 import com.fasterxml.jackson.databind.json.JsonMapper
@@ -47,6 +48,7 @@ class BlooioOkHttpClient private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var proxyAuthenticator: ProxyAuthenticator? = null
         private var maxIdleConnections: Int? = null
         private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
@@ -77,6 +79,20 @@ class BlooioOkHttpClient private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * Provides credentials when an HTTP proxy responds with `407 Proxy Authentication
+         * Required`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: ProxyAuthenticator?) = apply {
+            this.proxyAuthenticator = proxyAuthenticator
+        }
+
+        /**
+         * Alias for calling [Builder.proxyAuthenticator] with `proxyAuthenticator.orElse(null)`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: Optional<ProxyAuthenticator>) =
+            proxyAuthenticator(proxyAuthenticator.getOrNull())
+
         /**
          * The maximum number of idle connections kept by the underlying OkHttp connection pool.
          *
@@ -363,6 +379,7 @@ class BlooioOkHttpClient private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .proxyAuthenticator(proxyAuthenticator)
                             .maxIdleConnections(maxIdleConnections)
                             .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index 77d0a82..32c3dd2 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -9,6 +9,7 @@ import com.blooio.api.core.Sleeper
 import com.blooio.api.core.Timeout
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.HttpClient
+import com.blooio.api.core.http.ProxyAuthenticator
 import com.blooio.api.core.http.QueryParams
 import com.blooio.api.core.jsonMapper
 import com.fasterxml.jackson.databind.json.JsonMapper
@@ -47,6 +48,7 @@ class BlooioOkHttpClientAsync private constructor() {
         private var clientOptions: ClientOptions.Builder = ClientOptions.builder()
         private var dispatcherExecutorService: ExecutorService? = null
         private var proxy: Proxy? = null
+        private var proxyAuthenticator: ProxyAuthenticator? = null
         private var maxIdleConnections: Int? = null
         private var keepAliveDuration: Duration? = null
         private var sslSocketFactory: SSLSocketFactory? = null
@@ -77,6 +79,20 @@ class BlooioOkHttpClientAsync private constructor() {
         /** Alias for calling [Builder.proxy] with `proxy.orElse(null)`. */
         fun proxy(proxy: Optional<Proxy>) = proxy(proxy.getOrNull())
 
+        /**
+         * Provides credentials when an HTTP proxy responds with `407 Proxy Authentication
+         * Required`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: ProxyAuthenticator?) = apply {
+            this.proxyAuthenticator = proxyAuthenticator
+        }
+
+        /**
+         * Alias for calling [Builder.proxyAuthenticator] with `proxyAuthenticator.orElse(null)`.
+         */
+        fun proxyAuthenticator(proxyAuthenticator: Optional<ProxyAuthenticator>) =
+            proxyAuthenticator(proxyAuthenticator.getOrNull())
+
         /**
          * The maximum number of idle connections kept by the underlying OkHttp connection pool.
          *
@@ -363,6 +379,7 @@ class BlooioOkHttpClientAsync private constructor() {
                         OkHttpClient.builder()
                             .timeout(clientOptions.timeout())
                             .proxy(proxy)
+                            .proxyAuthenticator(proxyAuthenticator)
                             .maxIdleConnections(maxIdleConnections)
                             .keepAliveDuration(keepAliveDuration)
                             .dispatcherExecutorService(dispatcherExecutorService)
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
index ccb1cdf..2874c46 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
@@ -8,9 +8,11 @@ import com.blooio.api.core.http.HttpMethod
 import com.blooio.api.core.http.HttpRequest
 import com.blooio.api.core.http.HttpRequestBody
 import com.blooio.api.core.http.HttpResponse
+import com.blooio.api.core.http.ProxyAuthenticator
 import com.blooio.api.errors.BlooioIoException
 import java.io.IOException
 import java.io.InputStream
+import java.io.OutputStream
 import java.net.Proxy
 import java.time.Duration
 import java.util.concurrent.CancellationException
@@ -20,10 +22,12 @@ import java.util.concurrent.TimeUnit
 import javax.net.ssl.HostnameVerifier
 import javax.net.ssl.SSLSocketFactory
 import javax.net.ssl.X509TrustManager
+import kotlin.jvm.optionals.getOrNull
 import okhttp3.Call
 import okhttp3.Callback
 import okhttp3.ConnectionPool
 import okhttp3.Dispatcher
+import okhttp3.HttpUrl
 import okhttp3.HttpUrl.Companion.toHttpUrl
 import okhttp3.MediaType
 import okhttp3.MediaType.Companion.toMediaType
@@ -33,6 +37,8 @@ import okhttp3.RequestBody.Companion.toRequestBody
 import okhttp3.Response
 import okhttp3.logging.HttpLoggingInterceptor
 import okio.BufferedSink
+import okio.buffer
+import okio.sink
 
 class OkHttpClient
 internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClient) : HttpClient {
@@ -41,7 +47,7 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
         val call = newCall(request, requestOptions)
 
         return try {
-            call.execute().toResponse()
+            call.execute().toHttpResponse()
         } catch (e: IOException) {
             throw BlooioIoException("Request failed", e)
         } finally {
@@ -59,7 +65,7 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
         call.enqueue(
             object : Callback {
                 override fun onResponse(call: Call, response: Response) {
-                    future.complete(response.toResponse())
+                    future.complete(response.toHttpResponse())
                 }
 
                 override fun onFailure(call: Call, e: IOException) {
@@ -111,89 +117,6 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
         return client.newCall(request.toRequest(client))
     }
 
-    private fun HttpRequest.toRequest(client: okhttp3.OkHttpClient): Request {
-        var body: RequestBody? = body?.toRequestBody()
-        if (body == null && requiresBody(method)) {
-            body = "".toRequestBody()
-        }
-
-        val builder = Request.Builder().url(toUrl()).method(method.name, body)
-        headers.names().forEach { name ->
-            headers.values(name).forEach { builder.addHeader(name, it) }
-        }
-
-        if (
-            !headers.names().contains("X-Stainless-Read-Timeout") && client.readTimeoutMillis != 0
-        ) {
-            builder.addHeader(
-                "X-Stainless-Read-Timeout",
-                Duration.ofMillis(client.readTimeoutMillis.toLong()).seconds.toString(),
-            )
-        }
-        if (!headers.names().contains("X-Stainless-Timeout") && client.callTimeoutMillis != 0) {
-            builder.addHeader(
-                "X-Stainless-Timeout",
-                Duration.ofMillis(client.callTimeoutMillis.toLong()).seconds.toString(),
-            )
-        }
-
-        return builder.build()
-    }
-
-    /** `OkHttpClient` always requires a request body for some methods. */
-    private fun requiresBody(method: HttpMethod): Boolean =
-        when (method) {
-            HttpMethod.POST,
-            HttpMethod.PUT,
-            HttpMethod.PATCH -> true
-            else -> false
-        }
-
-    private fun HttpRequest.toUrl(): String {
-        val builder = baseUrl.toHttpUrl().newBuilder()
-        pathSegments.forEach(builder::addPathSegment)
-        queryParams.keys().forEach { key ->
-            queryParams.values(key).forEach { builder.addQueryParameter(key, it) }
-        }
-
-        return builder.toString()
-    }
-
-    private fun HttpRequestBody.toRequestBody(): RequestBody {
-        val mediaType = contentType()?.toMediaType()
-        val length = contentLength()
-
-        return object : RequestBody() {
-            override fun contentType(): MediaType? = mediaType
-
-            override fun contentLength(): Long = length
-
-            override fun isOneShot(): Boolean = !repeatable()
-
-            override fun writeTo(sink: BufferedSink) = writeTo(sink.outputStream())
-        }
-    }
-
-    private fun Response.toResponse(): HttpResponse {
-        val headers = headers.toHeaders()
-
-        return object : HttpResponse {
-            override fun statusCode(): Int = code
-
-            override fun headers(): Headers = headers
-
-            override fun body(): InputStream = body!!.byteStream()
-
-            override fun close() = body!!.close()
-        }
-    }
-
-    private fun okhttp3.Headers.toHeaders(): Headers {
-        val headersBuilder = Headers.builder()
-        forEach { (name, value) -> headersBuilder.put(name, value) }
-        return headersBuilder.build()
-    }
-
     companion object {
         @JvmStatic fun builder() = Builder()
     }
@@ -202,6 +125,7 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
 
         private var timeout: Timeout = Timeout.default()
         private var proxy: Proxy? = null
+        private var proxyAuthenticator: ProxyAuthenticator? = null
         private var maxIdleConnections: Int? = null
         private var keepAliveDuration: Duration? = null
         private var dispatcherExecutorService: ExecutorService? = null
@@ -215,6 +139,10 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
 
         fun proxy(proxy: Proxy?) = apply { this.proxy = proxy }
 
+        fun proxyAuthenticator(proxyAuthenticator: ProxyAuthenticator?) = apply {
+            this.proxyAuthenticator = proxyAuthenticator
+        }
+
         /**
          * Sets the maximum number of idle connections kept by the underlying [ConnectionPool].
          *
@@ -264,6 +192,19 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
                     .callTimeout(timeout.request())
                     .proxy(proxy)
                     .apply {
+                        proxyAuthenticator?.let { auth ->
+                            proxyAuthenticator { route, response ->
+                                auth
+                                    .authenticate(
+                                        route?.proxy ?: Proxy.NO_PROXY,
+                                        response.request.toHttpRequest(),
+                                        response.toHttpResponse(),
+                                    )
+                                    .getOrNull()
+                                    ?.toRequest(client = null)
+                            }
+                        }
+
                         dispatcherExecutorService?.let { dispatcher(Dispatcher(it)) }
 
                         val maxIdleConnections = maxIdleConnections
@@ -303,3 +244,126 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
             )
     }
 }
+
+private fun HttpRequest.toRequest(client: okhttp3.OkHttpClient?): Request {
+    var body: RequestBody? = body?.toRequestBody()
+    if (body == null && requiresBody(method)) {
+        body = "".toRequestBody()
+    }
+
+    val builder = Request.Builder().url(toUrl()).method(method.name, body)
+    headers.names().forEach { name -> headers.values(name).forEach { builder.addHeader(name, it) } }
+
+    if (client != null) {
+        if (
+            !headers.names().contains("X-Stainless-Read-Timeout") && client.readTimeoutMillis != 0
+        ) {
+            builder.addHeader(
+                "X-Stainless-Read-Timeout",
+                Duration.ofMillis(client.readTimeoutMillis.toLong()).seconds.toString(),
+            )
+        }
+        if (!headers.names().contains("X-Stainless-Timeout") && client.callTimeoutMillis != 0) {
+            builder.addHeader(
+                "X-Stainless-Timeout",
+                Duration.ofMillis(client.callTimeoutMillis.toLong()).seconds.toString(),
+            )
+        }
+    }
+
+    return builder.build()
+}
+
+/** `OkHttpClient` always requires a request body for some methods. */
+private fun requiresBody(method: HttpMethod): Boolean =
+    when (method) {
+        HttpMethod.POST,
+        HttpMethod.PUT,
+        HttpMethod.PATCH -> true
+        else -> false
+    }
+
+private fun HttpRequest.toUrl(): String {
+    val builder = baseUrl.toHttpUrl().newBuilder()
+    pathSegments.forEach(builder::addPathSegment)
+    queryParams.keys().forEach { key ->
+        queryParams.values(key).forEach { builder.addQueryParameter(key, it) }
+    }
+
+    return builder.toString()
+}
+
+private fun HttpRequestBody.toRequestBody(): RequestBody {
+    val mediaType = contentType()?.toMediaType()
+    val length = contentLength()
+
+    return object : RequestBody() {
+        override fun contentType(): MediaType? = mediaType
+
+        override fun contentLength(): Long = length
+
+        override fun isOneShot(): Boolean = !repeatable()
+
+        override fun writeTo(sink: BufferedSink) = writeTo(sink.outputStream())
+    }
+}
+
+private fun Request.toHttpRequest(): HttpRequest {
+    val builder = HttpRequest.builder().method(HttpMethod.valueOf(method)).baseUrl(url.toBaseUrl())
+    url.pathSegments.forEach(builder::addPathSegment)
+    url.queryParameterNames.forEach { name ->
+        url.queryParameterValues(name).filterNotNull().forEach { builder.putQueryParam(name, it) }
+    }
+    headers.forEach { (name, value) -> builder.putHeader(name, value) }
+    body?.let { builder.body(it.toHttpRequestBody()) }
+    return builder.build()
+}
+
+private fun HttpUrl.toBaseUrl(): String = buildString {
+    append(scheme).append("://").append(host)
+    if (port != HttpUrl.defaultPort(scheme)) {
+        append(":").append(port)
+    }
+}
+
+private fun RequestBody.toHttpRequestBody(): HttpRequestBody {
+    val mediaType = contentType()?.toString()
+    val length = contentLength()
+    val isOneShot = isOneShot()
+    val source = this
+    return object : HttpRequestBody {
+        override fun contentType(): String? = mediaType
+
+        override fun contentLength(): Long = length
+
+        override fun repeatable(): Boolean = !isOneShot
+
+        override fun writeTo(outputStream: OutputStream) {
+            val sink = outputStream.sink().buffer()
+            source.writeTo(sink)
+            sink.flush()
+        }
+
+        override fun close() {}
+    }
+}
+
+private fun Response.toHttpResponse(): HttpResponse {
+    val headers = headers.toHeaders()
+
+    return object : HttpResponse {
+        override fun statusCode(): Int = code
+
+        override fun headers(): Headers = headers
+
+        override fun body(): InputStream = body!!.byteStream()
+
+        override fun close() = body!!.close()
+    }
+}
+
+private fun okhttp3.Headers.toHeaders(): Headers {
+    val headersBuilder = Headers.builder()
+    forEach { (name, value) -> headersBuilder.put(name, value) }
+    return headersBuilder.build()
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/ProxyAuthenticator.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/ProxyAuthenticator.kt
new file mode 100644
index 0000000..8fa881a
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/ProxyAuthenticator.kt
@@ -0,0 +1,59 @@
+package com.blooio.api.core.http
+
+import java.net.Proxy
+import java.nio.charset.Charset
+import java.nio.charset.StandardCharsets
+import java.util.Base64
+import java.util.Optional
+
+/**
+ * Provides credentials when an HTTP proxy responds with `407 Proxy Authentication Required`.
+ *
+ * Implementations inspect the 407 [response] (typically its `Proxy-Authenticate` header) and return
+ * the request to retry with a `Proxy-Authorization` header set, or [Optional.empty] to abandon
+ * authentication and surface the 407 to the caller.
+ *
+ * Implementations must be thread-safe; they may be invoked concurrently from multiple HTTP calls.
+ */
+fun interface ProxyAuthenticator {
+
+    /**
+     * @param proxy the proxy that produced the challenge, or [Proxy.NO_PROXY] if the route is not
+     *   yet established
+     * @param request the request that produced [response]
+     * @param response the 407 challenge response
+     * @return the retry request to send (typically [request] with a `Proxy-Authorization` header
+     *   added), or [Optional.empty] to abandon authentication
+     */
+    fun authenticate(
+        proxy: Proxy,
+        request: HttpRequest,
+        response: HttpResponse,
+    ): Optional<HttpRequest>
+
+    companion object {
+
+        /**
+         * A [ProxyAuthenticator] that uses RFC 7617 Basic authentication with the ISO-8859-1
+         * charset.
+         */
+        @JvmStatic
+        fun basic(username: String, password: String): ProxyAuthenticator =
+            basic(username, password, StandardCharsets.ISO_8859_1)
+
+        /**
+         * A [ProxyAuthenticator] that uses RFC 7617 Basic authentication with the given [charset].
+         */
+        @JvmStatic
+        fun basic(username: String, password: String, charset: Charset): ProxyAuthenticator {
+            val token =
+                Base64.getEncoder().encodeToString("$username:$password".toByteArray(charset))
+            val headerValue = "Basic $token"
+            return ProxyAuthenticator { _, request, _ ->
+                Optional.of(
+                    request.toBuilder().putHeader("Proxy-Authorization", headerValue).build()
+                )
+            }
+        }
+    }
+}

From b1579ce887a34b5a401642abe28d25d16d1c9194 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 7 May 2026 02:05:41 +0000
Subject: [PATCH 42/63] feat(client): improve logging

Logging is now:
1. Streaming
4. Configurable in-memory
5. Generally more robust
6. Usable with any underlying http client
---
 README.md                                     |  15 +-
 blooio-java-client-okhttp/build.gradle.kts    |   1 -
 .../api/client/okhttp/BlooioOkHttpClient.kt   |  10 +
 .../client/okhttp/BlooioOkHttpClientAsync.kt  |  10 +
 .../blooio/api/client/okhttp/OkHttpClient.kt  |  13 -
 .../com/blooio/api/core/ClientOptions.kt      |  30 +-
 .../kotlin/com/blooio/api/core/LogLevel.kt    |  33 +
 .../main/kotlin/com/blooio/api/core/Utils.kt  |   6 +
 .../blooio/api/core/http/LoggingHttpClient.kt | 627 +++++++++++
 .../api/core/http/LoggingHttpClientTest.kt    | 999 ++++++++++++++++++
 10 files changed, 1727 insertions(+), 17 deletions(-)
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/core/LogLevel.kt
 create mode 100644 blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
 create mode 100644 blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt

diff --git a/README.md b/README.md
index 3557676..441553f 100644
--- a/README.md
+++ b/README.md
@@ -291,8 +291,6 @@ The SDK throws custom unchecked exception types:
 
 ## Logging
 
-The SDK uses the standard [OkHttp logging interceptor](https://github.com/square/okhttp/tree/master/okhttp-logging-interceptor).
-
 Enable logging by setting the `BLOOIO_LOG` environment variable to `info`:
 
 ```sh
@@ -305,6 +303,19 @@ Or to `debug` for more verbose logging:
 export BLOOIO_LOG=debug
 ```
 
+Or configure the client manually using the `logLevel` method:
+
+```java
+import com.blooio.api.client.BlooioClient;
+import com.blooio.api.client.okhttp.BlooioOkHttpClient;
+import com.blooio.api.core.LogLevel;
+
+BlooioClient client = BlooioOkHttpClient.builder()
+    .fromEnv()
+    .logLevel(LogLevel.INFO)
+    .build();
+```
+
 ## ProGuard and R8
 
 Although the SDK uses reflection, it is still usable with [ProGuard](https://github.com/Guardsquare/proguard) and [R8](https://developer.android.com/topic/performance/app-optimization/enable-app-optimization) because `blooio-java-core` is published with a [configuration file](blooio-java-core/src/main/resources/META-INF/proguard/blooio-java-core.pro) containing [keep rules](https://www.guardsquare.com/manual/configuration/usage).
diff --git a/blooio-java-client-okhttp/build.gradle.kts b/blooio-java-client-okhttp/build.gradle.kts
index e556e32..a403de3 100644
--- a/blooio-java-client-okhttp/build.gradle.kts
+++ b/blooio-java-client-okhttp/build.gradle.kts
@@ -7,7 +7,6 @@ dependencies {
     api(project(":blooio-java-core"))
 
     implementation("com.squareup.okhttp3:okhttp:4.12.0")
-    implementation("com.squareup.okhttp3:logging-interceptor:4.12.0")
 
     testImplementation(kotlin("test"))
     testImplementation("org.assertj:assertj-core:3.27.7")
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
index 1444f33..ec4fcbc 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClient.kt
@@ -5,6 +5,7 @@ package com.blooio.api.client.okhttp
 import com.blooio.api.client.BlooioClient
 import com.blooio.api.client.BlooioClientImpl
 import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.LogLevel
 import com.blooio.api.core.Sleeper
 import com.blooio.api.core.Timeout
 import com.blooio.api.core.http.Headers
@@ -277,6 +278,15 @@ class BlooioOkHttpClient private constructor() {
          */
         fun maxRetries(maxRetries: Int) = apply { clientOptions.maxRetries(maxRetries) }
 
+        /**
+         * The level at which to log request and response information.
+         *
+         * [fromEnv] will set the level from environment variables. See [LogLevel.fromEnv].
+         *
+         * Defaults to [LogLevel.fromEnv].
+         */
+        fun logLevel(logLevel: LogLevel) = apply { clientOptions.logLevel(logLevel) }
+
         /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { clientOptions.apiKey(apiKey) }
 
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
index 32c3dd2..e11a635 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/BlooioOkHttpClientAsync.kt
@@ -5,6 +5,7 @@ package com.blooio.api.client.okhttp
 import com.blooio.api.client.BlooioClientAsync
 import com.blooio.api.client.BlooioClientAsyncImpl
 import com.blooio.api.core.ClientOptions
+import com.blooio.api.core.LogLevel
 import com.blooio.api.core.Sleeper
 import com.blooio.api.core.Timeout
 import com.blooio.api.core.http.Headers
@@ -277,6 +278,15 @@ class BlooioOkHttpClientAsync private constructor() {
          */
         fun maxRetries(maxRetries: Int) = apply { clientOptions.maxRetries(maxRetries) }
 
+        /**
+         * The level at which to log request and response information.
+         *
+         * [fromEnv] will set the level from environment variables. See [LogLevel.fromEnv].
+         *
+         * Defaults to [LogLevel.fromEnv].
+         */
+        fun logLevel(logLevel: LogLevel) = apply { clientOptions.logLevel(logLevel) }
+
         /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { clientOptions.apiKey(apiKey) }
 
diff --git a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
index 2874c46..7403c9b 100644
--- a/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
+++ b/blooio-java-client-okhttp/src/main/kotlin/com/blooio/api/client/okhttp/OkHttpClient.kt
@@ -35,7 +35,6 @@ import okhttp3.Request
 import okhttp3.RequestBody
 import okhttp3.RequestBody.Companion.toRequestBody
 import okhttp3.Response
-import okhttp3.logging.HttpLoggingInterceptor
 import okio.BufferedSink
 import okio.buffer
 import okio.sink
@@ -93,18 +92,6 @@ internal constructor(@JvmSynthetic internal val okHttpClient: okhttp3.OkHttpClie
     private fun newCall(request: HttpRequest, requestOptions: RequestOptions): Call {
         val clientBuilder = okHttpClient.newBuilder()
 
-        val logLevel =
-            when (System.getenv("BLOOIO_LOG")?.lowercase()) {
-                "info" -> HttpLoggingInterceptor.Level.BASIC
-                "debug" -> HttpLoggingInterceptor.Level.BODY
-                else -> null
-            }
-        if (logLevel != null) {
-            clientBuilder.addNetworkInterceptor(
-                HttpLoggingInterceptor().setLevel(logLevel).apply { redactHeader("Authorization") }
-            )
-        }
-
         requestOptions.timeout?.let {
             clientBuilder
                 .connectTimeout(it.connect())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
index 0c07496..540df33 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/ClientOptions.kt
@@ -4,6 +4,7 @@ package com.blooio.api.core
 
 import com.blooio.api.core.http.Headers
 import com.blooio.api.core.http.HttpClient
+import com.blooio.api.core.http.LoggingHttpClient
 import com.blooio.api.core.http.PhantomReachableClosingHttpClient
 import com.blooio.api.core.http.QueryParams
 import com.blooio.api.core.http.RetryingHttpClient
@@ -96,6 +97,14 @@ private constructor(
      * Defaults to 2.
      */
     @get:JvmName("maxRetries") val maxRetries: Int,
+    /**
+     * The level at which to log request and response information.
+     *
+     * [fromEnv] will set the level from environment variables. See [LogLevel.fromEnv].
+     *
+     * Defaults to [LogLevel.fromEnv].
+     */
+    @get:JvmName("logLevel") val logLevel: LogLevel,
     /** API key authentication. Use your API key as the bearer token. */
     @get:JvmName("apiKey") val apiKey: String,
 ) {
@@ -152,6 +161,7 @@ private constructor(
         private var responseValidation: Boolean = false
         private var timeout: Timeout = Timeout.default()
         private var maxRetries: Int = 2
+        private var logLevel: LogLevel = LogLevel.fromEnv()
         private var apiKey: String? = null
 
         @JvmSynthetic
@@ -167,6 +177,7 @@ private constructor(
             responseValidation = clientOptions.responseValidation
             timeout = clientOptions.timeout
             maxRetries = clientOptions.maxRetries
+            logLevel = clientOptions.logLevel
             apiKey = clientOptions.apiKey
         }
 
@@ -277,6 +288,15 @@ private constructor(
          */
         fun maxRetries(maxRetries: Int) = apply { this.maxRetries = maxRetries }
 
+        /**
+         * The level at which to log request and response information.
+         *
+         * [fromEnv] will set the level from environment variables. See [LogLevel.fromEnv].
+         *
+         * Defaults to [LogLevel.fromEnv].
+         */
+        fun logLevel(logLevel: LogLevel) = apply { this.logLevel = logLevel }
+
         /** API key authentication. Use your API key as the bearer token. */
         fun apiKey(apiKey: String) = apply { this.apiKey = apiKey }
 
@@ -375,6 +395,7 @@ private constructor(
          * System properties take precedence over environment variables.
          */
         fun fromEnv() = apply {
+            logLevel(LogLevel.fromEnv())
             (System.getProperty("blooio.baseUrl") ?: System.getenv("BLOOIO_BASE_URL"))?.let {
                 baseUrl(it)
             }
@@ -431,7 +452,13 @@ private constructor(
             return ClientOptions(
                 httpClient,
                 RetryingHttpClient.builder()
-                    .httpClient(httpClient)
+                    .httpClient(
+                        LoggingHttpClient.builder()
+                            .httpClient(httpClient)
+                            .clock(clock)
+                            .level(logLevel)
+                            .build()
+                    )
                     .sleeper(sleeper)
                     .clock(clock)
                     .maxRetries(maxRetries)
@@ -446,6 +473,7 @@ private constructor(
                 responseValidation,
                 timeout,
                 maxRetries,
+                logLevel,
                 apiKey,
             )
         }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/LogLevel.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/LogLevel.kt
new file mode 100644
index 0000000..b03b996
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/LogLevel.kt
@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.core
+
+/** The level at which to log request and response information. */
+enum class LogLevel {
+    /** No logging. */
+    OFF,
+    /** Minimal request and response summary logs. No headers or bodies are logged. */
+    INFO,
+    /** [INFO] logs plus details about request failures. */
+    ERROR,
+    /**
+     * Full request and response logs. Sensitive headers are redacted, but sensitive data in request
+     * and response bodies may still be visible.
+     */
+    DEBUG;
+
+    /** Returns whether this level is at or higher than the given [level]. */
+    fun shouldLog(level: LogLevel): Boolean = ordinal >= level.ordinal
+
+    companion object {
+
+        /** Returns a [LogLevel] based on the `BLOOIO_LOG` environment variable. */
+        fun fromEnv() =
+            when (System.getenv("BLOOIO_LOG")?.lowercase()) {
+                "info" -> INFO
+                "error" -> ERROR
+                "debug" -> DEBUG
+                else -> OFF
+            }
+    }
+}
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Utils.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Utils.kt
index 2cc7fdd..dde0e91 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/Utils.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/Utils.kt
@@ -5,6 +5,7 @@ package com.blooio.api.core
 import com.blooio.api.errors.BlooioInvalidDataException
 import java.util.Collections
 import java.util.SortedMap
+import java.util.SortedSet
 import java.util.concurrent.CompletableFuture
 import java.util.concurrent.locks.Lock
 
@@ -16,6 +17,11 @@ internal fun <T : Any> T?.getOrThrow(name: String): T =
 internal fun <T> List<T>.toImmutable(): List<T> =
     if (isEmpty()) Collections.emptyList() else Collections.unmodifiableList(toList())
 
+@JvmSynthetic
+internal fun <V : Comparable<V>> SortedSet<V>.toImmutable(): SortedSet<V> =
+    if (isEmpty()) Collections.emptySortedSet()
+    else Collections.unmodifiableSortedSet(toSortedSet(comparator() ?: Comparator.naturalOrder()))
+
 @JvmSynthetic
 internal fun <K, V> Map<K, V>.toImmutable(): Map<K, V> =
     if (isEmpty()) immutableEmptyMap() else Collections.unmodifiableMap(toMap())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
new file mode 100644
index 0000000..291e3ff
--- /dev/null
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
@@ -0,0 +1,627 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.core.http
+
+import com.blooio.api.core.LogLevel
+import com.blooio.api.core.RequestOptions
+import com.blooio.api.core.checkRequired
+import com.blooio.api.core.toImmutable
+import java.io.ByteArrayOutputStream
+import java.io.InputStream
+import java.io.OutputStream
+import java.nio.ByteBuffer
+import java.nio.charset.CharacterCodingException
+import java.nio.charset.Charset
+import java.nio.charset.CharsetDecoder
+import java.nio.charset.CodingErrorAction
+import java.nio.charset.StandardCharsets
+import java.time.Clock
+import java.time.Duration
+import java.time.OffsetDateTime
+import java.util.SortedSet
+import java.util.concurrent.CompletableFuture
+import java.util.concurrent.CompletionException
+import kotlin.time.toKotlinDuration
+
+/** A wrapper [HttpClient] around [httpClient] that logs request and response information. */
+class LoggingHttpClient
+private constructor(
+    /** The underlying [HttpClient] for making requests. */
+    @get:JvmName("httpClient") val httpClient: HttpClient,
+    /**
+     * Sensitive headers to redact from logs.
+     *
+     * Defaults to `Set.of("Authorization")`.
+     */
+    @get:JvmName("redactedHeaders") val redactedHeaders: SortedSet<String>,
+    /**
+     * The clock to use for measuring request and response durations.
+     *
+     * This is primarily useful for using a fake clock in tests.
+     *
+     * Defaults to [Clock.systemUTC].
+     */
+    @get:JvmName("clock") val clock: Clock,
+    /**
+     * The log level to use.
+     *
+     * Pass [LogLevel.fromEnv] to read from environment variables.
+     */
+    @get:JvmName("level") val level: LogLevel,
+) : HttpClient {
+
+    override fun execute(request: HttpRequest, requestOptions: RequestOptions): HttpResponse {
+        val loggingRequest = logRequest(request)
+
+        val before = OffsetDateTime.now(clock)
+        val response =
+            try {
+                httpClient.execute(loggingRequest, requestOptions)
+            } catch (e: Throwable) {
+                logFailure(e, Duration.between(before, OffsetDateTime.now(clock)))
+                throw e
+            }
+
+        val took = Duration.between(before, OffsetDateTime.now(clock))
+        return logResponse(response, took)
+    }
+
+    override fun executeAsync(
+        request: HttpRequest,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<HttpResponse> {
+        val loggingRequest = logRequest(request)
+
+        val before = OffsetDateTime.now(clock)
+        val future =
+            try {
+                httpClient.executeAsync(loggingRequest, requestOptions)
+            } catch (e: Throwable) {
+                logFailure(e, Duration.between(before, OffsetDateTime.now(clock)))
+                throw e
+            }
+        return future.handle { response, error ->
+            val took = Duration.between(before, OffsetDateTime.now(clock))
+            if (error != null) {
+                logFailure(unwrapCompletionException(error), took)
+                throw error
+            }
+            logResponse(response, took)
+        }
+    }
+
+    private fun logRequest(request: HttpRequest): HttpRequest {
+        if (!level.shouldLog(LogLevel.INFO)) {
+            return request
+        }
+
+        System.err.println(
+            buildString {
+                append("--> ${request.method} ${request.url()}")
+                request.body?.let {
+                    val length = it.contentLength()
+                    append(if (length >= 0) " ($length-byte body)" else " (unknown-length body)")
+                }
+            }
+        )
+
+        if (!level.shouldLog(LogLevel.DEBUG)) {
+            return request
+        }
+
+        logHeaders(request.headers)
+
+        if (request.body == null) {
+            System.err.println("--> END ${request.method}")
+            System.err.println()
+            return request
+        }
+
+        return request
+            .toBuilder()
+            .body(LoggingHttpRequestBody(request.method, request.body))
+            .build()
+    }
+
+    private fun logResponse(response: HttpResponse, took: Duration): HttpResponse {
+        if (!level.shouldLog(LogLevel.INFO)) {
+            return response
+        }
+
+        val contentLength = response.headers().values("Content-Length").firstOrNull()?.toIntOrNull()
+        System.err.println(
+            "<-- ${response.statusCode()} (${
+                buildString {
+                    append(took.format())
+                    contentLength?.let { append(", $contentLength-byte body") }
+                }
+            })"
+        )
+
+        if (!level.shouldLog(LogLevel.DEBUG)) {
+            return response
+        }
+
+        logHeaders(response.headers())
+        return LoggingHttpResponse(response)
+    }
+
+    private fun logFailure(error: Throwable, took: Duration) {
+        if (!level.shouldLog(LogLevel.ERROR)) {
+            return
+        }
+
+        System.err.println(
+            buildString {
+                append("<-- !! ${error.javaClass.simpleName}")
+                error.message?.let { append(": $it") }
+                append(" (${took.format()})")
+            }
+        )
+    }
+
+    private fun unwrapCompletionException(error: Throwable): Throwable =
+        if (error is CompletionException && error.cause != null) error.cause!! else error
+
+    private fun logHeaders(headers: Headers) =
+        headers.names().forEach { name ->
+            headers.values(name).forEach { value ->
+                System.err.println("$name: ${if (redactedHeaders.contains(name)) "██" else value}")
+            }
+        }
+
+    override fun close() = httpClient.close()
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [LoggingHttpClient].
+         *
+         * The following fields are required:
+         * ```java
+         * .httpClient()
+         * .level()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [LoggingHttpClient]. */
+    class Builder internal constructor() {
+
+        private var httpClient: HttpClient? = null
+        private var redactedHeaders: Set<String> = setOf("Authorization")
+        private var clock: Clock = Clock.systemUTC()
+        private var level: LogLevel? = null
+
+        @JvmSynthetic
+        internal fun from(loggingHttpClient: LoggingHttpClient) = apply {
+            httpClient = loggingHttpClient.httpClient
+            redactedHeaders = loggingHttpClient.redactedHeaders
+            clock = loggingHttpClient.clock
+            level = loggingHttpClient.level
+        }
+
+        /** The underlying [HttpClient] for making requests. */
+        fun httpClient(httpClient: HttpClient) = apply { this.httpClient = httpClient }
+
+        /**
+         * Sensitive headers to redact from logs.
+         *
+         * Defaults to `Set.of("Authorization")`.
+         */
+        fun redactedHeaders(redactedHeaders: Set<String>) = apply {
+            this.redactedHeaders = redactedHeaders
+        }
+
+        /**
+         * The clock to use for measuring request and response durations.
+         *
+         * This is primarily useful for using a fake clock in tests.
+         *
+         * Defaults to [Clock.systemUTC].
+         */
+        fun clock(clock: Clock) = apply { this.clock = clock }
+
+        /**
+         * The log level to use.
+         *
+         * Pass [LogLevel.fromEnv] to read from environment variables.
+         */
+        fun level(level: LogLevel) = apply { this.level = level }
+
+        /**
+         * Returns an immutable instance of [LoggingHttpClient].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .httpClient()
+         * .level()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): LoggingHttpClient =
+            LoggingHttpClient(
+                checkRequired("httpClient", httpClient),
+                redactedHeaders.toSortedSet(String.CASE_INSENSITIVE_ORDER).toImmutable(),
+                clock,
+                checkRequired("level", level),
+            )
+    }
+}
+
+/**
+ * An [HttpRequestBody] wrapper that delegates to [body] while also logging line by line as it's
+ * written.
+ *
+ * The logging occurs in a streaming manner with minimal buffering.
+ */
+private class LoggingHttpRequestBody(
+    private val method: HttpMethod,
+    private val body: HttpRequestBody,
+) : HttpRequestBody {
+
+    private val charset by lazy { parseCharset(body.contentType()) }
+
+    override fun writeTo(outputStream: OutputStream) {
+        val loggingOutputStream = LoggingOutputStream(outputStream, charset)
+        body.writeTo(loggingOutputStream)
+
+        loggingOutputStream.flush()
+        System.err.println("--> END $method (${loggingOutputStream.writeCount()}-byte body)")
+        System.err.println()
+    }
+
+    override fun contentType(): String? = body.contentType()
+
+    override fun contentLength(): Long = body.contentLength()
+
+    override fun repeatable(): Boolean = body.repeatable()
+
+    override fun close() = body.close()
+}
+
+/**
+ * An [OutputStream] wrapper that delegates to [outputStream] while also logging bytes line by line
+ * as it's written to.
+ *
+ * The written content is assumed to be in the given [charset] and the logging occurs in a streaming
+ * manner with minimal buffering.
+ */
+private class LoggingOutputStream(private val outputStream: OutputStream, charset: Charset?) :
+    OutputStream() {
+
+    private val buffer = LoggingBuffer(charset)
+
+    fun writeCount() = buffer.writeCount()
+
+    override fun write(b: Int) {
+        outputStream.write(b)
+        buffer.write(b)
+    }
+
+    override fun write(b: ByteArray, off: Int, len: Int) {
+        outputStream.write(b, off, len)
+        for (i in off until off + len) {
+            buffer.write(b[i].toInt() and 0xFF)
+        }
+    }
+
+    /** Prints any currently buffered content. */
+    override fun flush() {
+        buffer.flush()
+        outputStream.flush()
+    }
+
+    override fun close() = outputStream.close()
+}
+
+/**
+ * An [HttpResponse] wrapper that delegates to [response] while also logging line-by-line as it's
+ * read.
+ *
+ * The logging occurs in a streaming manner with minimal buffering.
+ */
+private class LoggingHttpResponse(private val response: HttpResponse) : HttpResponse {
+
+    private val loggingBody: Lazy<InputStream> = lazy {
+        LoggingInputStream(
+            response.body(),
+            parseCharset(response.headers().values("Content-Type").firstOrNull()),
+        )
+    }
+
+    override fun statusCode(): Int = response.statusCode()
+
+    override fun headers(): Headers = response.headers()
+
+    override fun body(): InputStream = loggingBody.value
+
+    override fun close() {
+        if (loggingBody.isInitialized()) {
+            loggingBody.value.close()
+        }
+        response.close()
+    }
+}
+
+/**
+ * An [InputStream] wrapper that delegates to [inputStream] while also logging bytes line by line as
+ * it's read.
+ *
+ * The contents of [inputStream] are assumed to be in the given [charset] and the logging occurs in
+ * a streaming manner with minimal buffering.
+ */
+private class LoggingInputStream(private val inputStream: InputStream, charset: Charset?) :
+    InputStream() {
+
+    private var isDone = false
+    private val buffer = LoggingBuffer(charset)
+
+    override fun read(): Int {
+        if (isDone) {
+            return -1
+        }
+
+        val b = inputStream.read()
+
+        if (b == -1) {
+            markDone()
+            return b
+        }
+
+        buffer.write(b)
+        return b
+    }
+
+    override fun read(b: ByteArray, off: Int, len: Int): Int {
+        if (isDone) {
+            return -1
+        }
+
+        val bytesRead = inputStream.read(b, off, len)
+
+        if (bytesRead == -1) {
+            markDone()
+            return bytesRead
+        }
+
+        for (i in off until off + bytesRead) {
+            buffer.write(b[i].toInt() and 0xFF)
+        }
+        return bytesRead
+    }
+
+    override fun close() {
+        if (!isDone) {
+            markDone(closedEarly = true)
+        }
+        inputStream.close()
+    }
+
+    private fun markDone(closedEarly: Boolean = false) {
+        isDone = true
+        buffer.flush()
+        val suffix = if (closedEarly) ", closed early" else ""
+        System.err.println("<-- END HTTP (${buffer.writeCount()}-byte body$suffix)")
+        System.err.println()
+    }
+}
+
+/**
+ * A byte buffer that prints line by line, using the given [charset], as bytes are written to it.
+ *
+ * When [charset] is `null`, the buffer performs an upfront check to detect binary content. If
+ * non-whitespace ISO control characters are found in the first [PROBABLY_UTF8_CODE_POINT_LIMIT]
+ * code points, body logging is suppressed entirely.
+ */
+private class LoggingBuffer(charset: Charset?) {
+
+    private val charset = charset ?: StandardCharsets.UTF_8
+
+    private val decoder: CharsetDecoder =
+        this.charset
+            .newDecoder()
+            .onMalformedInput(CodingErrorAction.REPORT)
+            .onUnmappableCharacter(CodingErrorAction.REPORT)
+    private var writeCount = 0
+    private val buffer = ByteArrayOutputStream(128)
+
+    /**
+     * Whether logging has been suppressed because the content doesn't appear to be readable text.
+     *
+     * This is only set when [charset] is `null` and the content fails the [isProbablyUtf8] check.
+     */
+    private var suppressed = false
+
+    /**
+     * Bytes accumulated for the [isProbablyUtf8] check before any lines are printed.
+     *
+     * Once the check passes (or [charset] is non-null), this is set to `null` and bytes flow
+     * directly to [buffer].
+     */
+    private var prefetchBuffer: ByteArrayOutputStream? =
+        if (charset != null) null else ByteArrayOutputStream(128)
+
+    fun writeCount() = writeCount
+
+    fun write(b: Int) {
+        if (writeCount == 0) {
+            // Print a newline before we start printing anything to separate the printed content
+            // from previous content.
+            System.err.println()
+        }
+
+        writeCount++
+
+        if (suppressed) {
+            return
+        }
+
+        val prefetch = prefetchBuffer
+        if (prefetch != null) {
+            prefetch.write(b)
+            // Continue accumulating until we have enough bytes to decide.
+            if (prefetch.size() < PROBABLY_UTF8_BYTE_LIMIT && b != '\n'.code) {
+                return
+            }
+            // We have enough bytes. Check if the content is probably UTF-8.
+            prefetchBuffer = null
+            val bytes = prefetch.toByteArray()
+            if (!isProbablyUtf8(bytes)) {
+                suppressed = true
+                System.err.println("(binary body omitted)")
+                return
+            }
+            // Content looks like UTF-8. Feed the accumulated bytes into the normal buffer.
+            for (byte in bytes) {
+                writeToBuffer(byte.toInt() and 0xFF)
+            }
+            return
+        }
+
+        writeToBuffer(b)
+    }
+
+    private fun writeToBuffer(b: Int) {
+        if (b == '\n'.code) {
+            flush()
+            return
+        }
+
+        buffer.write(b)
+    }
+
+    /** Prints any currently buffered content. */
+    fun flush() {
+        if (suppressed) {
+            return
+        }
+
+        // If we still have a prefetch buffer when flush is called (body was shorter than the
+        // limit), run the check now.
+        val prefetch = prefetchBuffer
+        if (prefetch != null) {
+            prefetchBuffer = null
+            val bytes = prefetch.toByteArray()
+            if (bytes.isEmpty()) {
+                return
+            }
+            if (!isProbablyUtf8(bytes)) {
+                suppressed = true
+                System.err.println("(binary body omitted)")
+                return
+            }
+            for (byte in bytes) {
+                writeToBuffer(byte.toInt() and 0xFF)
+            }
+        }
+
+        if (buffer.size() == 0) {
+            return
+        }
+
+        val line =
+            try {
+                decoder.decode(ByteBuffer.wrap(buffer.toByteArray()))
+            } catch (e: CharacterCodingException) {
+                "(omitted line is not valid $charset)"
+            }
+        buffer.reset()
+        System.err.println(line)
+    }
+}
+
+/** The maximum number of code points to sample when checking if content is probably UTF-8. */
+private const val PROBABLY_UTF8_CODE_POINT_LIMIT = 64
+
+/**
+ * The maximum number of bytes to accumulate before running the [isProbablyUtf8] check. UTF-8 code
+ * points are at most 4 bytes, so this accommodates [PROBABLY_UTF8_CODE_POINT_LIMIT] code points.
+ */
+private const val PROBABLY_UTF8_BYTE_LIMIT = PROBABLY_UTF8_CODE_POINT_LIMIT * 4
+
+/**
+ * Returns `true` if the given [bytes] probably contain human-readable UTF-8 text.
+ *
+ * Decodes up to [PROBABLY_UTF8_CODE_POINT_LIMIT] code points and returns `false` if any
+ * non-whitespace ISO control characters are found, or if the bytes are not valid UTF-8.
+ */
+private fun isProbablyUtf8(bytes: ByteArray): Boolean {
+    try {
+        val decoder =
+            StandardCharsets.UTF_8.newDecoder()
+                .onMalformedInput(CodingErrorAction.REPORT)
+                .onUnmappableCharacter(CodingErrorAction.REPORT)
+        val charBuffer = decoder.decode(ByteBuffer.wrap(bytes))
+        var codePointCount = 0
+        var i = 0
+        while (i < charBuffer.length && codePointCount < PROBABLY_UTF8_CODE_POINT_LIMIT) {
+            val codePoint = Character.codePointAt(charBuffer, i)
+            if (Character.isISOControl(codePoint) && !Character.isWhitespace(codePoint)) {
+                return false
+            }
+            i += Character.charCount(codePoint)
+            codePointCount++
+        }
+        return true
+    } catch (e: CharacterCodingException) {
+        return false
+    }
+}
+
+/** Returns the [Charset] in the given [contentType] string, or `null` if unspecified. */
+private fun parseCharset(contentType: String?): Charset? =
+    contentType
+        ?.split(";")
+        ?.drop(1)
+        ?.map { it.trim() }
+        ?.firstOrNull { it.startsWith("charset=", ignoreCase = true) }
+        ?.substringAfter("=")
+        ?.trim()
+        ?.removeSurrounding("\"")
+        ?.let { runCatching { charset(it) }.getOrNull() }
+
+/** Formats the [Duration] into a string like "1m 40s 467ms". */
+private fun Duration.format(): String =
+    toKotlinDuration().toComponents { days, hours, minutes, seconds, nanoseconds ->
+        buildString {
+            val milliseconds = nanoseconds / 1_000_000
+            if (days > 0) {
+                append("${days}d")
+            }
+            if (hours > 0) {
+                if (isNotEmpty()) {
+                    append(" ")
+                }
+                append("${hours}h")
+            }
+            if (minutes > 0) {
+                if (isNotEmpty()) {
+                    append(" ")
+                }
+                append("${minutes}m")
+            }
+            if (seconds > 0) {
+                if (isNotEmpty()) {
+                    append(" ")
+                }
+                append("${seconds}s")
+            }
+            if (milliseconds > 0) {
+                if (isNotEmpty()) {
+                    append(" ")
+                }
+                append("${milliseconds}ms")
+            }
+
+            if (isEmpty()) {
+                append("0s")
+            }
+        }
+    }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt
new file mode 100644
index 0000000..c415808
--- /dev/null
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt
@@ -0,0 +1,999 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.blooio.api.core.http
+
+import com.blooio.api.core.LogLevel
+import com.blooio.api.core.RequestOptions
+import java.io.ByteArrayInputStream
+import java.io.ByteArrayOutputStream
+import java.io.IOException
+import java.io.InputStream
+import java.io.OutputStream
+import java.io.PrintStream
+import java.nio.charset.StandardCharsets
+import java.time.Clock
+import java.time.Instant
+import java.time.ZoneOffset
+import java.util.concurrent.CompletableFuture
+import org.assertj.core.api.Assertions.assertThat
+import org.assertj.core.api.Assertions.assertThatThrownBy
+import org.junit.jupiter.api.AfterEach
+import org.junit.jupiter.api.BeforeEach
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.parallel.ResourceLock
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.ValueSource
+
+@ResourceLock("stderr")
+internal class LoggingHttpClientTest {
+
+    private lateinit var originalErr: PrintStream
+    private lateinit var errContent: ByteArrayOutputStream
+
+    @BeforeEach
+    fun beforeEach() {
+        originalErr = System.err
+        errContent = ByteArrayOutputStream()
+        System.setErr(PrintStream(errContent))
+    }
+
+    @AfterEach
+    fun afterEach() {
+        System.setErr(originalErr)
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun offLevel_noOutput(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.OFF)
+
+        val response = client.execute(simpleGetRequest(), async).apply { body().readBytes() }
+
+        assertThat(response.statusCode()).isEqualTo(200)
+        assertThat(stderrOutput()).isEmpty()
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_logsGetRequest(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.INFO)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- 200 (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_logsPostRequestWithBodySize(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.INFO)
+
+        client.execute(postRequestWithBody("""{"key":"value"}"""), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> POST https://api.example.com/v1/resources (15-byte body)
+                |<-- 200 (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_logsRequestWithUnknownLengthBody(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.INFO)
+
+        client
+            .execute(postRequestWithBody("""{"key":"value"}""", contentLength = -1L), async)
+            .body()
+            .readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> POST https://api.example.com/v1/resources (unknown-length body)
+                |<-- 200 (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_logsResponseStatusAndDuration(async: Boolean) {
+        val clock =
+            clockFrom(
+                Instant.parse("1998-04-21T00:00:00Z"),
+                Instant.parse("1998-04-21T00:00:01.234Z"),
+            )
+        val client = loggingClient(fakeHttpClient(statusCode = 201), LogLevel.INFO, clock)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- 201 (1s 234ms)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_logsResponseContentLength(async: Boolean) {
+        val headers =
+            Headers.builder().put("Content-Length", "42").put("Content-Type", "text/plain").build()
+        val client = loggingClient(fakeHttpClient(responseHeaders = headers), LogLevel.INFO)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- 200 (0s, 42-byte body)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_doesNotLogHeaders(async: Boolean) {
+        val headers = Headers.builder().put("X-Custom", "visible").build()
+        val client = loggingClient(fakeHttpClient(responseHeaders = headers), LogLevel.INFO)
+
+        client
+            .execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl("https://api.example.com")
+                    .addPathSegment("v1")
+                    .putHeader("X-Request-Custom", "req-value")
+                    .build(),
+                async,
+            )
+            .body()
+            .readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1
+                |<-- 200 (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsGetWithEndMarker(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.DEBUG)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsRequestAndResponseHeaders(async: Boolean) {
+        val responseHeaders =
+            Headers.builder()
+                .put("X-Response-Id", "abc-123")
+                .put("Content-Type", "text/plain")
+                .build()
+        val client =
+            loggingClient(fakeHttpClient(responseHeaders = responseHeaders), LogLevel.DEBUG)
+
+        client
+            .execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl("https://api.example.com")
+                    .addPathSegment("test")
+                    .putHeader("X-Custom", "my-value")
+                    .build(),
+                async,
+            )
+            .body()
+            .readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/test
+                |X-Custom: my-value
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: text/plain
+                |X-Response-Id: abc-123
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_redactsSensitiveHeaders(async: Boolean) {
+        val client =
+            loggingClient(
+                fakeHttpClient(),
+                LogLevel.DEBUG,
+                redactedHeaders = setOf("Authorization", "X-Secret"),
+            )
+
+        client
+            .execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl("https://api.example.com")
+                    .addPathSegment("test")
+                    .putHeader("Authorization", "Bearer token-123")
+                    .putHeader("X-Secret", "secret-value")
+                    .putHeader("X-Public", "public-value")
+                    .build(),
+                async,
+            )
+            .body()
+            .readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/test
+                |Authorization: ██
+                |X-Public: public-value
+                |X-Secret: ██
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_redactsHeadersCaseInsensitively(async: Boolean) {
+        val client =
+            loggingClient(
+                fakeHttpClient(),
+                LogLevel.DEBUG,
+                redactedHeaders = setOf("Authorization"),
+            )
+
+        client
+            .execute(
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl("https://api.example.com")
+                    .addPathSegment("test")
+                    .putHeader("authorization", "Bearer secret")
+                    .build(),
+                async,
+            )
+            .body()
+            .readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/test
+                |authorization: ██
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsRequestBody(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.DEBUG)
+        val body = """{"name":"test","value":42}"""
+
+        client.execute(postRequestWithBody(body), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> POST https://api.example.com/v1/resources (26-byte body)
+                |
+                |{"name":"test","value":42}
+                |--> END POST (26-byte body)
+                |
+                |<-- 200 (0s)
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsResponseBody(async: Boolean) {
+        val responseBody = """{"id":1,"status":"ok"}"""
+        val headers = Headers.builder().put("Content-Type", "application/json").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        val response = client.execute(simpleGetRequest(), async)
+        val body = response.body().readBytes().toString(StandardCharsets.UTF_8)
+
+        assertThat(body).isEqualTo(responseBody)
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: application/json
+                |
+                |{"id":1,"status":"ok"}
+                |<-- END HTTP (22-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsBinaryResponseBodyAsOmitted(async: Boolean) {
+        val binaryBody = ByteArray(256) { it.toByte() }
+        val client = loggingClient(fakeHttpClient(responseBody = binaryBody), LogLevel.DEBUG)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |
+                |(binary body omitted)
+                |<-- END HTTP (256-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsMultilineResponseBody(async: Boolean) {
+        val multilineBody = "line1\nline2\nline3"
+        val headers = Headers.builder().put("Content-Type", "text/plain; charset=utf-8").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = multilineBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: text/plain; charset=utf-8
+                |
+                |line1
+                |line2
+                |line3
+                |<-- END HTTP (17-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsResponseBodyWithExplicitCharset(async: Boolean) {
+        val responseBody = "héllo wörld"
+        val headers = Headers.builder().put("Content-Type", "text/plain; charset=utf-8").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: text/plain; charset=utf-8
+                |
+                |héllo wörld
+                |<-- END HTTP (13-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsResponseBodyWithNoContentType(async: Boolean) {
+        val responseBody = "plain text body"
+        val client =
+            loggingClient(
+                fakeHttpClient(responseBody = responseBody.toByteArray(StandardCharsets.UTF_8)),
+                LogLevel.DEBUG,
+            )
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |
+                |plain text body
+                |<-- END HTTP (15-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsEmptyResponseBody(async: Boolean) {
+        val client = loggingClient(fakeHttpClient(), LogLevel.DEBUG)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |<-- END HTTP (0-byte body)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsEndHttpMarkerOnEarlyClose(async: Boolean) {
+        val responseBody = """{"id":1,"status":"ok"}"""
+        val headers = Headers.builder().put("Content-Type", "application/json").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        val body = client.execute(simpleGetRequest(), async).body()
+        body.read(ByteArray(5))
+        body.close()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: application/json
+                |
+                |{"id"
+                |<-- END HTTP (5-byte body, closed early)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsEndHttpMarkerOnCloseWithoutReading(async: Boolean) {
+        val responseBody = """{"id":1,"status":"ok"}"""
+        val headers = Headers.builder().put("Content-Type", "application/json").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        client.execute(simpleGetRequest(), async).body().close()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: application/json
+                |<-- END HTTP (0-byte body, closed early)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsEndHttpMarkerWhenResponseClosedAfterPartialRead(async: Boolean) {
+        val responseBody = """{"id":1,"status":"ok"}"""
+        val headers = Headers.builder().put("Content-Type", "application/json").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        val response = client.execute(simpleGetRequest(), async)
+        response.body().read(ByteArray(5))
+        response.close()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: application/json
+                |
+                |{"id"
+                |<-- END HTTP (5-byte body, closed early)
+                |
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_doesNotLogEndHttpMarkerWhenResponseClosedWithoutBodyAccess(async: Boolean) {
+        val responseBody = """{"id":1,"status":"ok"}"""
+        val headers = Headers.builder().put("Content-Type", "application/json").build()
+        val client =
+            loggingClient(
+                fakeHttpClient(
+                    responseHeaders = headers,
+                    responseBody = responseBody.toByteArray(StandardCharsets.UTF_8),
+                ),
+                LogLevel.DEBUG,
+            )
+
+        client.execute(simpleGetRequest(), async).close()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- 200 (0s)
+                |Content-Type: application/json
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun errorLevel_logsRequestFailure(async: Boolean) {
+        val clock =
+            clockFrom(
+                Instant.parse("1998-04-21T00:00:00Z"),
+                Instant.parse("1998-04-21T00:00:01.234Z"),
+            )
+        val client =
+            loggingClient(
+                failingHttpClient(IOException("Connection refused")),
+                LogLevel.ERROR,
+                clock,
+            )
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async) }
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- !! IOException: Connection refused (1s 234ms)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun infoLevel_doesNotLogRequestFailure(async: Boolean) {
+        val client =
+            loggingClient(failingHttpClient(IOException("Connection refused")), LogLevel.INFO)
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async) }
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun debugLevel_logsRequestFailureAfterHeaders(async: Boolean) {
+        val client =
+            loggingClient(failingHttpClient(IOException("Connection refused")), LogLevel.DEBUG)
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async) }
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |--> END GET
+                |
+                |<-- !! IOException: Connection refused (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun errorLevel_logsRequestFailureWithoutMessage(async: Boolean) {
+        val client = loggingClient(failingHttpClient(IOException()), LogLevel.ERROR)
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async) }
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- !! IOException (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun offLevel_doesNotLogRequestFailure(async: Boolean) {
+        val client =
+            loggingClient(failingHttpClient(IOException("Connection refused")), LogLevel.OFF)
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async) }
+
+        assertThat(stderrOutput()).isEmpty()
+    }
+
+    @Test
+    fun errorLevel_logsExecuteAsyncSynchronousThrow() {
+        val error = IOException("Connection refused")
+        val client =
+            loggingClient(
+                object : HttpClient {
+                    override fun execute(
+                        request: HttpRequest,
+                        requestOptions: RequestOptions,
+                    ): HttpResponse = throw UnsupportedOperationException()
+
+                    override fun executeAsync(
+                        request: HttpRequest,
+                        requestOptions: RequestOptions,
+                    ): CompletableFuture<HttpResponse> = throw error
+
+                    override fun close() {}
+                },
+                LogLevel.ERROR,
+            )
+
+        assertThatThrownBy { client.execute(simpleGetRequest(), async = true) }.isSameAs(error)
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- !! IOException: Connection refused (0s)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun durationFormat_seconds(async: Boolean) {
+        val clock =
+            clockFrom(
+                Instant.parse("1998-04-21T00:00:00Z"),
+                Instant.parse("1998-04-21T00:00:02.500Z"),
+            )
+        val client = loggingClient(fakeHttpClient(), LogLevel.INFO, clock)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- 200 (2s 500ms)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @ParameterizedTest
+    @ValueSource(booleans = [false, true])
+    fun durationFormat_minutesAndSeconds(async: Boolean) {
+        val clock =
+            clockFrom(
+                Instant.parse("1998-04-21T00:00:00Z"),
+                Instant.parse("1998-04-21T00:01:40.467Z"),
+            )
+        val client = loggingClient(fakeHttpClient(), LogLevel.INFO, clock)
+
+        client.execute(simpleGetRequest(), async).body().readBytes()
+
+        assertThat(stderrOutput())
+            .isEqualTo(
+                """
+                |--> GET https://api.example.com/v1/resources
+                |<-- 200 (1m 40s 467ms)
+                |"""
+                    .trimMargin()
+            )
+    }
+
+    @Test
+    fun builder_toBuilder_roundtrips() {
+        val delegate = fakeHttpClient()
+        val clock = Clock.fixed(Instant.parse("1998-04-21T00:00:00Z"), ZoneOffset.UTC)
+        val client =
+            LoggingHttpClient.builder()
+                .httpClient(delegate)
+                .level(LogLevel.DEBUG)
+                .redactedHeaders(setOf("X-Secret"))
+                .clock(clock)
+                .build()
+
+        val rebuilt = client.toBuilder().build()
+
+        assertThat(rebuilt.httpClient).isSameAs(delegate)
+        assertThat(rebuilt.level).isEqualTo(LogLevel.DEBUG)
+        assertThat(rebuilt.redactedHeaders).containsExactly("X-Secret")
+        assertThat(rebuilt.clock).isEqualTo(clock)
+    }
+
+    @Test
+    fun close_delegatesToUnderlyingClient() {
+        var closed = false
+        val delegate =
+            object : HttpClient {
+                override fun execute(
+                    request: HttpRequest,
+                    requestOptions: RequestOptions,
+                ): HttpResponse = throw UnsupportedOperationException()
+
+                override fun executeAsync(
+                    request: HttpRequest,
+                    requestOptions: RequestOptions,
+                ): CompletableFuture<HttpResponse> = throw UnsupportedOperationException()
+
+                override fun close() {
+                    closed = true
+                }
+            }
+        val client = loggingClient(delegate, LogLevel.OFF)
+
+        client.close()
+
+        assertThat(closed).isTrue()
+    }
+
+    private fun stderrOutput(): String = errContent.toString("UTF-8")
+
+    private fun loggingClient(
+        httpClient: HttpClient,
+        level: LogLevel,
+        clock: Clock = clockFrom(Instant.parse("1998-04-21T00:00:00Z")),
+        redactedHeaders: Set<String> = setOf("Authorization"),
+    ): LoggingHttpClient =
+        LoggingHttpClient.builder()
+            .httpClient(httpClient)
+            .level(level)
+            .clock(clock)
+            .redactedHeaders(redactedHeaders)
+            .build()
+
+    private fun simpleGetRequest(): HttpRequest =
+        HttpRequest.builder()
+            .method(HttpMethod.GET)
+            .baseUrl("https://api.example.com")
+            .addPathSegment("v1")
+            .addPathSegment("resources")
+            .build()
+
+    private fun postRequestWithBody(
+        body: String,
+        contentType: String = "application/json",
+        contentLength: Long? = null,
+    ): HttpRequest =
+        HttpRequest.builder()
+            .method(HttpMethod.POST)
+            .baseUrl("https://api.example.com")
+            .addPathSegment("v1")
+            .addPathSegment("resources")
+            .body(
+                object : HttpRequestBody {
+                    private val bytes = body.toByteArray(StandardCharsets.UTF_8)
+
+                    override fun writeTo(outputStream: OutputStream) {
+                        outputStream.write(bytes)
+                    }
+
+                    override fun contentType(): String = contentType
+
+                    override fun contentLength(): Long = contentLength ?: bytes.size.toLong()
+
+                    override fun repeatable(): Boolean = true
+
+                    override fun close() {}
+                }
+            )
+            .build()
+
+    private fun fakeHttpClient(
+        statusCode: Int = 200,
+        responseHeaders: Headers = Headers.builder().build(),
+        responseBody: ByteArray = ByteArray(0),
+    ): HttpClient =
+        object : HttpClient {
+            override fun execute(
+                request: HttpRequest,
+                requestOptions: RequestOptions,
+            ): HttpResponse {
+                // Consume the request body if present to trigger logging.
+                request.body?.let {
+                    val out = ByteArrayOutputStream()
+                    it.writeTo(out)
+                }
+                return fakeResponse(statusCode, responseHeaders, responseBody)
+            }
+
+            override fun executeAsync(
+                request: HttpRequest,
+                requestOptions: RequestOptions,
+            ): CompletableFuture<HttpResponse> =
+                CompletableFuture.completedFuture(execute(request, requestOptions))
+
+            override fun close() {}
+        }
+
+    private fun failingHttpClient(error: Throwable): HttpClient =
+        object : HttpClient {
+            override fun execute(
+                request: HttpRequest,
+                requestOptions: RequestOptions,
+            ): HttpResponse {
+                request.body?.let {
+                    val out = ByteArrayOutputStream()
+                    it.writeTo(out)
+                }
+                throw error
+            }
+
+            override fun executeAsync(
+                request: HttpRequest,
+                requestOptions: RequestOptions,
+            ): CompletableFuture<HttpResponse> {
+                val future = CompletableFuture<HttpResponse>()
+                future.completeExceptionally(error)
+                return future
+            }
+
+            override fun close() {}
+        }
+
+    private fun fakeResponse(statusCode: Int, headers: Headers, body: ByteArray): HttpResponse =
+        object : HttpResponse {
+            override fun statusCode(): Int = statusCode
+
+            override fun headers(): Headers = headers
+
+            override fun body(): InputStream = ByteArrayInputStream(body)
+
+            override fun close() {}
+        }
+
+    private fun clockFrom(vararg instants: Instant): Clock =
+        object : Clock() {
+            private var index = 0
+
+            override fun getZone() = ZoneOffset.UTC
+
+            override fun withZone(zone: java.time.ZoneId?) = this
+
+            override fun instant(): Instant {
+                val instant = instants[index % instants.size]
+                index++
+                return instant
+            }
+        }
+
+    private fun HttpClient.execute(request: HttpRequest, async: Boolean): HttpResponse =
+        if (async) executeAsync(request).get() else execute(request)
+}

From e7c56e6299d79215ca5495603e92df1b358af702 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 8 May 2026 02:00:20 +0000
Subject: [PATCH 43/63] chore: redact api-key headers in debug logs

---
 .../kotlin/com/blooio/api/core/http/LoggingHttpClient.kt   | 7 ++++---
 .../com/blooio/api/core/http/LoggingHttpClientTest.kt      | 3 ++-
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
index 291e3ff..727d765 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/core/http/LoggingHttpClient.kt
@@ -31,7 +31,7 @@ private constructor(
     /**
      * Sensitive headers to redact from logs.
      *
-     * Defaults to `Set.of("Authorization")`.
+     * Defaults to `Set.of("authorization", "api-key", "x-api-key", "cookie", "set-cookie")`.
      */
     @get:JvmName("redactedHeaders") val redactedHeaders: SortedSet<String>,
     /**
@@ -192,7 +192,8 @@ private constructor(
     class Builder internal constructor() {
 
         private var httpClient: HttpClient? = null
-        private var redactedHeaders: Set<String> = setOf("Authorization")
+        private var redactedHeaders: Set<String> =
+            setOf("authorization", "api-key", "x-api-key", "cookie", "set-cookie")
         private var clock: Clock = Clock.systemUTC()
         private var level: LogLevel? = null
 
@@ -210,7 +211,7 @@ private constructor(
         /**
          * Sensitive headers to redact from logs.
          *
-         * Defaults to `Set.of("Authorization")`.
+         * Defaults to `Set.of("authorization", "api-key", "x-api-key", "cookie", "set-cookie")`.
          */
         fun redactedHeaders(redactedHeaders: Set<String>) = apply {
             this.redactedHeaders = redactedHeaders
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt
index c415808..03f3960 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/core/http/LoggingHttpClientTest.kt
@@ -870,7 +870,8 @@ internal class LoggingHttpClientTest {
         httpClient: HttpClient,
         level: LogLevel,
         clock: Clock = clockFrom(Instant.parse("1998-04-21T00:00:00Z")),
-        redactedHeaders: Set<String> = setOf("Authorization"),
+        redactedHeaders: Set<String> =
+            setOf("authorization", "api-key", "x-api-key", "cookie", "set-cookie"),
     ): LoggingHttpClient =
         LoggingHttpClient.builder()
             .httpClient(httpClient)

From 1c697d5bd9f91a4a495d5d71667de5271e8cac0f Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 9 May 2026 02:12:28 +0000
Subject: [PATCH 44/63] feat(api): api update

---
 .stats.yml                                    |  4 +-
 .../api/models/chats/typing/TypingResponse.kt | 46 +++++++++++++++++--
 .../models/chats/typing/TypingStartParams.kt  |  8 +++-
 .../models/chats/typing/TypingStopParams.kt   |  8 +++-
 .../async/chats/TypingServiceAsync.kt         | 12 ++++-
 .../services/blocking/chats/TypingService.kt  | 12 ++++-
 .../models/chats/typing/TypingResponseTest.kt |  4 ++
 7 files changed, 84 insertions(+), 10 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 6af5371..59c867a 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-d20a6894e43fc5f309725d0a11b326a41749ec949fdff6d3f33267358e40d4a7.yml
-openapi_spec_hash: 11d9b0407bffe03ac9ca3a91f11b2c3d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-efd0b1a3742ab66cdefbcadb5a11628de9aa18d356e3730c666628ed8f4ba8fa.yml
+openapi_spec_hash: 90f50b5ef3d3e845cc2c20aba392119e
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
index 3e17968..685e88f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingResponse.kt
@@ -22,6 +22,7 @@ private constructor(
     private val startedAt: JsonField<Long>,
     private val stoppedAt: JsonField<Long>,
     private val typing: JsonField<Boolean>,
+    private val warning: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -31,7 +32,8 @@ private constructor(
         @JsonProperty("started_at") @ExcludeMissing startedAt: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("stopped_at") @ExcludeMissing stoppedAt: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("typing") @ExcludeMissing typing: JsonField<Boolean> = JsonMissing.of(),
-    ) : this(chatId, startedAt, stoppedAt, typing, mutableMapOf())
+        @JsonProperty("warning") @ExcludeMissing warning: JsonField<String> = JsonMissing.of(),
+    ) : this(chatId, startedAt, stoppedAt, typing, warning, mutableMapOf())
 
     /**
      * Chat identifier
@@ -65,6 +67,15 @@ private constructor(
      */
     fun typing(): Optional<Boolean> = typing.getOptional("typing")
 
+    /**
+     * Present when the request was accepted but the indicator could not be delivered. The most
+     * common reason is that the chat last routed via RCS, which does not carry composing state.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun warning(): Optional<String> = warning.getOptional("warning")
+
     /**
      * Returns the raw JSON value of [chatId].
      *
@@ -93,6 +104,13 @@ private constructor(
      */
     @JsonProperty("typing") @ExcludeMissing fun _typing(): JsonField<Boolean> = typing
 
+    /**
+     * Returns the raw JSON value of [warning].
+     *
+     * Unlike [warning], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("warning") @ExcludeMissing fun _warning(): JsonField<String> = warning
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -118,6 +136,7 @@ private constructor(
         private var startedAt: JsonField<Long> = JsonMissing.of()
         private var stoppedAt: JsonField<Long> = JsonMissing.of()
         private var typing: JsonField<Boolean> = JsonMissing.of()
+        private var warning: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -126,6 +145,7 @@ private constructor(
             startedAt = typingResponse.startedAt
             stoppedAt = typingResponse.stoppedAt
             typing = typingResponse.typing
+            warning = typingResponse.warning
             additionalProperties = typingResponse.additionalProperties.toMutableMap()
         }
 
@@ -173,6 +193,20 @@ private constructor(
          */
         fun typing(typing: JsonField<Boolean>) = apply { this.typing = typing }
 
+        /**
+         * Present when the request was accepted but the indicator could not be delivered. The most
+         * common reason is that the chat last routed via RCS, which does not carry composing state.
+         */
+        fun warning(warning: String) = warning(JsonField.of(warning))
+
+        /**
+         * Sets [Builder.warning] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.warning] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun warning(warning: JsonField<String>) = apply { this.warning = warning }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -203,6 +237,7 @@ private constructor(
                 startedAt,
                 stoppedAt,
                 typing,
+                warning,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -226,6 +261,7 @@ private constructor(
         startedAt()
         stoppedAt()
         typing()
+        warning()
         validated = true
     }
 
@@ -247,7 +283,8 @@ private constructor(
         (if (chatId.asKnown().isPresent) 1 else 0) +
             (if (startedAt.asKnown().isPresent) 1 else 0) +
             (if (stoppedAt.asKnown().isPresent) 1 else 0) +
-            (if (typing.asKnown().isPresent) 1 else 0)
+            (if (typing.asKnown().isPresent) 1 else 0) +
+            (if (warning.asKnown().isPresent) 1 else 0)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -259,15 +296,16 @@ private constructor(
             startedAt == other.startedAt &&
             stoppedAt == other.stoppedAt &&
             typing == other.typing &&
+            warning == other.warning &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(chatId, startedAt, stoppedAt, typing, additionalProperties)
+        Objects.hash(chatId, startedAt, stoppedAt, typing, warning, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "TypingResponse{chatId=$chatId, startedAt=$startedAt, stoppedAt=$stoppedAt, typing=$typing, additionalProperties=$additionalProperties}"
+        "TypingResponse{chatId=$chatId, startedAt=$startedAt, stoppedAt=$stoppedAt, typing=$typing, warning=$warning, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
index 26adcf4..f0db605 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
@@ -11,7 +11,13 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Start the typing indicator for a chat. The indicator shows the recipient that you are typing. */
+/**
+ * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+ *
+ * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS protocol
+ * does not carry composing state. Calls against RCS-routed chats return 200 with a `warning` field
+ * and have no visible effect on the recipient.
+ */
 class TypingStartParams
 private constructor(
     private val chatId: String?,
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
index d344b5e..5bbb6d2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
@@ -11,7 +11,13 @@ import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
-/** Stop the typing indicator for a chat. */
+/**
+ * Stop the typing indicator for a chat.
+ *
+ * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS protocol
+ * does not carry composing state. Calls against RCS-routed chats return 200 with a `warning` field
+ * and have no visible effect on the recipient.
+ */
 class TypingStopParams
 private constructor(
     private val chatId: String?,
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
index 803a49f..c90518d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
@@ -28,6 +28,10 @@ interface TypingServiceAsync {
 
     /**
      * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     *
+     * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
+     * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
+     * `warning` field and have no visible effect on the recipient.
      */
     fun start(chatId: String): CompletableFuture<TypingResponse> =
         start(chatId, TypingStartParams.none())
@@ -60,7 +64,13 @@ interface TypingServiceAsync {
     fun start(chatId: String, requestOptions: RequestOptions): CompletableFuture<TypingResponse> =
         start(chatId, TypingStartParams.none(), requestOptions)
 
-    /** Stop the typing indicator for a chat. */
+    /**
+     * Stop the typing indicator for a chat.
+     *
+     * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
+     * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
+     * `warning` field and have no visible effect on the recipient.
+     */
     fun stop(chatId: String): CompletableFuture<TypingResponse> =
         stop(chatId, TypingStopParams.none())
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
index c3b37a2..432ae0a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
@@ -28,6 +28,10 @@ interface TypingService {
 
     /**
      * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     *
+     * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
+     * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
+     * `warning` field and have no visible effect on the recipient.
      */
     fun start(chatId: String): TypingResponse = start(chatId, TypingStartParams.none())
 
@@ -57,7 +61,13 @@ interface TypingService {
     fun start(chatId: String, requestOptions: RequestOptions): TypingResponse =
         start(chatId, TypingStartParams.none(), requestOptions)
 
-    /** Stop the typing indicator for a chat. */
+    /**
+     * Stop the typing indicator for a chat.
+     *
+     * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
+     * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
+     * `warning` field and have no visible effect on the recipient.
+     */
     fun stop(chatId: String): TypingResponse = stop(chatId, TypingStopParams.none())
 
     /** @see stop */
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
index 0d782a0..613bd28 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/typing/TypingResponseTest.kt
@@ -17,12 +17,15 @@ internal class TypingResponseTest {
                 .startedAt(0L)
                 .stoppedAt(0L)
                 .typing(true)
+                .warning("RCS chats do not support composing indicators")
                 .build()
 
         assertThat(typingResponse.chatId()).contains("chat_id")
         assertThat(typingResponse.startedAt()).contains(0L)
         assertThat(typingResponse.stoppedAt()).contains(0L)
         assertThat(typingResponse.typing()).contains(true)
+        assertThat(typingResponse.warning())
+            .contains("RCS chats do not support composing indicators")
     }
 
     @Test
@@ -34,6 +37,7 @@ internal class TypingResponseTest {
                 .startedAt(0L)
                 .stoppedAt(0L)
                 .typing(true)
+                .warning("RCS chats do not support composing indicators")
                 .build()
 
         val roundtrippedTypingResponse =

From 80f6a3d0d669e0cfd2d399ba44193eb0e78e84f5 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 12 May 2026 10:12:26 +0000
Subject: [PATCH 45/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../api/models/me/MeRetrieveResponse.kt       | 221 +++++++++++++++-
 .../models/me/numbers/NumberListResponse.kt   | 240 +++++++++++++++++-
 .../api/models/me/MeRetrieveResponseTest.kt   |   3 +
 .../me/numbers/NumberListResponseTest.kt      |   3 +
 .../api/proguard/ProGuardCompatibilityTest.kt |   1 +
 6 files changed, 460 insertions(+), 12 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 59c867a..d764538 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-efd0b1a3742ab66cdefbcadb5a11628de9aa18d356e3730c666628ed8f4ba8fa.yml
-openapi_spec_hash: 90f50b5ef3d3e845cc2c20aba392119e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-2a244944dcd51b84f0f71eb8a8ce822821725b2c343b688a46ea7f82c7a95b6c.yml
+openapi_spec_hash: 2a5b40ad2fa43fa3e64a14ac56ff58d8
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
index 5347cc8..7e510a9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/MeRetrieveResponse.kt
@@ -619,6 +619,7 @@ private constructor(
         private val isActive: JsonField<Boolean>,
         private val lastActive: JsonField<Long>,
         private val phoneNumber: JsonField<String>,
+        private val planKind: JsonField<PlanKind>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -633,7 +634,10 @@ private constructor(
             @JsonProperty("phone_number")
             @ExcludeMissing
             phoneNumber: JsonField<String> = JsonMissing.of(),
-        ) : this(isActive, lastActive, phoneNumber, mutableMapOf())
+            @JsonProperty("plan_kind")
+            @ExcludeMissing
+            planKind: JsonField<PlanKind> = JsonMissing.of(),
+        ) : this(isActive, lastActive, phoneNumber, planKind, mutableMapOf())
 
         /**
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -655,6 +659,15 @@ private constructor(
          */
         fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
 
+        /**
+         * Plan type the underlying allocation runs on. `inbound` numbers are reply-only — see
+         * `/me/numbers` for details.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun planKind(): Optional<PlanKind> = planKind.getOptional("plan_kind")
+
         /**
          * Returns the raw JSON value of [isActive].
          *
@@ -678,6 +691,13 @@ private constructor(
         @ExcludeMissing
         fun _phoneNumber(): JsonField<String> = phoneNumber
 
+        /**
+         * Returns the raw JSON value of [planKind].
+         *
+         * Unlike [planKind], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("plan_kind") @ExcludeMissing fun _planKind(): JsonField<PlanKind> = planKind
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -702,6 +722,7 @@ private constructor(
             private var isActive: JsonField<Boolean> = JsonMissing.of()
             private var lastActive: JsonField<Long> = JsonMissing.of()
             private var phoneNumber: JsonField<String> = JsonMissing.of()
+            private var planKind: JsonField<PlanKind> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -709,6 +730,7 @@ private constructor(
                 isActive = device.isActive
                 lastActive = device.lastActive
                 phoneNumber = device.phoneNumber
+                planKind = device.planKind
                 additionalProperties = device.additionalProperties.toMutableMap()
             }
 
@@ -761,6 +783,24 @@ private constructor(
                 this.phoneNumber = phoneNumber
             }
 
+            /**
+             * Plan type the underlying allocation runs on. `inbound` numbers are reply-only — see
+             * `/me/numbers` for details.
+             */
+            fun planKind(planKind: PlanKind?) = planKind(JsonField.ofNullable(planKind))
+
+            /** Alias for calling [Builder.planKind] with `planKind.orElse(null)`. */
+            fun planKind(planKind: Optional<PlanKind>) = planKind(planKind.getOrNull())
+
+            /**
+             * Sets [Builder.planKind] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.planKind] with a well-typed [PlanKind] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun planKind(planKind: JsonField<PlanKind>) = apply { this.planKind = planKind }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -786,7 +826,13 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): Device =
-                Device(isActive, lastActive, phoneNumber, additionalProperties.toMutableMap())
+                Device(
+                    isActive,
+                    lastActive,
+                    phoneNumber,
+                    planKind,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -808,6 +854,7 @@ private constructor(
             isActive()
             lastActive()
             phoneNumber()
+            planKind().ifPresent { it.validate() }
             validated = true
         }
 
@@ -829,7 +876,170 @@ private constructor(
         internal fun validity(): Int =
             (if (isActive.asKnown().isPresent) 1 else 0) +
                 (if (lastActive.asKnown().isPresent) 1 else 0) +
-                (if (phoneNumber.asKnown().isPresent) 1 else 0)
+                (if (phoneNumber.asKnown().isPresent) 1 else 0) +
+                (planKind.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Plan type the underlying allocation runs on. `inbound` numbers are reply-only — see
+         * `/me/numbers` for details.
+         */
+        class PlanKind @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SHARED = of("shared")
+
+                @JvmField val DEDICATED = of("dedicated")
+
+                @JvmField val INBOUND = of("inbound")
+
+                @JvmField val TRIAL = of("trial")
+
+                @JvmField val _2FA = of("2fa")
+
+                @JvmStatic fun of(value: String) = PlanKind(JsonField.of(value))
+            }
+
+            /** An enum containing [PlanKind]'s known values. */
+            enum class Known {
+                SHARED,
+                DEDICATED,
+                INBOUND,
+                TRIAL,
+                _2FA,
+            }
+
+            /**
+             * An enum containing [PlanKind]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [PlanKind] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SHARED,
+                DEDICATED,
+                INBOUND,
+                TRIAL,
+                _2FA,
+                /**
+                 * An enum member indicating that [PlanKind] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SHARED -> Value.SHARED
+                    DEDICATED -> Value.DEDICATED
+                    INBOUND -> Value.INBOUND
+                    TRIAL -> Value.TRIAL
+                    _2FA -> Value._2FA
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SHARED -> Known.SHARED
+                    DEDICATED -> Known.DEDICATED
+                    INBOUND -> Known.INBOUND
+                    TRIAL -> Known.TRIAL
+                    _2FA -> Known._2FA
+                    else -> throw BlooioInvalidDataException("Unknown PlanKind: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): PlanKind = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is PlanKind && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -840,17 +1050,18 @@ private constructor(
                 isActive == other.isActive &&
                 lastActive == other.lastActive &&
                 phoneNumber == other.phoneNumber &&
+                planKind == other.planKind &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(isActive, lastActive, phoneNumber, additionalProperties)
+            Objects.hash(isActive, lastActive, phoneNumber, planKind, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Device{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, additionalProperties=$additionalProperties}"
+            "Device{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, planKind=$planKind, additionalProperties=$additionalProperties}"
     }
 
     class Organization
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
index b64a42d..e0da3ae 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/NumberListResponse.kt
@@ -2,6 +2,7 @@
 
 package com.blooio.api.models.me.numbers
 
+import com.blooio.api.core.Enum
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
@@ -172,6 +173,7 @@ private constructor(
         private val isActive: JsonField<Boolean>,
         private val lastActive: JsonField<OffsetDateTime>,
         private val phoneNumber: JsonField<String>,
+        private val planKind: JsonField<PlanKind>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -186,7 +188,10 @@ private constructor(
             @JsonProperty("phone_number")
             @ExcludeMissing
             phoneNumber: JsonField<String> = JsonMissing.of(),
-        ) : this(isActive, lastActive, phoneNumber, mutableMapOf())
+            @JsonProperty("plan_kind")
+            @ExcludeMissing
+            planKind: JsonField<PlanKind> = JsonMissing.of(),
+        ) : this(isActive, lastActive, phoneNumber, planKind, mutableMapOf())
 
         /**
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -206,6 +211,21 @@ private constructor(
          */
         fun phoneNumber(): Optional<String> = phoneNumber.getOptional("phone_number")
 
+        /**
+         * Plan type the underlying allocation runs on. Sourced directly from `allocation_pool.type`
+         * — the enum mirrors the DB `CHECK` constraint (see migration 2026-05-09-inbound-plan.sql),
+         * so any value here is also a valid type stored in the database. `inbound` numbers are
+         * reply-only — outbound to a recipient (a contact for 1:1 chats, the group for group chats)
+         * requires that recipient to have messaged the number first (otherwise the send returns
+         * `403 inbound_only_no_prior_inbound`). `null` indicates the underlying allocation predates
+         * the type column or is unattributed; clients should treat `null` the same as `dedicated`
+         * for routing decisions.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun planKind(): Optional<PlanKind> = planKind.getOptional("plan_kind")
+
         /**
          * Returns the raw JSON value of [isActive].
          *
@@ -231,6 +251,13 @@ private constructor(
         @ExcludeMissing
         fun _phoneNumber(): JsonField<String> = phoneNumber
 
+        /**
+         * Returns the raw JSON value of [planKind].
+         *
+         * Unlike [planKind], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("plan_kind") @ExcludeMissing fun _planKind(): JsonField<PlanKind> = planKind
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -255,6 +282,7 @@ private constructor(
             private var isActive: JsonField<Boolean> = JsonMissing.of()
             private var lastActive: JsonField<OffsetDateTime> = JsonMissing.of()
             private var phoneNumber: JsonField<String> = JsonMissing.of()
+            private var planKind: JsonField<PlanKind> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
@@ -262,6 +290,7 @@ private constructor(
                 isActive = number.isActive
                 lastActive = number.lastActive
                 phoneNumber = number.phoneNumber
+                planKind = number.planKind
                 additionalProperties = number.additionalProperties.toMutableMap()
             }
 
@@ -307,6 +336,30 @@ private constructor(
                 this.phoneNumber = phoneNumber
             }
 
+            /**
+             * Plan type the underlying allocation runs on. Sourced directly from
+             * `allocation_pool.type` — the enum mirrors the DB `CHECK` constraint (see migration
+             * 2026-05-09-inbound-plan.sql), so any value here is also a valid type stored in the
+             * database. `inbound` numbers are reply-only — outbound to a recipient (a contact for
+             * 1:1 chats, the group for group chats) requires that recipient to have messaged the
+             * number first (otherwise the send returns `403 inbound_only_no_prior_inbound`). `null`
+             * indicates the underlying allocation predates the type column or is unattributed;
+             * clients should treat `null` the same as `dedicated` for routing decisions.
+             */
+            fun planKind(planKind: PlanKind?) = planKind(JsonField.ofNullable(planKind))
+
+            /** Alias for calling [Builder.planKind] with `planKind.orElse(null)`. */
+            fun planKind(planKind: Optional<PlanKind>) = planKind(planKind.getOrNull())
+
+            /**
+             * Sets [Builder.planKind] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.planKind] with a well-typed [PlanKind] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun planKind(planKind: JsonField<PlanKind>) = apply { this.planKind = planKind }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -332,7 +385,13 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): Number =
-                Number(isActive, lastActive, phoneNumber, additionalProperties.toMutableMap())
+                Number(
+                    isActive,
+                    lastActive,
+                    phoneNumber,
+                    planKind,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -354,6 +413,7 @@ private constructor(
             isActive()
             lastActive()
             phoneNumber()
+            planKind().ifPresent { it.validate() }
             validated = true
         }
 
@@ -375,7 +435,176 @@ private constructor(
         internal fun validity(): Int =
             (if (isActive.asKnown().isPresent) 1 else 0) +
                 (if (lastActive.asKnown().isPresent) 1 else 0) +
-                (if (phoneNumber.asKnown().isPresent) 1 else 0)
+                (if (phoneNumber.asKnown().isPresent) 1 else 0) +
+                (planKind.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Plan type the underlying allocation runs on. Sourced directly from `allocation_pool.type`
+         * — the enum mirrors the DB `CHECK` constraint (see migration 2026-05-09-inbound-plan.sql),
+         * so any value here is also a valid type stored in the database. `inbound` numbers are
+         * reply-only — outbound to a recipient (a contact for 1:1 chats, the group for group chats)
+         * requires that recipient to have messaged the number first (otherwise the send returns
+         * `403 inbound_only_no_prior_inbound`). `null` indicates the underlying allocation predates
+         * the type column or is unattributed; clients should treat `null` the same as `dedicated`
+         * for routing decisions.
+         */
+        class PlanKind @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SHARED = of("shared")
+
+                @JvmField val DEDICATED = of("dedicated")
+
+                @JvmField val INBOUND = of("inbound")
+
+                @JvmField val TRIAL = of("trial")
+
+                @JvmField val _2FA = of("2fa")
+
+                @JvmStatic fun of(value: String) = PlanKind(JsonField.of(value))
+            }
+
+            /** An enum containing [PlanKind]'s known values. */
+            enum class Known {
+                SHARED,
+                DEDICATED,
+                INBOUND,
+                TRIAL,
+                _2FA,
+            }
+
+            /**
+             * An enum containing [PlanKind]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [PlanKind] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SHARED,
+                DEDICATED,
+                INBOUND,
+                TRIAL,
+                _2FA,
+                /**
+                 * An enum member indicating that [PlanKind] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SHARED -> Value.SHARED
+                    DEDICATED -> Value.DEDICATED
+                    INBOUND -> Value.INBOUND
+                    TRIAL -> Value.TRIAL
+                    _2FA -> Value._2FA
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SHARED -> Known.SHARED
+                    DEDICATED -> Known.DEDICATED
+                    INBOUND -> Known.INBOUND
+                    TRIAL -> Known.TRIAL
+                    _2FA -> Known._2FA
+                    else -> throw BlooioInvalidDataException("Unknown PlanKind: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws BlooioInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    BlooioInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): PlanKind = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is PlanKind && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -386,17 +615,18 @@ private constructor(
                 isActive == other.isActive &&
                 lastActive == other.lastActive &&
                 phoneNumber == other.phoneNumber &&
+                planKind == other.planKind &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(isActive, lastActive, phoneNumber, additionalProperties)
+            Objects.hash(isActive, lastActive, phoneNumber, planKind, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Number{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, additionalProperties=$additionalProperties}"
+            "Number{isActive=$isActive, lastActive=$lastActive, phoneNumber=$phoneNumber, planKind=$planKind, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
index defc66c..672bb8e 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/MeRetrieveResponseTest.kt
@@ -22,6 +22,7 @@ internal class MeRetrieveResponseTest {
                         .isActive(true)
                         .lastActive(0L)
                         .phoneNumber("phone_number")
+                        .planKind(MeRetrieveResponse.Device.PlanKind.SHARED)
                         .build()
                 )
                 .integrationDetails(JsonValue.from(mapOf<String, Any>()))
@@ -54,6 +55,7 @@ internal class MeRetrieveResponseTest {
                     .isActive(true)
                     .lastActive(0L)
                     .phoneNumber("phone_number")
+                    .planKind(MeRetrieveResponse.Device.PlanKind.SHARED)
                     .build()
             )
         assertThat(meRetrieveResponse._integrationDetails())
@@ -93,6 +95,7 @@ internal class MeRetrieveResponseTest {
                         .isActive(true)
                         .lastActive(0L)
                         .phoneNumber("phone_number")
+                        .planKind(MeRetrieveResponse.Device.PlanKind.SHARED)
                         .build()
                 )
                 .integrationDetails(JsonValue.from(mapOf<String, Any>()))
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
index 2bb9da7..4b0d4c2 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/me/numbers/NumberListResponseTest.kt
@@ -20,6 +20,7 @@ internal class NumberListResponseTest {
                         .isActive(true)
                         .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
                         .phoneNumber("+15551234567")
+                        .planKind(NumberListResponse.Number.PlanKind.SHARED)
                         .build()
                 )
                 .build()
@@ -30,6 +31,7 @@ internal class NumberListResponseTest {
                     .isActive(true)
                     .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
                     .phoneNumber("+15551234567")
+                    .planKind(NumberListResponse.Number.PlanKind.SHARED)
                     .build()
             )
     }
@@ -44,6 +46,7 @@ internal class NumberListResponseTest {
                         .isActive(true)
                         .lastActive(OffsetDateTime.parse("2019-12-27T18:11:19.117Z"))
                         .phoneNumber("+15551234567")
+                        .planKind(NumberListResponse.Number.PlanKind.SHARED)
                         .build()
                 )
                 .build()
diff --git a/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt b/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
index fc26fbe..39783a0 100644
--- a/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
+++ b/blooio-java-proguard-test/src/test/kotlin/com/blooio/api/proguard/ProGuardCompatibilityTest.kt
@@ -70,6 +70,7 @@ internal class ProGuardCompatibilityTest {
                         .isActive(true)
                         .lastActive(0L)
                         .phoneNumber("phone_number")
+                        .planKind(MeRetrieveResponse.Device.PlanKind.SHARED)
                         .build()
                 )
                 .integrationDetails(JsonValue.from(mapOf<String, Any>()))

From 13a94a792993b2212f693dd7de6a32aa2cc08186 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 13 May 2026 02:01:50 +0000
Subject: [PATCH 46/63] ci: pin GitHub Actions to commit SHAs

Pin all GitHub Actions referenced in generated workflows (both
first-party `actions/*` and third-party) to immutable commit SHAs.
Updating pinned actions is now a deliberate codegen-side bump rather
than implicit on every workflow run.
---
 .github/workflows/ci.yml               | 20 ++++++++++----------
 .github/workflows/publish-sonatype.yml |  6 +++---
 .github/workflows/release-doctor.yml   |  2 +-
 3 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 3081312..389b3f6 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -22,10 +22,10 @@ jobs:
     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
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -34,7 +34,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/actions/setup-gradle@v4
+        uses: gradle/actions/setup-gradle@ed408507eac070d1f99cc633dbcf757c94c7933a # v4.4.3
 
       - name: Run lints
         run: ./scripts/lint
@@ -49,10 +49,10 @@ jobs:
     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
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -61,7 +61,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/actions/setup-gradle@v4
+        uses: gradle/actions/setup-gradle@ed408507eac070d1f99cc633dbcf757c94c7933a # v4.4.3
 
       - name: Build SDK
         run: ./scripts/build
@@ -71,7 +71,7 @@ jobs:
           github.repository == 'stainless-sdks/blooio-java' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -91,10 +91,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -103,7 +103,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/gradle-build-action@v2
+        uses: gradle/gradle-build-action@a8f75513eafdebd8141bd1cd4e30fcd194af8dfa # v2.12.0
 
       - name: Run tests
         run: ./scripts/test
diff --git a/.github/workflows/publish-sonatype.yml b/.github/workflows/publish-sonatype.yml
index 2d81e3a..bb99be6 100644
--- a/.github/workflows/publish-sonatype.yml
+++ b/.github/workflows/publish-sonatype.yml
@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up Java
-        uses: actions/setup-java@v5
+        uses: actions/setup-java@be666c2fcd27ec809703dec50e508c2fdc7f6654 # v5.2.0
         with:
           distribution: temurin
           java-version: |
@@ -26,7 +26,7 @@ jobs:
           cache: gradle
 
       - name: Set up Gradle
-        uses: gradle/gradle-build-action@v2
+        uses: gradle/gradle-build-action@a8f75513eafdebd8141bd1cd4e30fcd194af8dfa # v2.12.0
 
       - name: Publish to Sonatype
         run: |-
diff --git a/.github/workflows/release-doctor.yml b/.github/workflows/release-doctor.yml
index 2d36b26..06caa1a 100644
--- a/.github/workflows/release-doctor.yml
+++ b/.github/workflows/release-doctor.yml
@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'Blooio/blooio-java-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

From 42ee71ffdc0961088155f55f433beceb12021350 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 14 May 2026 23:18:47 +0000
Subject: [PATCH 47/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../chats/messages/MessageSendParams.kt       | 418 +++++++++++++++++-
 .../async/chats/MessageServiceAsync.kt        |   6 +
 .../services/blocking/chats/MessageService.kt |   6 +
 .../chats/messages/MessageSendParamsTest.kt   |   4 +
 .../async/chats/MessageServiceAsyncTest.kt    |   1 +
 .../blocking/chats/MessageServiceTest.kt      |   1 +
 7 files changed, 436 insertions(+), 4 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d764538..000c763 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-2a244944dcd51b84f0f71eb8a8ce822821725b2c343b688a46ea7f82c7a95b6c.yml
-openapi_spec_hash: 2a5b40ad2fa43fa3e64a14ac56ff58d8
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-bce90b321b6782841d7834e0e0689b1812ef1f10f8f2823cd9908185d9f306e6.yml
+openapi_spec_hash: a90c7586ed5e83a938d72a286efa9f8e
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index 32bf6af..aed85aa 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -4,6 +4,7 @@ package com.blooio.api.models.chats.messages
 
 import com.blooio.api.core.BaseDeserializer
 import com.blooio.api.core.BaseSerializer
+import com.blooio.api.core.Enum
 import com.blooio.api.core.ExcludeMissing
 import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
@@ -39,6 +40,12 @@ import kotlin.jvm.optionals.getOrNull
  * multi-recipient, an unnamed group is automatically created or reused if the exact participant
  * combination already exists. For explicit groups, the group must be linked to an existing iMessage
  * chat.
+ *
+ * **iMessage send-with-effect:** set the optional `effect` field to attach an Apple expressive send
+ * (slam, loud, gentle, invisible-ink) or screen effect (echo, spotlight, balloons, confetti, love,
+ * lasers, fireworks, celebration). Effects are an iMessage-only feature — when the recipient is on
+ * SMS/RCS the message is delivered without the animation. Effects are not supported in multipart
+ * (`parts`) mode.
  */
 class MessageSendParams
 private constructor(
@@ -61,6 +68,40 @@ private constructor(
      */
     fun attachments(): Optional<List<Attachment>> = body.attachments()
 
+    /**
+     * Optional. Attach an iMessage send-with-effect to the outgoing message.
+     *
+     * **Bubble effects** (apply to a single text bubble):
+     * - `slam` — Slam
+     * - `loud` — Loud
+     * - `gentle` — Gentle
+     * - `invisible-ink` — Invisible Ink
+     *
+     * **Screen effects** (full-screen animation in the recipient's chat):
+     * - `echo` — Echo
+     * - `spotlight` — Spotlight
+     * - `balloons` — Balloons
+     * - `confetti` — Confetti
+     * - `love` — Love (heart)
+     * - `lasers` — Lasers
+     * - `fireworks` — Fireworks
+     * - `celebration` — Celebration (sparkles)
+     *
+     * Values are case-insensitive and accept either dashes or spaces (`"Invisible Ink"` and
+     * `"invisible-ink"` both work). Pass `"none"` or omit the field to send without an effect.
+     *
+     * **Limitations:**
+     * - iMessage-only — when the chat is delivered as SMS or RCS the message is sent without an
+     *   animation.
+     * - Not supported alongside the `parts` array (multipart bubbles cannot carry an effect). Use
+     *   the top-level `text` field instead.
+     * - When `text` is an array, every message in the array is sent with the same effect.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun effect(): Optional<Effect> = body.effect()
+
     /**
      * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
      * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this selects a
@@ -129,6 +170,13 @@ private constructor(
      */
     fun _attachments(): JsonField<List<Attachment>> = body._attachments()
 
+    /**
+     * Returns the raw JSON value of [effect].
+     *
+     * Unlike [effect], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _effect(): JsonField<Effect> = body._effect()
+
     /**
      * Returns the raw JSON value of [fromNumber].
      *
@@ -225,10 +273,10 @@ private constructor(
          * This is generally only useful if you are already constructing the body separately.
          * Otherwise, it's more convenient to use the top-level setters instead:
          * - [attachments]
+         * - [effect]
          * - [fromNumber]
          * - [linkPreview]
          * - [parts]
-         * - [shareContact]
          * - etc.
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
@@ -265,6 +313,48 @@ private constructor(
             body.addAttachment(unionObjectVariant1)
         }
 
+        /**
+         * Optional. Attach an iMessage send-with-effect to the outgoing message.
+         *
+         * **Bubble effects** (apply to a single text bubble):
+         * - `slam` — Slam
+         * - `loud` — Loud
+         * - `gentle` — Gentle
+         * - `invisible-ink` — Invisible Ink
+         *
+         * **Screen effects** (full-screen animation in the recipient's chat):
+         * - `echo` — Echo
+         * - `spotlight` — Spotlight
+         * - `balloons` — Balloons
+         * - `confetti` — Confetti
+         * - `love` — Love (heart)
+         * - `lasers` — Lasers
+         * - `fireworks` — Fireworks
+         * - `celebration` — Celebration (sparkles)
+         *
+         * Values are case-insensitive and accept either dashes or spaces (`"Invisible Ink"` and
+         * `"invisible-ink"` both work). Pass `"none"` or omit the field to send without an effect.
+         *
+         * **Limitations:**
+         * - iMessage-only — when the chat is delivered as SMS or RCS the message is sent without an
+         *   animation.
+         * - Not supported alongside the `parts` array (multipart bubbles cannot carry an effect).
+         *   Use the top-level `text` field instead.
+         * - When `text` is an array, every message in the array is sent with the same effect.
+         */
+        fun effect(effect: Effect?) = apply { body.effect(effect) }
+
+        /** Alias for calling [Builder.effect] with `effect.orElse(null)`. */
+        fun effect(effect: Optional<Effect>) = effect(effect.getOrNull())
+
+        /**
+         * Sets [Builder.effect] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.effect] with a well-typed [Effect] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun effect(effect: JsonField<Effect>) = apply { body.effect(effect) }
+
         /**
          * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
          * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this
@@ -539,6 +629,7 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val attachments: JsonField<List<Attachment>>,
+        private val effect: JsonField<Effect>,
         private val fromNumber: JsonField<String>,
         private val linkPreview: JsonField<LinkPreview>,
         private val parts: JsonField<List<Part>>,
@@ -553,6 +644,7 @@ private constructor(
             @JsonProperty("attachments")
             @ExcludeMissing
             attachments: JsonField<List<Attachment>> = JsonMissing.of(),
+            @JsonProperty("effect") @ExcludeMissing effect: JsonField<Effect> = JsonMissing.of(),
             @JsonProperty("from_number")
             @ExcludeMissing
             fromNumber: JsonField<String> = JsonMissing.of(),
@@ -569,6 +661,7 @@ private constructor(
             useTypingIndicator: JsonField<Boolean> = JsonMissing.of(),
         ) : this(
             attachments,
+            effect,
             fromNumber,
             linkPreview,
             parts,
@@ -586,6 +679,40 @@ private constructor(
          */
         fun attachments(): Optional<List<Attachment>> = attachments.getOptional("attachments")
 
+        /**
+         * Optional. Attach an iMessage send-with-effect to the outgoing message.
+         *
+         * **Bubble effects** (apply to a single text bubble):
+         * - `slam` — Slam
+         * - `loud` — Loud
+         * - `gentle` — Gentle
+         * - `invisible-ink` — Invisible Ink
+         *
+         * **Screen effects** (full-screen animation in the recipient's chat):
+         * - `echo` — Echo
+         * - `spotlight` — Spotlight
+         * - `balloons` — Balloons
+         * - `confetti` — Confetti
+         * - `love` — Love (heart)
+         * - `lasers` — Lasers
+         * - `fireworks` — Fireworks
+         * - `celebration` — Celebration (sparkles)
+         *
+         * Values are case-insensitive and accept either dashes or spaces (`"Invisible Ink"` and
+         * `"invisible-ink"` both work). Pass `"none"` or omit the field to send without an effect.
+         *
+         * **Limitations:**
+         * - iMessage-only — when the chat is delivered as SMS or RCS the message is sent without an
+         *   animation.
+         * - Not supported alongside the `parts` array (multipart bubbles cannot carry an effect).
+         *   Use the top-level `text` field instead.
+         * - When `text` is an array, every message in the array is sent with the same effect.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun effect(): Optional<Effect> = effect.getOptional("effect")
+
         /**
          * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted, the
          * first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys, this
@@ -658,6 +785,13 @@ private constructor(
         @ExcludeMissing
         fun _attachments(): JsonField<List<Attachment>> = attachments
 
+        /**
+         * Returns the raw JSON value of [effect].
+         *
+         * Unlike [effect], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("effect") @ExcludeMissing fun _effect(): JsonField<Effect> = effect
+
         /**
          * Returns the raw JSON value of [fromNumber].
          *
@@ -732,6 +866,7 @@ private constructor(
         class Builder internal constructor() {
 
             private var attachments: JsonField<MutableList<Attachment>>? = null
+            private var effect: JsonField<Effect> = JsonMissing.of()
             private var fromNumber: JsonField<String> = JsonMissing.of()
             private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
             private var parts: JsonField<MutableList<Part>>? = null
@@ -743,6 +878,7 @@ private constructor(
             @JvmSynthetic
             internal fun from(body: Body) = apply {
                 attachments = body.attachments.map { it.toMutableList() }
+                effect = body.effect
                 fromNumber = body.fromNumber
                 linkPreview = body.linkPreview
                 parts = body.parts.map { it.toMutableList() }
@@ -788,6 +924,50 @@ private constructor(
             fun addAttachment(unionObjectVariant1: Attachment.UnionObjectVariant1) =
                 addAttachment(Attachment.ofUnionObjectVariant1(unionObjectVariant1))
 
+            /**
+             * Optional. Attach an iMessage send-with-effect to the outgoing message.
+             *
+             * **Bubble effects** (apply to a single text bubble):
+             * - `slam` — Slam
+             * - `loud` — Loud
+             * - `gentle` — Gentle
+             * - `invisible-ink` — Invisible Ink
+             *
+             * **Screen effects** (full-screen animation in the recipient's chat):
+             * - `echo` — Echo
+             * - `spotlight` — Spotlight
+             * - `balloons` — Balloons
+             * - `confetti` — Confetti
+             * - `love` — Love (heart)
+             * - `lasers` — Lasers
+             * - `fireworks` — Fireworks
+             * - `celebration` — Celebration (sparkles)
+             *
+             * Values are case-insensitive and accept either dashes or spaces (`"Invisible Ink"` and
+             * `"invisible-ink"` both work). Pass `"none"` or omit the field to send without an
+             * effect.
+             *
+             * **Limitations:**
+             * - iMessage-only — when the chat is delivered as SMS or RCS the message is sent
+             *   without an animation.
+             * - Not supported alongside the `parts` array (multipart bubbles cannot carry an
+             *   effect). Use the top-level `text` field instead.
+             * - When `text` is an array, every message in the array is sent with the same effect.
+             */
+            fun effect(effect: Effect?) = effect(JsonField.ofNullable(effect))
+
+            /** Alias for calling [Builder.effect] with `effect.orElse(null)`. */
+            fun effect(effect: Optional<Effect>) = effect(effect.getOrNull())
+
+            /**
+             * Sets [Builder.effect] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.effect] with a well-typed [Effect] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun effect(effect: JsonField<Effect>) = apply { this.effect = effect }
+
             /**
              * E.164 phone number to send from. For Twilio API keys, this is optional — if omitted,
              * the first assigned Twilio number is auto-selected. For Blooio (iMessage) API keys,
@@ -945,6 +1125,7 @@ private constructor(
             fun build(): Body =
                 Body(
                     (attachments ?: JsonMissing.of()).map { it.toImmutable() },
+                    effect,
                     fromNumber,
                     linkPreview,
                     (parts ?: JsonMissing.of()).map { it.toImmutable() },
@@ -972,6 +1153,7 @@ private constructor(
             }
 
             attachments().ifPresent { it.forEach { it.validate() } }
+            effect().ifPresent { it.validate() }
             fromNumber()
             linkPreview().ifPresent { it.validate() }
             parts().ifPresent { it.forEach { it.validate() } }
@@ -998,6 +1180,7 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (attachments.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (effect.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (fromNumber.asKnown().isPresent) 1 else 0) +
                 (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
                 (parts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
@@ -1012,6 +1195,7 @@ private constructor(
 
             return other is Body &&
                 attachments == other.attachments &&
+                effect == other.effect &&
                 fromNumber == other.fromNumber &&
                 linkPreview == other.linkPreview &&
                 parts == other.parts &&
@@ -1024,6 +1208,7 @@ private constructor(
         private val hashCode: Int by lazy {
             Objects.hash(
                 attachments,
+                effect,
                 fromNumber,
                 linkPreview,
                 parts,
@@ -1037,7 +1222,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{attachments=$attachments, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
+            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
     }
 
     /** URL to the attachment */
@@ -1469,6 +1654,235 @@ private constructor(
         }
     }
 
+    /**
+     * Optional. Attach an iMessage send-with-effect to the outgoing message.
+     *
+     * **Bubble effects** (apply to a single text bubble):
+     * - `slam` — Slam
+     * - `loud` — Loud
+     * - `gentle` — Gentle
+     * - `invisible-ink` — Invisible Ink
+     *
+     * **Screen effects** (full-screen animation in the recipient's chat):
+     * - `echo` — Echo
+     * - `spotlight` — Spotlight
+     * - `balloons` — Balloons
+     * - `confetti` — Confetti
+     * - `love` — Love (heart)
+     * - `lasers` — Lasers
+     * - `fireworks` — Fireworks
+     * - `celebration` — Celebration (sparkles)
+     *
+     * Values are case-insensitive and accept either dashes or spaces (`"Invisible Ink"` and
+     * `"invisible-ink"` both work). Pass `"none"` or omit the field to send without an effect.
+     *
+     * **Limitations:**
+     * - iMessage-only — when the chat is delivered as SMS or RCS the message is sent without an
+     *   animation.
+     * - Not supported alongside the `parts` array (multipart bubbles cannot carry an effect). Use
+     *   the top-level `text` field instead.
+     * - When `text` is an array, every message in the array is sent with the same effect.
+     */
+    class Effect @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SLAM = of("slam")
+
+            @JvmField val LOUD = of("loud")
+
+            @JvmField val GENTLE = of("gentle")
+
+            @JvmField val INVISIBLE_INK = of("invisible-ink")
+
+            @JvmField val ECHO = of("echo")
+
+            @JvmField val SPOTLIGHT = of("spotlight")
+
+            @JvmField val BALLOONS = of("balloons")
+
+            @JvmField val CONFETTI = of("confetti")
+
+            @JvmField val LOVE = of("love")
+
+            @JvmField val LASERS = of("lasers")
+
+            @JvmField val FIREWORKS = of("fireworks")
+
+            @JvmField val CELEBRATION = of("celebration")
+
+            @JvmField val NONE = of("none")
+
+            @JvmStatic fun of(value: String) = Effect(JsonField.of(value))
+        }
+
+        /** An enum containing [Effect]'s known values. */
+        enum class Known {
+            SLAM,
+            LOUD,
+            GENTLE,
+            INVISIBLE_INK,
+            ECHO,
+            SPOTLIGHT,
+            BALLOONS,
+            CONFETTI,
+            LOVE,
+            LASERS,
+            FIREWORKS,
+            CELEBRATION,
+            NONE,
+        }
+
+        /**
+         * An enum containing [Effect]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Effect] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SLAM,
+            LOUD,
+            GENTLE,
+            INVISIBLE_INK,
+            ECHO,
+            SPOTLIGHT,
+            BALLOONS,
+            CONFETTI,
+            LOVE,
+            LASERS,
+            FIREWORKS,
+            CELEBRATION,
+            NONE,
+            /** An enum member indicating that [Effect] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SLAM -> Value.SLAM
+                LOUD -> Value.LOUD
+                GENTLE -> Value.GENTLE
+                INVISIBLE_INK -> Value.INVISIBLE_INK
+                ECHO -> Value.ECHO
+                SPOTLIGHT -> Value.SPOTLIGHT
+                BALLOONS -> Value.BALLOONS
+                CONFETTI -> Value.CONFETTI
+                LOVE -> Value.LOVE
+                LASERS -> Value.LASERS
+                FIREWORKS -> Value.FIREWORKS
+                CELEBRATION -> Value.CELEBRATION
+                NONE -> Value.NONE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SLAM -> Known.SLAM
+                LOUD -> Known.LOUD
+                GENTLE -> Known.GENTLE
+                INVISIBLE_INK -> Known.INVISIBLE_INK
+                ECHO -> Known.ECHO
+                SPOTLIGHT -> Known.SPOTLIGHT
+                BALLOONS -> Known.BALLOONS
+                CONFETTI -> Known.CONFETTI
+                LOVE -> Known.LOVE
+                LASERS -> Known.LASERS
+                FIREWORKS -> Known.FIREWORKS
+                CELEBRATION -> Known.CELEBRATION
+                NONE -> Known.NONE
+                else -> throw BlooioInvalidDataException("Unknown Effect: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws BlooioInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { BlooioInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Effect = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Effect && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     class Part
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
index e6af4da..411a07d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -156,6 +156,12 @@ interface MessageServiceAsync {
      * For multi-recipient, an unnamed group is automatically created or reused if the exact
      * participant combination already exists. For explicit groups, the group must be linked to an
      * existing iMessage chat.
+     *
+     * **iMessage send-with-effect:** set the optional `effect` field to attach an Apple expressive
+     * send (slam, loud, gentle, invisible-ink) or screen effect (echo, spotlight, balloons,
+     * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
+     * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
+     * supported in multipart (`parts`) mode.
      */
     fun send(chatId: String): CompletableFuture<MessageSendResponse> =
         send(chatId, MessageSendParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
index b5e883d..6f2100e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -141,6 +141,12 @@ interface MessageService {
      * For multi-recipient, an unnamed group is automatically created or reused if the exact
      * participant combination already exists. For explicit groups, the group must be linked to an
      * existing iMessage chat.
+     *
+     * **iMessage send-with-effect:** set the optional `effect` field to attach an Apple expressive
+     * send (slam, loud, gentle, invisible-ink) or screen effect (echo, spotlight, balloons,
+     * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
+     * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
+     * supported in multipart (`parts`) mode.
      */
     fun send(chatId: String): MessageSendResponse = send(chatId, MessageSendParams.none())
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
index 29cb640..fd602ad 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
@@ -15,6 +15,7 @@ internal class MessageSendParamsTest {
             .chatId("chatId")
             .idempotencyKey("Idempotency-Key")
             .addAttachment("string")
+            .effect(MessageSendParams.Effect.SLAM)
             .fromNumber("from_number")
             .linkPreview(
                 LinkPreview.builder().imageUrl("https://example.com").title("title").build()
@@ -52,6 +53,7 @@ internal class MessageSendParamsTest {
                 .chatId("chatId")
                 .idempotencyKey("Idempotency-Key")
                 .addAttachment("string")
+                .effect(MessageSendParams.Effect.SLAM)
                 .fromNumber("from_number")
                 .linkPreview(
                     LinkPreview.builder().imageUrl("https://example.com").title("title").build()
@@ -97,6 +99,7 @@ internal class MessageSendParamsTest {
                 .chatId("chatId")
                 .idempotencyKey("Idempotency-Key")
                 .addAttachment("string")
+                .effect(MessageSendParams.Effect.SLAM)
                 .fromNumber("from_number")
                 .linkPreview(
                     LinkPreview.builder().imageUrl("https://example.com").title("title").build()
@@ -124,6 +127,7 @@ internal class MessageSendParamsTest {
 
         assertThat(body.attachments().getOrNull())
             .containsExactly(MessageSendParams.Attachment.ofString("string"))
+        assertThat(body.effect()).contains(MessageSendParams.Effect.SLAM)
         assertThat(body.fromNumber()).contains("from_number")
         assertThat(body.linkPreview())
             .contains(LinkPreview.builder().imageUrl("https://example.com").title("title").build())
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
index 0ba1dec..3a57799 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
@@ -105,6 +105,7 @@ internal class MessageServiceAsyncTest {
                     .chatId("chatId")
                     .idempotencyKey("Idempotency-Key")
                     .addAttachment("string")
+                    .effect(MessageSendParams.Effect.SLAM)
                     .fromNumber("from_number")
                     .linkPreview(
                         LinkPreview.builder().imageUrl("https://example.com").title("title").build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
index 3e29307..633bb81 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
@@ -101,6 +101,7 @@ internal class MessageServiceTest {
                     .chatId("chatId")
                     .idempotencyKey("Idempotency-Key")
                     .addAttachment("string")
+                    .effect(MessageSendParams.Effect.SLAM)
                     .fromNumber("from_number")
                     .linkPreview(
                         LinkPreview.builder().imageUrl("https://example.com").title("title").build()

From e80c968881cf120159070e90dfc1b6c3245dcfa9 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 22 May 2026 23:20:25 +0000
Subject: [PATCH 48/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../chats/messages/MessageListResponse.kt     | 330 +++++++++++++++-
 .../chats/messages/MessageRetrieveResponse.kt | 316 +++++++++++++++-
 .../chats/messages/MessageSendParams.kt       | 354 +++++++++++++++++-
 .../chats/messages/MessageSendResponse.kt     |  54 ++-
 .../async/chats/MessageServiceAsync.kt        |  12 +
 .../services/blocking/chats/MessageService.kt |  12 +
 .../chats/messages/MessageListResponseTest.kt |  21 ++
 .../messages/MessageRetrieveResponseTest.kt   |  22 ++
 .../chats/messages/MessageSendParamsTest.kt   |  29 ++
 .../chats/messages/MessageSendResponseTest.kt |   3 +
 .../async/chats/MessageServiceAsyncTest.kt    |   7 +
 .../blocking/chats/MessageServiceTest.kt      |   7 +
 13 files changed, 1165 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 000c763..8729928 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-bce90b321b6782841d7834e0e0689b1812ef1f10f8f2823cd9908185d9f306e6.yml
-openapi_spec_hash: a90c7586ed5e83a938d72a286efa9f8e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-23ac4ce198a5e8bffa1e5b9454a35bd0ca35a31d844f681d60e67cf4ff542411.yml
+openapi_spec_hash: e35cf6f966a4c18c696d1c453e40a809
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
index 2a496eb..90a1f3a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -8,6 +8,7 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.blooio.api.models.contacts.Pagination
@@ -245,6 +246,7 @@ private constructor(
         private val messageId: JsonField<String>,
         private val protocol: JsonField<Protocol>,
         private val reactions: JsonField<List<Reaction>>,
+        private val replyTo: JsonField<ReplyTo>,
         private val sender: JsonField<String>,
         private val status: JsonField<Status>,
         private val text: JsonField<String>,
@@ -277,6 +279,9 @@ private constructor(
             @JsonProperty("reactions")
             @ExcludeMissing
             reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+            @JsonProperty("reply_to")
+            @ExcludeMissing
+            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
             @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
             @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -293,6 +298,7 @@ private constructor(
             messageId,
             protocol,
             reactions,
+            replyTo,
             sender,
             status,
             text,
@@ -355,6 +361,15 @@ private constructor(
          */
         fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -454,6 +469,13 @@ private constructor(
         @ExcludeMissing
         fun _reactions(): JsonField<List<Reaction>> = reactions
 
+        /**
+         * Returns the raw JSON value of [replyTo].
+         *
+         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
         /**
          * Returns the raw JSON value of [sender].
          *
@@ -521,6 +543,7 @@ private constructor(
             private var messageId: JsonField<String> = JsonMissing.of()
             private var protocol: JsonField<Protocol> = JsonMissing.of()
             private var reactions: JsonField<MutableList<Reaction>>? = null
+            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var sender: JsonField<String> = JsonMissing.of()
             private var status: JsonField<Status> = JsonMissing.of()
             private var text: JsonField<String> = JsonMissing.of()
@@ -538,6 +561,7 @@ private constructor(
                 messageId = message.messageId
                 protocol = message.protocol
                 reactions = message.reactions.map { it.toMutableList() }
+                replyTo = message.replyTo
                 sender = message.sender
                 status = message.status
                 text = message.text
@@ -674,6 +698,24 @@ private constructor(
                     }
             }
 
+            /**
+             * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+             * every GET endpoint that returns a single message or a list of messages.
+             */
+            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+            /**
+             * Sets [Builder.replyTo] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
             /**
              * Sender's phone number or email for inbound group messages. Null for outbound messages
              * and 1-1 chats.
@@ -790,6 +832,7 @@ private constructor(
                     messageId,
                     protocol,
                     (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                    replyTo,
                     sender,
                     status,
                     text,
@@ -823,6 +866,7 @@ private constructor(
             messageId()
             protocol().ifPresent { it.validate() }
             reactions().ifPresent { it.forEach { it.validate() } }
+            replyTo().ifPresent { it.validate() }
             sender()
             status().ifPresent { it.validate() }
             text()
@@ -855,6 +899,7 @@ private constructor(
                 (if (messageId.asKnown().isPresent) 1 else 0) +
                 (protocol.asKnown().getOrNull()?.validity() ?: 0) +
                 (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (sender.asKnown().isPresent) 1 else 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (text.asKnown().isPresent) 1 else 0) +
@@ -1154,6 +1199,287 @@ private constructor(
             override fun toString() = value.toString()
         }
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         */
+        class ReplyTo
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val guid: JsonField<String>,
+            private val messageId: JsonField<String>,
+            private val partIndex: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("message_id")
+                @ExcludeMissing
+                messageId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("part_index")
+                @ExcludeMissing
+                partIndex: JsonField<Long> = JsonMissing.of(),
+            ) : this(guid, messageId, partIndex, mutableMapOf())
+
+            /**
+             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+             * on-device record-of-truth identifier that survives even when `message_id` cannot be
+             * resolved.
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun guid(): Optional<String> = guid.getOptional("guid")
+
+            /**
+             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+            /**
+             * Which part of the parent was replied to. 0 for the common single-part case.
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun partIndex(): Long = partIndex.getRequired("part_index")
+
+            /**
+             * Returns the raw JSON value of [guid].
+             *
+             * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+            /**
+             * Returns the raw JSON value of [messageId].
+             *
+             * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            fun _messageId(): JsonField<String> = messageId
+
+            /**
+             * Returns the raw JSON value of [partIndex].
+             *
+             * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            fun _partIndex(): JsonField<Long> = partIndex
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ReplyTo].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .guid()
+                 * .messageId()
+                 * .partIndex()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ReplyTo]. */
+            class Builder internal constructor() {
+
+                private var guid: JsonField<String>? = null
+                private var messageId: JsonField<String>? = null
+                private var partIndex: JsonField<Long>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(replyTo: ReplyTo) = apply {
+                    guid = replyTo.guid
+                    messageId = replyTo.messageId
+                    partIndex = replyTo.partIndex
+                    additionalProperties = replyTo.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+                 * on-device record-of-truth identifier that survives even when `message_id` cannot
+                 * be resolved.
+                 */
+                fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
+
+                /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
+                fun guid(guid: Optional<String>) = guid(guid.getOrNull())
+
+                /**
+                 * Sets [Builder.guid] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.guid] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+                /**
+                 * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+                 * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+                 */
+                fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
+
+                /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
+                fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+
+                /**
+                 * Sets [Builder.messageId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.messageId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+                /** Which part of the parent was replied to. 0 for the common single-part case. */
+                fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+                /**
+                 * Sets [Builder.partIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.partIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ReplyTo].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .guid()
+                 * .messageId()
+                 * .partIndex()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ReplyTo =
+                    ReplyTo(
+                        checkRequired("guid", guid),
+                        checkRequired("messageId", messageId),
+                        checkRequired("partIndex", partIndex),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ReplyTo = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                guid()
+                messageId()
+                partIndex()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (guid.asKnown().isPresent) 1 else 0) +
+                    (if (messageId.asKnown().isPresent) 1 else 0) +
+                    (if (partIndex.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ReplyTo &&
+                    guid == other.guid &&
+                    messageId == other.messageId &&
+                    partIndex == other.partIndex &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(guid, messageId, partIndex, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+        }
+
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -1337,6 +1663,7 @@ private constructor(
                 messageId == other.messageId &&
                 protocol == other.protocol &&
                 reactions == other.reactions &&
+                replyTo == other.replyTo &&
                 sender == other.sender &&
                 status == other.status &&
                 text == other.text &&
@@ -1355,6 +1682,7 @@ private constructor(
                 messageId,
                 protocol,
                 reactions,
+                replyTo,
                 sender,
                 status,
                 text,
@@ -1367,7 +1695,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
index 165f086..f7170a1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -8,6 +8,7 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.fasterxml.jackson.annotation.JsonAnyGetter
@@ -31,6 +32,7 @@ private constructor(
     private val messageId: JsonField<String>,
     private val protocol: JsonField<Protocol>,
     private val reactions: JsonField<List<Reaction>>,
+    private val replyTo: JsonField<ReplyTo>,
     private val sender: JsonField<String>,
     private val status: JsonField<Status>,
     private val text: JsonField<String>,
@@ -58,6 +60,7 @@ private constructor(
         @JsonProperty("reactions")
         @ExcludeMissing
         reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+        @JsonProperty("reply_to") @ExcludeMissing replyTo: JsonField<ReplyTo> = JsonMissing.of(),
         @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -75,6 +78,7 @@ private constructor(
         messageId,
         protocol,
         reactions,
+        replyTo,
         sender,
         status,
         text,
@@ -141,6 +145,15 @@ private constructor(
      */
     fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
+    /**
+     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
+     * GET endpoint that returns a single message or a list of messages.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
     /**
      * Sender's phone number or email for inbound group messages. Null for outbound messages and 1-1
      * chats.
@@ -241,6 +254,13 @@ private constructor(
     @ExcludeMissing
     fun _reactions(): JsonField<List<Reaction>> = reactions
 
+    /**
+     * Returns the raw JSON value of [replyTo].
+     *
+     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
     /**
      * Returns the raw JSON value of [sender].
      *
@@ -308,6 +328,7 @@ private constructor(
         private var messageId: JsonField<String> = JsonMissing.of()
         private var protocol: JsonField<Protocol> = JsonMissing.of()
         private var reactions: JsonField<MutableList<Reaction>>? = null
+        private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
         private var sender: JsonField<String> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
         private var text: JsonField<String> = JsonMissing.of()
@@ -326,6 +347,7 @@ private constructor(
             messageId = messageRetrieveResponse.messageId
             protocol = messageRetrieveResponse.protocol
             reactions = messageRetrieveResponse.reactions.map { it.toMutableList() }
+            replyTo = messageRetrieveResponse.replyTo
             sender = messageRetrieveResponse.sender
             status = messageRetrieveResponse.status
             text = messageRetrieveResponse.text
@@ -472,6 +494,23 @@ private constructor(
                 }
         }
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         */
+        fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+        /**
+         * Sets [Builder.replyTo] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -583,6 +622,7 @@ private constructor(
                 messageId,
                 protocol,
                 (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                replyTo,
                 sender,
                 status,
                 text,
@@ -616,6 +656,7 @@ private constructor(
         messageId()
         protocol().ifPresent { it.validate() }
         reactions().ifPresent { it.forEach { it.validate() } }
+        replyTo().ifPresent { it.validate() }
         sender()
         status().ifPresent { it.validate() }
         text()
@@ -648,6 +689,7 @@ private constructor(
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (protocol.asKnown().getOrNull()?.validity() ?: 0) +
             (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
             (if (sender.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (text.asKnown().isPresent) 1 else 0) +
@@ -1162,6 +1204,276 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
+     * GET endpoint that returns a single message or a list of messages.
+     */
+    class ReplyTo
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val guid: JsonField<String>,
+        private val messageId: JsonField<String>,
+        private val partIndex: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            messageId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            partIndex: JsonField<Long> = JsonMissing.of(),
+        ) : this(guid, messageId, partIndex, mutableMapOf())
+
+        /**
+         * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+         * on-device record-of-truth identifier that survives even when `message_id` cannot be
+         * resolved.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun guid(): Optional<String> = guid.getOptional("guid")
+
+        /**
+         * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+         * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+        /**
+         * Which part of the parent was replied to. 0 for the common single-part case.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun partIndex(): Long = partIndex.getRequired("part_index")
+
+        /**
+         * Returns the raw JSON value of [guid].
+         *
+         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+        /**
+         * Returns the raw JSON value of [messageId].
+         *
+         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+        /**
+         * Returns the raw JSON value of [partIndex].
+         *
+         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ReplyTo].
+             *
+             * The following fields are required:
+             * ```java
+             * .guid()
+             * .messageId()
+             * .partIndex()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ReplyTo]. */
+        class Builder internal constructor() {
+
+            private var guid: JsonField<String>? = null
+            private var messageId: JsonField<String>? = null
+            private var partIndex: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(replyTo: ReplyTo) = apply {
+                guid = replyTo.guid
+                messageId = replyTo.messageId
+                partIndex = replyTo.partIndex
+                additionalProperties = replyTo.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+             * on-device record-of-truth identifier that survives even when `message_id` cannot be
+             * resolved.
+             */
+            fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
+
+            /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
+            fun guid(guid: Optional<String>) = guid(guid.getOrNull())
+
+            /**
+             * Sets [Builder.guid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+            /**
+             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+             */
+            fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
+
+            /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
+            fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+
+            /**
+             * Sets [Builder.messageId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+            /** Which part of the parent was replied to. 0 for the common single-part case. */
+            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+            /**
+             * Sets [Builder.partIndex] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ReplyTo].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .guid()
+             * .messageId()
+             * .partIndex()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ReplyTo =
+                ReplyTo(
+                    checkRequired("guid", guid),
+                    checkRequired("messageId", messageId),
+                    checkRequired("partIndex", partIndex),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ReplyTo = apply {
+            if (validated) {
+                return@apply
+            }
+
+            guid()
+            messageId()
+            partIndex()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (guid.asKnown().isPresent) 1 else 0) +
+                (if (messageId.asKnown().isPresent) 1 else 0) +
+                (if (partIndex.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ReplyTo &&
+                guid == other.guid &&
+                messageId == other.messageId &&
+                partIndex == other.partIndex &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(guid, messageId, partIndex, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+    }
+
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -1341,6 +1653,7 @@ private constructor(
             messageId == other.messageId &&
             protocol == other.protocol &&
             reactions == other.reactions &&
+            replyTo == other.replyTo &&
             sender == other.sender &&
             status == other.status &&
             text == other.text &&
@@ -1360,6 +1673,7 @@ private constructor(
             messageId,
             protocol,
             reactions,
+            replyTo,
             sender,
             status,
             text,
@@ -1372,5 +1686,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index aed85aa..91ea869 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -46,6 +46,17 @@ import kotlin.jvm.optionals.getOrNull
  * lasers, fireworks, celebration). Effects are an iMessage-only feature — when the recipient is on
  * SMS/RCS the message is delivered without the animation. Effects are not supported in multipart
  * (`parts`) mode.
+ *
+ * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+ * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+ * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common — the
+ * message_id returned by an earlier send or surfaced on a `message.received` webhook), or `{
+ * "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where the
+ * parent wasn't recorded by Blooio. The reply must target the same chat and the same from-number as
+ * the new send, and the parent must be no older than 30 days (the iMessage on-device retention
+ * horizon). Reply support is iMessage-only and is rejected on Twilio, dashboard-Twilio, and hybrid
+ * send paths; it's also rejected on multi-message fan-outs (`text` array or per-part URL-balloon
+ * batch). See the `400` responses for the full set of `reply_target_*` error codes.
  */
 class MessageSendParams
 private constructor(
@@ -138,6 +149,18 @@ private constructor(
      */
     fun parts(): Optional<List<Part>> = body.parts()
 
+    /**
+     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
+     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
+     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
+     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
+     * reply on the recipient's device.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun replyTo(): Optional<ReplyTo> = body.replyTo()
+
     /**
      * If true, the contact card (Name & Photo) will be shared with this message. The contact card
      * is piggybacked onto the outgoing message. Defaults to false.
@@ -198,6 +221,13 @@ private constructor(
      */
     fun _parts(): JsonField<List<Part>> = body._parts()
 
+    /**
+     * Returns the raw JSON value of [replyTo].
+     *
+     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _replyTo(): JsonField<ReplyTo> = body._replyTo()
+
     /**
      * Returns the raw JSON value of [shareContact].
      *
@@ -421,6 +451,26 @@ private constructor(
          */
         fun addPart(part: Part) = apply { body.addPart(part) }
 
+        /**
+         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
+         * replying to messages received before the row was minted in Blooio). The new send is
+         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
+         * renders as an inline reply on the recipient's device.
+         */
+        fun replyTo(replyTo: ReplyTo?) = apply { body.replyTo(replyTo) }
+
+        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+        /**
+         * Sets [Builder.replyTo] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { body.replyTo(replyTo) }
+
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false.
@@ -633,6 +683,7 @@ private constructor(
         private val fromNumber: JsonField<String>,
         private val linkPreview: JsonField<LinkPreview>,
         private val parts: JsonField<List<Part>>,
+        private val replyTo: JsonField<ReplyTo>,
         private val shareContact: JsonField<Boolean>,
         private val text: JsonField<Text>,
         private val useTypingIndicator: JsonField<Boolean>,
@@ -652,6 +703,9 @@ private constructor(
             @ExcludeMissing
             linkPreview: JsonField<LinkPreview> = JsonMissing.of(),
             @JsonProperty("parts") @ExcludeMissing parts: JsonField<List<Part>> = JsonMissing.of(),
+            @JsonProperty("reply_to")
+            @ExcludeMissing
+            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("share_contact")
             @ExcludeMissing
             shareContact: JsonField<Boolean> = JsonMissing.of(),
@@ -665,6 +719,7 @@ private constructor(
             fromNumber,
             linkPreview,
             parts,
+            replyTo,
             shareContact,
             text,
             useTypingIndicator,
@@ -749,6 +804,18 @@ private constructor(
          */
         fun parts(): Optional<List<Part>> = parts.getOptional("parts")
 
+        /**
+         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
+         * replying to messages received before the row was minted in Blooio). The new send is
+         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
+         * renders as an inline reply on the recipient's device.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false.
@@ -817,6 +884,13 @@ private constructor(
          */
         @JsonProperty("parts") @ExcludeMissing fun _parts(): JsonField<List<Part>> = parts
 
+        /**
+         * Returns the raw JSON value of [replyTo].
+         *
+         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
         /**
          * Returns the raw JSON value of [shareContact].
          *
@@ -870,6 +944,7 @@ private constructor(
             private var fromNumber: JsonField<String> = JsonMissing.of()
             private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
             private var parts: JsonField<MutableList<Part>>? = null
+            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var shareContact: JsonField<Boolean> = JsonMissing.of()
             private var text: JsonField<Text> = JsonMissing.of()
             private var useTypingIndicator: JsonField<Boolean> = JsonMissing.of()
@@ -882,6 +957,7 @@ private constructor(
                 fromNumber = body.fromNumber
                 linkPreview = body.linkPreview
                 parts = body.parts.map { it.toMutableList() }
+                replyTo = body.replyTo
                 shareContact = body.shareContact
                 text = body.text
                 useTypingIndicator = body.useTypingIndicator
@@ -1045,6 +1121,27 @@ private constructor(
                     }
             }
 
+            /**
+             * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+             * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful
+             * for replying to messages received before the row was minted in Blooio). The new send
+             * is dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which
+             * iMessage renders as an inline reply on the recipient's device.
+             */
+            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+            /**
+             * Sets [Builder.replyTo] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
             /**
              * If true, the contact card (Name & Photo) will be shared with this message. The
              * contact card is piggybacked onto the outgoing message. Defaults to false.
@@ -1129,6 +1226,7 @@ private constructor(
                     fromNumber,
                     linkPreview,
                     (parts ?: JsonMissing.of()).map { it.toImmutable() },
+                    replyTo,
                     shareContact,
                     text,
                     useTypingIndicator,
@@ -1157,6 +1255,7 @@ private constructor(
             fromNumber()
             linkPreview().ifPresent { it.validate() }
             parts().ifPresent { it.forEach { it.validate() } }
+            replyTo().ifPresent { it.validate() }
             shareContact()
             text().ifPresent { it.validate() }
             useTypingIndicator()
@@ -1184,6 +1283,7 @@ private constructor(
                 (if (fromNumber.asKnown().isPresent) 1 else 0) +
                 (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
                 (parts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (shareContact.asKnown().isPresent) 1 else 0) +
                 (text.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (useTypingIndicator.asKnown().isPresent) 1 else 0)
@@ -1199,6 +1299,7 @@ private constructor(
                 fromNumber == other.fromNumber &&
                 linkPreview == other.linkPreview &&
                 parts == other.parts &&
+                replyTo == other.replyTo &&
                 shareContact == other.shareContact &&
                 text == other.text &&
                 useTypingIndicator == other.useTypingIndicator &&
@@ -1212,6 +1313,7 @@ private constructor(
                 fromNumber,
                 linkPreview,
                 parts,
+                replyTo,
                 shareContact,
                 text,
                 useTypingIndicator,
@@ -1222,7 +1324,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
+            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, replyTo=$replyTo, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
     }
 
     /** URL to the attachment */
@@ -2199,6 +2301,256 @@ private constructor(
             "Part{linkPreview=$linkPreview, mention=$mention, name=$name, text=$text, url=$url, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
+     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
+     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
+     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
+     * reply on the recipient's device.
+     */
+    class ReplyTo
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val guid: JsonField<String>,
+        private val messageId: JsonField<String>,
+        private val partIndex: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            messageId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            partIndex: JsonField<Long> = JsonMissing.of(),
+        ) : this(guid, messageId, partIndex, mutableMapOf())
+
+        /**
+         * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio attempts to
+         * look up the parent via `provider_message_guid`; if the parent isn't in our table the send
+         * still proceeds (Lava will thread on the device when possible) and the response carries
+         * `parent_unresolved: true`.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun guid(): Optional<String> = guid.getOptional("guid")
+
+        /**
+         * Blooio `message_id` of the parent. Must belong to the same chat, same from-number, and be
+         * no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+        /**
+         * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying to a
+         * single-part text message).
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun partIndex(): Optional<Long> = partIndex.getOptional("part_index")
+
+        /**
+         * Returns the raw JSON value of [guid].
+         *
+         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+        /**
+         * Returns the raw JSON value of [messageId].
+         *
+         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+        /**
+         * Returns the raw JSON value of [partIndex].
+         *
+         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [ReplyTo]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ReplyTo]. */
+        class Builder internal constructor() {
+
+            private var guid: JsonField<String> = JsonMissing.of()
+            private var messageId: JsonField<String> = JsonMissing.of()
+            private var partIndex: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(replyTo: ReplyTo) = apply {
+                guid = replyTo.guid
+                messageId = replyTo.messageId
+                partIndex = replyTo.partIndex
+                additionalProperties = replyTo.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio
+             * attempts to look up the parent via `provider_message_guid`; if the parent isn't in
+             * our table the send still proceeds (Lava will thread on the device when possible) and
+             * the response carries `parent_unresolved: true`.
+             */
+            fun guid(guid: String) = guid(JsonField.of(guid))
+
+            /**
+             * Sets [Builder.guid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+            /**
+             * Blooio `message_id` of the parent. Must belong to the same chat, same from-number,
+             * and be no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
+             */
+            fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+            /**
+             * Sets [Builder.messageId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+            /**
+             * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying
+             * to a single-part text message).
+             */
+            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+            /**
+             * Sets [Builder.partIndex] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ReplyTo].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): ReplyTo =
+                ReplyTo(guid, messageId, partIndex, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ReplyTo = apply {
+            if (validated) {
+                return@apply
+            }
+
+            guid()
+            messageId()
+            partIndex()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (guid.asKnown().isPresent) 1 else 0) +
+                (if (messageId.asKnown().isPresent) 1 else 0) +
+                (if (partIndex.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ReplyTo &&
+                guid == other.guid &&
+                messageId == other.messageId &&
+                partIndex == other.partIndex &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(guid, messageId, partIndex, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+    }
+
     /**
      * Message text. Can be a single string or array of strings (each becomes a separate message)
      */
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
index 9204c59..30b4213 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -28,6 +28,7 @@ private constructor(
     private val groupId: JsonField<String>,
     private val messageId: JsonField<String>,
     private val messageIds: JsonField<List<String>>,
+    private val parentUnresolved: JsonField<Boolean>,
     private val participants: JsonField<List<String>>,
     private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -44,6 +45,9 @@ private constructor(
         @JsonProperty("message_ids")
         @ExcludeMissing
         messageIds: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("parent_unresolved")
+        @ExcludeMissing
+        parentUnresolved: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("participants")
         @ExcludeMissing
         participants: JsonField<List<String>> = JsonMissing.of(),
@@ -54,6 +58,7 @@ private constructor(
         groupId,
         messageId,
         messageIds,
+        parentUnresolved,
         participants,
         status,
         mutableMapOf(),
@@ -100,6 +105,16 @@ private constructor(
      */
     fun messageIds(): Optional<List<String>> = messageIds.getOptional("message_ids")
 
+    /**
+     * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and the
+     * GUID didn't map to any Blooio-minted row. The send still proceeds and the device may still
+     * thread it; this flag signals that Blooio couldn't link the new message to a known parent.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parentUnresolved(): Optional<Boolean> = parentUnresolved.getOptional("parent_unresolved")
+
     /**
      * List of participants (present for multi-recipient)
      *
@@ -155,6 +170,16 @@ private constructor(
     @ExcludeMissing
     fun _messageIds(): JsonField<List<String>> = messageIds
 
+    /**
+     * Returns the raw JSON value of [parentUnresolved].
+     *
+     * Unlike [parentUnresolved], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("parent_unresolved")
+    @ExcludeMissing
+    fun _parentUnresolved(): JsonField<Boolean> = parentUnresolved
+
     /**
      * Returns the raw JSON value of [participants].
      *
@@ -197,6 +222,7 @@ private constructor(
         private var groupId: JsonField<String> = JsonMissing.of()
         private var messageId: JsonField<String> = JsonMissing.of()
         private var messageIds: JsonField<MutableList<String>>? = null
+        private var parentUnresolved: JsonField<Boolean> = JsonMissing.of()
         private var participants: JsonField<MutableList<String>>? = null
         private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -208,6 +234,7 @@ private constructor(
             groupId = messageSendResponse.groupId
             messageId = messageSendResponse.messageId
             messageIds = messageSendResponse.messageIds.map { it.toMutableList() }
+            parentUnresolved = messageSendResponse.parentUnresolved
             participants = messageSendResponse.participants.map { it.toMutableList() }
             status = messageSendResponse.status
             additionalProperties = messageSendResponse.additionalProperties.toMutableMap()
@@ -290,6 +317,26 @@ private constructor(
                 }
         }
 
+        /**
+         * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and
+         * the GUID didn't map to any Blooio-minted row. The send still proceeds and the device may
+         * still thread it; this flag signals that Blooio couldn't link the new message to a known
+         * parent.
+         */
+        fun parentUnresolved(parentUnresolved: Boolean) =
+            parentUnresolved(JsonField.of(parentUnresolved))
+
+        /**
+         * Sets [Builder.parentUnresolved] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parentUnresolved] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parentUnresolved(parentUnresolved: JsonField<Boolean>) = apply {
+            this.parentUnresolved = parentUnresolved
+        }
+
         /** List of participants (present for multi-recipient) */
         fun participants(participants: List<String>) = participants(JsonField.of(participants))
 
@@ -358,6 +405,7 @@ private constructor(
                 groupId,
                 messageId,
                 (messageIds ?: JsonMissing.of()).map { it.toImmutable() },
+                parentUnresolved,
                 (participants ?: JsonMissing.of()).map { it.toImmutable() },
                 status,
                 additionalProperties.toMutableMap(),
@@ -384,6 +432,7 @@ private constructor(
         groupId()
         messageId()
         messageIds()
+        parentUnresolved()
         participants()
         status().ifPresent { it.validate() }
         validated = true
@@ -409,6 +458,7 @@ private constructor(
             (if (groupId.asKnown().isPresent) 1 else 0) +
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (messageIds.asKnown().getOrNull()?.size ?: 0) +
+            (if (parentUnresolved.asKnown().isPresent) 1 else 0) +
             (participants.asKnown().getOrNull()?.size ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
@@ -558,6 +608,7 @@ private constructor(
             groupId == other.groupId &&
             messageId == other.messageId &&
             messageIds == other.messageIds &&
+            parentUnresolved == other.parentUnresolved &&
             participants == other.participants &&
             status == other.status &&
             additionalProperties == other.additionalProperties
@@ -570,6 +621,7 @@ private constructor(
             groupId,
             messageId,
             messageIds,
+            parentUnresolved,
             participants,
             status,
             additionalProperties,
@@ -579,5 +631,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
+        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, parentUnresolved=$parentUnresolved, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
index 411a07d..7c62793 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -162,6 +162,18 @@ interface MessageServiceAsync {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
+     *
+     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
+     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
+     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
+     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
+     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
+     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
+     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
+     * array or per-part URL-balloon batch). See the `400` responses for the full set of
+     * `reply_target_*` error codes.
      */
     fun send(chatId: String): CompletableFuture<MessageSendResponse> =
         send(chatId, MessageSendParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
index 6f2100e..861edcf 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -147,6 +147,18 @@ interface MessageService {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
+     *
+     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
+     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
+     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
+     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
+     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
+     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
+     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
+     * array or per-part URL-balloon batch). See the `400` responses for the full set of
+     * `reply_target_*` error codes.
      */
     fun send(chatId: String): MessageSendResponse = send(chatId, MessageSendParams.none())
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
index 921b646..c4fd065 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
@@ -34,6 +34,13 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
+                        .replyTo(
+                            MessageListResponse.Message.ReplyTo.builder()
+                                .guid("guid")
+                                .messageId("message_id")
+                                .partIndex(0L)
+                                .build()
+                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
@@ -63,6 +70,13 @@ internal class MessageListResponseTest {
                             .timeSent(0L)
                             .build()
                     )
+                    .replyTo(
+                        MessageListResponse.Message.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .sender("sender")
                     .status(MessageListResponse.Message.Status.PENDING)
                     .text("text")
@@ -97,6 +111,13 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
+                        .replyTo(
+                            MessageListResponse.Message.ReplyTo.builder()
+                                .guid("guid")
+                                .messageId("message_id")
+                                .partIndex(0L)
+                                .build()
+                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
index b50572d..c3d847f 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
@@ -37,6 +37,13 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
+                .replyTo(
+                    MessageRetrieveResponse.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
@@ -71,6 +78,14 @@ internal class MessageRetrieveResponseTest {
                     .timeSent(0L)
                     .build()
             )
+        assertThat(messageRetrieveResponse.replyTo())
+            .contains(
+                MessageRetrieveResponse.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
         assertThat(messageRetrieveResponse.sender()).contains("sender")
         assertThat(messageRetrieveResponse.status())
             .contains(MessageRetrieveResponse.Status.PENDING)
@@ -106,6 +121,13 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
+                .replyTo(
+                    MessageRetrieveResponse.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
index fd602ad..5e15a03 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
@@ -31,6 +31,13 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
+            .replyTo(
+                MessageSendParams.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
             .shareContact(true)
             .text("string")
             .useTypingIndicator(true)
@@ -72,6 +79,13 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
+                .replyTo(
+                    MessageSendParams.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -118,6 +132,13 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
+                .replyTo(
+                    MessageSendParams.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -143,6 +164,14 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
+        assertThat(body.replyTo())
+            .contains(
+                MessageSendParams.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
         assertThat(body.shareContact()).contains(true)
         assertThat(body.text()).contains(MessageSendParams.Text.ofString("string"))
         assertThat(body.useTypingIndicator()).contains(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
index 9bb1f1b..1b06a5e 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
@@ -19,6 +19,7 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
+                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
@@ -28,6 +29,7 @@ internal class MessageSendResponseTest {
         assertThat(messageSendResponse.groupId()).contains("group_id")
         assertThat(messageSendResponse.messageId()).contains("message_id")
         assertThat(messageSendResponse.messageIds().getOrNull()).containsExactly("string")
+        assertThat(messageSendResponse.parentUnresolved()).contains(true)
         assertThat(messageSendResponse.participants().getOrNull()).containsExactly("string")
         assertThat(messageSendResponse.status()).contains(MessageSendResponse.Status.QUEUED)
     }
@@ -42,6 +44,7 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
+                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
index 3a57799..40748f3 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
@@ -124,6 +124,13 @@ internal class MessageServiceAsyncTest {
                             .url("url")
                             .build()
                     )
+                    .replyTo(
+                        MessageSendParams.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
index 633bb81..da1b508 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
@@ -120,6 +120,13 @@ internal class MessageServiceTest {
                             .url("url")
                             .build()
                     )
+                    .replyTo(
+                        MessageSendParams.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)

From b2ef3c62456ee3161c147df9d4d2189d61ff51b8 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 23 May 2026 10:20:20 +0000
Subject: [PATCH 49/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../api/models/chats/ChatListResponse.kt      | 100 +++++++++++++++++-
 .../api/models/chats/ChatRetrieveResponse.kt  |  96 ++++++++++++++++-
 .../background/ChatBackgroundResponse.kt      |  65 +++++++++++-
 .../api/models/chats/ChatListResponseTest.kt  |   6 ++
 .../models/chats/ChatRetrieveResponseTest.kt  |   6 ++
 .../background/ChatBackgroundResponseTest.kt  |   3 +
 7 files changed, 274 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 8729928..77ef01e 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-23ac4ce198a5e8bffa1e5b9454a35bd0ca35a31d844f681d60e67cf4ff542411.yml
-openapi_spec_hash: e35cf6f966a4c18c696d1c453e40a809
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-81b1f2ba01495b54ab7b259e5cc92a6d6f114b26b8d41ffc4fee80d9f9b3db20.yml
+openapi_spec_hash: 173a216fb869614c676de670dfa814b5
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
index 35791ee..f306121 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
@@ -204,6 +204,8 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
+        private val backgroundId: JsonField<String>,
+        private val backgroundUrl: JsonField<String>,
         private val contact: JsonField<Contact>,
         private val groupId: JsonField<String>,
         private val groupName: JsonField<String>,
@@ -223,6 +225,12 @@ private constructor(
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("background_id")
+            @ExcludeMissing
+            backgroundId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("background_url")
+            @ExcludeMissing
+            backgroundUrl: JsonField<String> = JsonMissing.of(),
             @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
             @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
             @JsonProperty("group_name")
@@ -258,6 +266,8 @@ private constructor(
             @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
         ) : this(
             id,
+            backgroundId,
+            backgroundUrl,
             contact,
             groupId,
             groupName,
@@ -282,6 +292,22 @@ private constructor(
          */
         fun id(): Optional<String> = id.getOptional("id")
 
+        /**
+         * Identifier for the active chat background
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
+
+        /**
+         * Public URL of the chat background image (if one has been set via the API)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
         /**
          * Contact info (only for non-group chats)
          *
@@ -377,6 +403,26 @@ private constructor(
          */
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+        /**
+         * Returns the raw JSON value of [backgroundId].
+         *
+         * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("background_id")
+        @ExcludeMissing
+        fun _backgroundId(): JsonField<String> = backgroundId
+
+        /**
+         * Returns the raw JSON value of [backgroundUrl].
+         *
+         * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
         /**
          * Returns the raw JSON value of [contact].
          *
@@ -512,6 +558,8 @@ private constructor(
         class Builder internal constructor() {
 
             private var id: JsonField<String> = JsonMissing.of()
+            private var backgroundId: JsonField<String> = JsonMissing.of()
+            private var backgroundUrl: JsonField<String> = JsonMissing.of()
             private var contact: JsonField<Contact> = JsonMissing.of()
             private var groupId: JsonField<String> = JsonMissing.of()
             private var groupName: JsonField<String> = JsonMissing.of()
@@ -530,6 +578,8 @@ private constructor(
             @JvmSynthetic
             internal fun from(chat: Chat) = apply {
                 id = chat.id
+                backgroundId = chat.backgroundId
+                backgroundUrl = chat.backgroundUrl
                 contact = chat.contact
                 groupId = chat.groupId
                 groupName = chat.groupName
@@ -558,6 +608,44 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
+            /** Identifier for the active chat background */
+            fun backgroundId(backgroundId: String?) =
+                backgroundId(JsonField.ofNullable(backgroundId))
+
+            /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
+            fun backgroundId(backgroundId: Optional<String>) =
+                backgroundId(backgroundId.getOrNull())
+
+            /**
+             * Sets [Builder.backgroundId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.backgroundId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun backgroundId(backgroundId: JsonField<String>) = apply {
+                this.backgroundId = backgroundId
+            }
+
+            /** Public URL of the chat background image (if one has been set via the API) */
+            fun backgroundUrl(backgroundUrl: String?) =
+                backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+            /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+            fun backgroundUrl(backgroundUrl: Optional<String>) =
+                backgroundUrl(backgroundUrl.getOrNull())
+
+            /**
+             * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.backgroundUrl] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+                this.backgroundUrl = backgroundUrl
+            }
+
             /** Contact info (only for non-group chats) */
             fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -784,6 +872,8 @@ private constructor(
             fun build(): Chat =
                 Chat(
                     id,
+                    backgroundId,
+                    backgroundUrl,
                     contact,
                     groupId,
                     groupName,
@@ -818,6 +908,8 @@ private constructor(
             }
 
             id()
+            backgroundId()
+            backgroundUrl()
             contact().ifPresent { it.validate() }
             groupId()
             groupName()
@@ -851,6 +943,8 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (id.asKnown().isPresent) 1 else 0) +
+                (if (backgroundId.asKnown().isPresent) 1 else 0) +
+                (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
                 (contact.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (groupId.asKnown().isPresent) 1 else 0) +
                 (if (groupName.asKnown().isPresent) 1 else 0) +
@@ -1249,6 +1343,8 @@ private constructor(
 
             return other is Chat &&
                 id == other.id &&
+                backgroundId == other.backgroundId &&
+                backgroundUrl == other.backgroundUrl &&
                 contact == other.contact &&
                 groupId == other.groupId &&
                 groupName == other.groupName &&
@@ -1268,6 +1364,8 @@ private constructor(
         private val hashCode: Int by lazy {
             Objects.hash(
                 id,
+                backgroundId,
+                backgroundUrl,
                 contact,
                 groupId,
                 groupName,
@@ -1288,7 +1386,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Chat{id=$id, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+            "Chat{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
index 78f609c..6310bf3 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
@@ -21,6 +21,8 @@ class ChatRetrieveResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val id: JsonField<String>,
+    private val backgroundId: JsonField<String>,
+    private val backgroundUrl: JsonField<String>,
     private val contact: JsonField<Contact>,
     private val firstMessageTime: JsonField<Long>,
     private val groupId: JsonField<String>,
@@ -41,6 +43,12 @@ private constructor(
     @JsonCreator
     private constructor(
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_id")
+        @ExcludeMissing
+        backgroundId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
         @JsonProperty("first_message_time")
         @ExcludeMissing
@@ -75,6 +83,8 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
     ) : this(
         id,
+        backgroundId,
+        backgroundUrl,
         contact,
         firstMessageTime,
         groupId,
@@ -100,6 +110,22 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * Identifier for the active chat background
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
+
+    /**
+     * Public URL of the chat background image (if one has been set via the API)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
     /**
      * Contact info (only for non-group chats)
      *
@@ -201,6 +227,24 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [backgroundId].
+     *
+     * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_id")
+    @ExcludeMissing
+    fun _backgroundId(): JsonField<String> = backgroundId
+
+    /**
+     * Returns the raw JSON value of [backgroundUrl].
+     *
+     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_url")
+    @ExcludeMissing
+    fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
     /**
      * Returns the raw JSON value of [contact].
      *
@@ -339,6 +383,8 @@ private constructor(
     class Builder internal constructor() {
 
         private var id: JsonField<String> = JsonMissing.of()
+        private var backgroundId: JsonField<String> = JsonMissing.of()
+        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var contact: JsonField<Contact> = JsonMissing.of()
         private var firstMessageTime: JsonField<Long> = JsonMissing.of()
         private var groupId: JsonField<String> = JsonMissing.of()
@@ -358,6 +404,8 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatRetrieveResponse: ChatRetrieveResponse) = apply {
             id = chatRetrieveResponse.id
+            backgroundId = chatRetrieveResponse.backgroundId
+            backgroundUrl = chatRetrieveResponse.backgroundUrl
             contact = chatRetrieveResponse.contact
             firstMessageTime = chatRetrieveResponse.firstMessageTime
             groupId = chatRetrieveResponse.groupId
@@ -386,6 +434,42 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** Identifier for the active chat background */
+        fun backgroundId(backgroundId: String?) = backgroundId(JsonField.ofNullable(backgroundId))
+
+        /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
+        fun backgroundId(backgroundId: Optional<String>) = backgroundId(backgroundId.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundId(backgroundId: JsonField<String>) = apply {
+            this.backgroundId = backgroundId
+        }
+
+        /** Public URL of the chat background image (if one has been set via the API) */
+        fun backgroundUrl(backgroundUrl: String?) =
+            backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+        fun backgroundUrl(backgroundUrl: Optional<String>) =
+            backgroundUrl(backgroundUrl.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+            this.backgroundUrl = backgroundUrl
+        }
+
         /** Contact info (only for non-group chats) */
         fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -614,6 +698,8 @@ private constructor(
         fun build(): ChatRetrieveResponse =
             ChatRetrieveResponse(
                 id,
+                backgroundId,
+                backgroundUrl,
                 contact,
                 firstMessageTime,
                 groupId,
@@ -648,6 +734,8 @@ private constructor(
         }
 
         id()
+        backgroundId()
+        backgroundUrl()
         contact().ifPresent { it.validate() }
         firstMessageTime()
         groupId()
@@ -681,6 +769,8 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (id.asKnown().isPresent) 1 else 0) +
+            (if (backgroundId.asKnown().isPresent) 1 else 0) +
+            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (contact.asKnown().getOrNull()?.validity() ?: 0) +
             (if (firstMessageTime.asKnown().isPresent) 1 else 0) +
             (if (groupId.asKnown().isPresent) 1 else 0) +
@@ -1067,6 +1157,8 @@ private constructor(
 
         return other is ChatRetrieveResponse &&
             id == other.id &&
+            backgroundId == other.backgroundId &&
+            backgroundUrl == other.backgroundUrl &&
             contact == other.contact &&
             firstMessageTime == other.firstMessageTime &&
             groupId == other.groupId &&
@@ -1087,6 +1179,8 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             id,
+            backgroundId,
+            backgroundUrl,
             contact,
             firstMessageTime,
             groupId,
@@ -1108,5 +1202,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatRetrieveResponse{id=$id, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+        "ChatRetrieveResponse{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
index 1e35e39..2afde6d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
@@ -21,6 +21,7 @@ class ChatBackgroundResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val backgroundId: JsonField<String>,
+    private val backgroundUrl: JsonField<String>,
     private val backgroundVersion: JsonField<Long>,
     private val changed: JsonField<Boolean>,
     private val chatId: JsonField<String>,
@@ -33,6 +34,9 @@ private constructor(
         @JsonProperty("background_id")
         @ExcludeMissing
         backgroundId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("background_version")
         @ExcludeMissing
         backgroundVersion: JsonField<Long> = JsonMissing.of(),
@@ -41,7 +45,15 @@ private constructor(
         @JsonProperty("has_background")
         @ExcludeMissing
         hasBackground: JsonField<Boolean> = JsonMissing.of(),
-    ) : this(backgroundId, backgroundVersion, changed, chatId, hasBackground, mutableMapOf())
+    ) : this(
+        backgroundId,
+        backgroundUrl,
+        backgroundVersion,
+        changed,
+        chatId,
+        hasBackground,
+        mutableMapOf(),
+    )
 
     /**
      * Unique identifier for the current background, or null if none
@@ -51,6 +63,16 @@ private constructor(
      */
     fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
 
+    /**
+     * Public URL of the persisted background image stored in R2. Returned after a successful PUT
+     * and on GET when a background has been set through the API. May be null if persistence failed
+     * or the background was set outside of the API.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
     /**
      * Version number of the background (for cache invalidation)
      *
@@ -92,6 +114,15 @@ private constructor(
     @ExcludeMissing
     fun _backgroundId(): JsonField<String> = backgroundId
 
+    /**
+     * Returns the raw JSON value of [backgroundUrl].
+     *
+     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_url")
+    @ExcludeMissing
+    fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
     /**
      * Returns the raw JSON value of [backgroundVersion].
      *
@@ -147,6 +178,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var backgroundId: JsonField<String> = JsonMissing.of()
+        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var backgroundVersion: JsonField<Long> = JsonMissing.of()
         private var changed: JsonField<Boolean> = JsonMissing.of()
         private var chatId: JsonField<String> = JsonMissing.of()
@@ -156,6 +188,7 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatBackgroundResponse: ChatBackgroundResponse) = apply {
             backgroundId = chatBackgroundResponse.backgroundId
+            backgroundUrl = chatBackgroundResponse.backgroundUrl
             backgroundVersion = chatBackgroundResponse.backgroundVersion
             changed = chatBackgroundResponse.changed
             chatId = chatBackgroundResponse.chatId
@@ -180,6 +213,29 @@ private constructor(
             this.backgroundId = backgroundId
         }
 
+        /**
+         * Public URL of the persisted background image stored in R2. Returned after a successful
+         * PUT and on GET when a background has been set through the API. May be null if persistence
+         * failed or the background was set outside of the API.
+         */
+        fun backgroundUrl(backgroundUrl: String?) =
+            backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+        fun backgroundUrl(backgroundUrl: Optional<String>) =
+            backgroundUrl(backgroundUrl.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+            this.backgroundUrl = backgroundUrl
+        }
+
         /** Version number of the background (for cache invalidation) */
         fun backgroundVersion(backgroundVersion: Long?) =
             backgroundVersion(JsonField.ofNullable(backgroundVersion))
@@ -270,6 +326,7 @@ private constructor(
         fun build(): ChatBackgroundResponse =
             ChatBackgroundResponse(
                 backgroundId,
+                backgroundUrl,
                 backgroundVersion,
                 changed,
                 chatId,
@@ -294,6 +351,7 @@ private constructor(
         }
 
         backgroundId()
+        backgroundUrl()
         backgroundVersion()
         changed()
         chatId()
@@ -317,6 +375,7 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (backgroundId.asKnown().isPresent) 1 else 0) +
+            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (if (backgroundVersion.asKnown().isPresent) 1 else 0) +
             (if (changed.asKnown().isPresent) 1 else 0) +
             (if (chatId.asKnown().isPresent) 1 else 0) +
@@ -329,6 +388,7 @@ private constructor(
 
         return other is ChatBackgroundResponse &&
             backgroundId == other.backgroundId &&
+            backgroundUrl == other.backgroundUrl &&
             backgroundVersion == other.backgroundVersion &&
             changed == other.changed &&
             chatId == other.chatId &&
@@ -339,6 +399,7 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             backgroundId,
+            backgroundUrl,
             backgroundVersion,
             changed,
             chatId,
@@ -350,5 +411,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
+        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
index 76639bc..28b94e9 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
@@ -18,6 +18,8 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
+                        .backgroundId("background_id")
+                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
@@ -53,6 +55,8 @@ internal class ChatListResponseTest {
             .containsExactly(
                 ChatListResponse.Chat.builder()
                     .id("id")
+                    .backgroundId("background_id")
+                    .backgroundUrl("https://example.com")
                     .contact(
                         ChatListResponse.Chat.Contact.builder()
                             .contactId("contact_id")
@@ -93,6 +97,8 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
+                        .backgroundId("background_id")
+                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
index d83add3..bcb592b 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
@@ -14,6 +14,8 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
+                .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
@@ -44,6 +46,8 @@ internal class ChatRetrieveResponseTest {
                 .build()
 
         assertThat(chatRetrieveResponse.id()).contains("id")
+        assertThat(chatRetrieveResponse.backgroundId()).contains("background_id")
+        assertThat(chatRetrieveResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatRetrieveResponse.contact())
             .contains(
                 ChatRetrieveResponse.Contact.builder()
@@ -81,6 +85,8 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
+                .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
index 53e1631..b738138 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
@@ -14,6 +14,7 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")
@@ -21,6 +22,7 @@ internal class ChatBackgroundResponseTest {
                 .build()
 
         assertThat(chatBackgroundResponse.backgroundId()).contains("background_id")
+        assertThat(chatBackgroundResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatBackgroundResponse.backgroundVersion()).contains(0L)
         assertThat(chatBackgroundResponse.changed()).contains(true)
         assertThat(chatBackgroundResponse.chatId()).contains("chat_id")
@@ -33,6 +35,7 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")

From 242656c18bf53215a8064e1675aa1f8376d9c785 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 23 May 2026 20:20:20 +0000
Subject: [PATCH 50/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../api/models/chats/ChatListResponse.kt      | 100 +----
 .../api/models/chats/ChatRetrieveResponse.kt  |  96 +----
 .../chats/background/BackgroundSetParams.kt   |  62 ++-
 .../background/ChatBackgroundResponse.kt      |  65 +---
 .../chats/messages/MessageListResponse.kt     | 330 +---------------
 .../chats/messages/MessageRetrieveResponse.kt | 316 +---------------
 .../chats/messages/MessageSendParams.kt       | 354 +-----------------
 .../chats/messages/MessageSendResponse.kt     |  54 +--
 .../api/services/async/ChatServiceAsync.kt    |   4 +-
 .../services/async/ChatServiceAsyncImpl.kt    |   4 +-
 .../async/chats/BackgroundServiceAsync.kt     |  17 +-
 .../async/chats/BackgroundServiceAsyncImpl.kt |   2 +-
 .../async/chats/MessageServiceAsync.kt        |  12 -
 .../api/services/blocking/ChatService.kt      |   4 +-
 .../api/services/blocking/ChatServiceImpl.kt  |   4 +-
 .../blocking/chats/BackgroundService.kt       |  17 +-
 .../blocking/chats/BackgroundServiceImpl.kt   |   2 +-
 .../services/blocking/chats/MessageService.kt |  12 -
 .../api/models/chats/ChatListResponseTest.kt  |   6 -
 .../models/chats/ChatRetrieveResponseTest.kt  |   6 -
 .../background/ChatBackgroundResponseTest.kt  |   3 -
 .../chats/messages/MessageListResponseTest.kt |  21 --
 .../messages/MessageRetrieveResponseTest.kt   |  22 --
 .../chats/messages/MessageSendParamsTest.kt   |  29 --
 .../chats/messages/MessageSendResponseTest.kt |   3 -
 .../async/chats/MessageServiceAsyncTest.kt    |   7 -
 .../blocking/chats/MessageServiceTest.kt      |   7 -
 28 files changed, 97 insertions(+), 1466 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 77ef01e..36f5ef8 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-81b1f2ba01495b54ab7b259e5cc92a6d6f114b26b8d41ffc4fee80d9f9b3db20.yml
-openapi_spec_hash: 173a216fb869614c676de670dfa814b5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-164b95920b6f8c3bcf47d73fb582375e0e40e72a5d01a19ada82c19431b5853e.yml
+openapi_spec_hash: 988aee0a657a2411a646e306ed9e2e22
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
index f306121..35791ee 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
@@ -204,8 +204,6 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
-        private val backgroundId: JsonField<String>,
-        private val backgroundUrl: JsonField<String>,
         private val contact: JsonField<Contact>,
         private val groupId: JsonField<String>,
         private val groupName: JsonField<String>,
@@ -225,12 +223,6 @@ private constructor(
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("background_id")
-            @ExcludeMissing
-            backgroundId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("background_url")
-            @ExcludeMissing
-            backgroundUrl: JsonField<String> = JsonMissing.of(),
             @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
             @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
             @JsonProperty("group_name")
@@ -266,8 +258,6 @@ private constructor(
             @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
         ) : this(
             id,
-            backgroundId,
-            backgroundUrl,
             contact,
             groupId,
             groupName,
@@ -292,22 +282,6 @@ private constructor(
          */
         fun id(): Optional<String> = id.getOptional("id")
 
-        /**
-         * Identifier for the active chat background
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
-
-        /**
-         * Public URL of the chat background image (if one has been set via the API)
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
-
         /**
          * Contact info (only for non-group chats)
          *
@@ -403,26 +377,6 @@ private constructor(
          */
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-        /**
-         * Returns the raw JSON value of [backgroundId].
-         *
-         * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected
-         * type.
-         */
-        @JsonProperty("background_id")
-        @ExcludeMissing
-        fun _backgroundId(): JsonField<String> = backgroundId
-
-        /**
-         * Returns the raw JSON value of [backgroundUrl].
-         *
-         * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected
-         * type.
-         */
-        @JsonProperty("background_url")
-        @ExcludeMissing
-        fun _backgroundUrl(): JsonField<String> = backgroundUrl
-
         /**
          * Returns the raw JSON value of [contact].
          *
@@ -558,8 +512,6 @@ private constructor(
         class Builder internal constructor() {
 
             private var id: JsonField<String> = JsonMissing.of()
-            private var backgroundId: JsonField<String> = JsonMissing.of()
-            private var backgroundUrl: JsonField<String> = JsonMissing.of()
             private var contact: JsonField<Contact> = JsonMissing.of()
             private var groupId: JsonField<String> = JsonMissing.of()
             private var groupName: JsonField<String> = JsonMissing.of()
@@ -578,8 +530,6 @@ private constructor(
             @JvmSynthetic
             internal fun from(chat: Chat) = apply {
                 id = chat.id
-                backgroundId = chat.backgroundId
-                backgroundUrl = chat.backgroundUrl
                 contact = chat.contact
                 groupId = chat.groupId
                 groupName = chat.groupName
@@ -608,44 +558,6 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /** Identifier for the active chat background */
-            fun backgroundId(backgroundId: String?) =
-                backgroundId(JsonField.ofNullable(backgroundId))
-
-            /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
-            fun backgroundId(backgroundId: Optional<String>) =
-                backgroundId(backgroundId.getOrNull())
-
-            /**
-             * Sets [Builder.backgroundId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.backgroundId] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun backgroundId(backgroundId: JsonField<String>) = apply {
-                this.backgroundId = backgroundId
-            }
-
-            /** Public URL of the chat background image (if one has been set via the API) */
-            fun backgroundUrl(backgroundUrl: String?) =
-                backgroundUrl(JsonField.ofNullable(backgroundUrl))
-
-            /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
-            fun backgroundUrl(backgroundUrl: Optional<String>) =
-                backgroundUrl(backgroundUrl.getOrNull())
-
-            /**
-             * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.backgroundUrl] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
-                this.backgroundUrl = backgroundUrl
-            }
-
             /** Contact info (only for non-group chats) */
             fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -872,8 +784,6 @@ private constructor(
             fun build(): Chat =
                 Chat(
                     id,
-                    backgroundId,
-                    backgroundUrl,
                     contact,
                     groupId,
                     groupName,
@@ -908,8 +818,6 @@ private constructor(
             }
 
             id()
-            backgroundId()
-            backgroundUrl()
             contact().ifPresent { it.validate() }
             groupId()
             groupName()
@@ -943,8 +851,6 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (id.asKnown().isPresent) 1 else 0) +
-                (if (backgroundId.asKnown().isPresent) 1 else 0) +
-                (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
                 (contact.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (groupId.asKnown().isPresent) 1 else 0) +
                 (if (groupName.asKnown().isPresent) 1 else 0) +
@@ -1343,8 +1249,6 @@ private constructor(
 
             return other is Chat &&
                 id == other.id &&
-                backgroundId == other.backgroundId &&
-                backgroundUrl == other.backgroundUrl &&
                 contact == other.contact &&
                 groupId == other.groupId &&
                 groupName == other.groupName &&
@@ -1364,8 +1268,6 @@ private constructor(
         private val hashCode: Int by lazy {
             Objects.hash(
                 id,
-                backgroundId,
-                backgroundUrl,
                 contact,
                 groupId,
                 groupName,
@@ -1386,7 +1288,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Chat{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+            "Chat{id=$id, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
index 6310bf3..78f609c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
@@ -21,8 +21,6 @@ class ChatRetrieveResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val id: JsonField<String>,
-    private val backgroundId: JsonField<String>,
-    private val backgroundUrl: JsonField<String>,
     private val contact: JsonField<Contact>,
     private val firstMessageTime: JsonField<Long>,
     private val groupId: JsonField<String>,
@@ -43,12 +41,6 @@ private constructor(
     @JsonCreator
     private constructor(
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("background_id")
-        @ExcludeMissing
-        backgroundId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("background_url")
-        @ExcludeMissing
-        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
         @JsonProperty("first_message_time")
         @ExcludeMissing
@@ -83,8 +75,6 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
     ) : this(
         id,
-        backgroundId,
-        backgroundUrl,
         contact,
         firstMessageTime,
         groupId,
@@ -110,22 +100,6 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
-    /**
-     * Identifier for the active chat background
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
-
-    /**
-     * Public URL of the chat background image (if one has been set via the API)
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
-
     /**
      * Contact info (only for non-group chats)
      *
@@ -227,24 +201,6 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-    /**
-     * Returns the raw JSON value of [backgroundId].
-     *
-     * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("background_id")
-    @ExcludeMissing
-    fun _backgroundId(): JsonField<String> = backgroundId
-
-    /**
-     * Returns the raw JSON value of [backgroundUrl].
-     *
-     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("background_url")
-    @ExcludeMissing
-    fun _backgroundUrl(): JsonField<String> = backgroundUrl
-
     /**
      * Returns the raw JSON value of [contact].
      *
@@ -383,8 +339,6 @@ private constructor(
     class Builder internal constructor() {
 
         private var id: JsonField<String> = JsonMissing.of()
-        private var backgroundId: JsonField<String> = JsonMissing.of()
-        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var contact: JsonField<Contact> = JsonMissing.of()
         private var firstMessageTime: JsonField<Long> = JsonMissing.of()
         private var groupId: JsonField<String> = JsonMissing.of()
@@ -404,8 +358,6 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatRetrieveResponse: ChatRetrieveResponse) = apply {
             id = chatRetrieveResponse.id
-            backgroundId = chatRetrieveResponse.backgroundId
-            backgroundUrl = chatRetrieveResponse.backgroundUrl
             contact = chatRetrieveResponse.contact
             firstMessageTime = chatRetrieveResponse.firstMessageTime
             groupId = chatRetrieveResponse.groupId
@@ -434,42 +386,6 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
-        /** Identifier for the active chat background */
-        fun backgroundId(backgroundId: String?) = backgroundId(JsonField.ofNullable(backgroundId))
-
-        /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
-        fun backgroundId(backgroundId: Optional<String>) = backgroundId(backgroundId.getOrNull())
-
-        /**
-         * Sets [Builder.backgroundId] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.backgroundId] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun backgroundId(backgroundId: JsonField<String>) = apply {
-            this.backgroundId = backgroundId
-        }
-
-        /** Public URL of the chat background image (if one has been set via the API) */
-        fun backgroundUrl(backgroundUrl: String?) =
-            backgroundUrl(JsonField.ofNullable(backgroundUrl))
-
-        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
-        fun backgroundUrl(backgroundUrl: Optional<String>) =
-            backgroundUrl(backgroundUrl.getOrNull())
-
-        /**
-         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
-            this.backgroundUrl = backgroundUrl
-        }
-
         /** Contact info (only for non-group chats) */
         fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -698,8 +614,6 @@ private constructor(
         fun build(): ChatRetrieveResponse =
             ChatRetrieveResponse(
                 id,
-                backgroundId,
-                backgroundUrl,
                 contact,
                 firstMessageTime,
                 groupId,
@@ -734,8 +648,6 @@ private constructor(
         }
 
         id()
-        backgroundId()
-        backgroundUrl()
         contact().ifPresent { it.validate() }
         firstMessageTime()
         groupId()
@@ -769,8 +681,6 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (id.asKnown().isPresent) 1 else 0) +
-            (if (backgroundId.asKnown().isPresent) 1 else 0) +
-            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (contact.asKnown().getOrNull()?.validity() ?: 0) +
             (if (firstMessageTime.asKnown().isPresent) 1 else 0) +
             (if (groupId.asKnown().isPresent) 1 else 0) +
@@ -1157,8 +1067,6 @@ private constructor(
 
         return other is ChatRetrieveResponse &&
             id == other.id &&
-            backgroundId == other.backgroundId &&
-            backgroundUrl == other.backgroundUrl &&
             contact == other.contact &&
             firstMessageTime == other.firstMessageTime &&
             groupId == other.groupId &&
@@ -1179,8 +1087,6 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             id,
-            backgroundId,
-            backgroundUrl,
             contact,
             firstMessageTime,
             groupId,
@@ -1202,5 +1108,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatRetrieveResponse{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+        "ChatRetrieveResponse{id=$id, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
index af51c69..0893718 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
@@ -26,9 +26,18 @@ import kotlin.jvm.optionals.getOrNull
 /**
  * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
  *
- * The uploaded image is converted into a PosterKit-compatible archive and applied to the iMessage
- * conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP, HEIC/HEIF. Maximum
- * file size: 10 MB.
+ * The request body must be `multipart/form-data` with a single `background` field containing the
+ * **raw image file bytes** (not a URL or base64 string). Supported formats: JPEG, PNG, GIF, WebP,
+ * HEIC/HEIF. Maximum file size: 10 MB.
+ *
+ * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
+ * ```bash
+ * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+ *   -H "Authorization: Bearer YOUR_API_KEY" \
+ *   -F "background=@/path/to/image.jpg;type=image/jpeg"
+ * ```
+ *
+ * When the chat id is a phone number, percent-encode the leading `+` as `%2B` in the URL path.
  */
 class BackgroundSetParams
 private constructor(
@@ -41,7 +50,9 @@ private constructor(
     fun chatId(): Optional<String> = Optional.ofNullable(chatId)
 
     /**
-     * The image file to set as the chat background
+     * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file field
+     * in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with curl, or a
+     * `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or base64 string.
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -108,7 +119,11 @@ private constructor(
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
-        /** The image file to set as the chat background */
+        /**
+         * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+         * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with curl, or
+         * a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or base64 string.
+         */
         fun background(background: InputStream) = apply { body.background(background) }
 
         /**
@@ -122,10 +137,18 @@ private constructor(
             body.background(background)
         }
 
-        /** The image file to set as the chat background */
+        /**
+         * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+         * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with curl, or
+         * a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or base64 string.
+         */
         fun background(background: ByteArray) = apply { body.background(background) }
 
-        /** The image file to set as the chat background */
+        /**
+         * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+         * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with curl, or
+         * a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or base64 string.
+         */
         fun background(path: Path) = apply { body.background(path) }
 
         fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
@@ -288,7 +311,9 @@ private constructor(
     ) {
 
         /**
-         * The image file to set as the chat background
+         * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+         * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with curl, or
+         * a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or base64 string.
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -342,7 +367,12 @@ private constructor(
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
-            /** The image file to set as the chat background */
+            /**
+             * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+             * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with
+             * curl, or a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or
+             * base64 string.
+             */
             fun background(background: InputStream) = background(MultipartField.of(background))
 
             /**
@@ -356,10 +386,20 @@ private constructor(
                 this.background = background
             }
 
-            /** The image file to set as the chat background */
+            /**
+             * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+             * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with
+             * curl, or a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or
+             * base64 string.
+             */
             fun background(background: ByteArray) = background(background.inputStream())
 
-            /** The image file to set as the chat background */
+            /**
+             * Binary image file upload (JPEG, PNG, GIF, WebP, HEIC/HEIF, max 10 MB). Send as a file
+             * field in `multipart/form-data` — e.g. `-F "background=@/path/to/image.jpg"` with
+             * curl, or a `File`/`Blob` appended to `FormData` in JavaScript. Do NOT send a URL or
+             * base64 string.
+             */
             fun background(path: Path) =
                 background(
                     MultipartField.builder<InputStream>()
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
index 2afde6d..1e35e39 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
@@ -21,7 +21,6 @@ class ChatBackgroundResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val backgroundId: JsonField<String>,
-    private val backgroundUrl: JsonField<String>,
     private val backgroundVersion: JsonField<Long>,
     private val changed: JsonField<Boolean>,
     private val chatId: JsonField<String>,
@@ -34,9 +33,6 @@ private constructor(
         @JsonProperty("background_id")
         @ExcludeMissing
         backgroundId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("background_url")
-        @ExcludeMissing
-        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("background_version")
         @ExcludeMissing
         backgroundVersion: JsonField<Long> = JsonMissing.of(),
@@ -45,15 +41,7 @@ private constructor(
         @JsonProperty("has_background")
         @ExcludeMissing
         hasBackground: JsonField<Boolean> = JsonMissing.of(),
-    ) : this(
-        backgroundId,
-        backgroundUrl,
-        backgroundVersion,
-        changed,
-        chatId,
-        hasBackground,
-        mutableMapOf(),
-    )
+    ) : this(backgroundId, backgroundVersion, changed, chatId, hasBackground, mutableMapOf())
 
     /**
      * Unique identifier for the current background, or null if none
@@ -63,16 +51,6 @@ private constructor(
      */
     fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
 
-    /**
-     * Public URL of the persisted background image stored in R2. Returned after a successful PUT
-     * and on GET when a background has been set through the API. May be null if persistence failed
-     * or the background was set outside of the API.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
-
     /**
      * Version number of the background (for cache invalidation)
      *
@@ -114,15 +92,6 @@ private constructor(
     @ExcludeMissing
     fun _backgroundId(): JsonField<String> = backgroundId
 
-    /**
-     * Returns the raw JSON value of [backgroundUrl].
-     *
-     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("background_url")
-    @ExcludeMissing
-    fun _backgroundUrl(): JsonField<String> = backgroundUrl
-
     /**
      * Returns the raw JSON value of [backgroundVersion].
      *
@@ -178,7 +147,6 @@ private constructor(
     class Builder internal constructor() {
 
         private var backgroundId: JsonField<String> = JsonMissing.of()
-        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var backgroundVersion: JsonField<Long> = JsonMissing.of()
         private var changed: JsonField<Boolean> = JsonMissing.of()
         private var chatId: JsonField<String> = JsonMissing.of()
@@ -188,7 +156,6 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatBackgroundResponse: ChatBackgroundResponse) = apply {
             backgroundId = chatBackgroundResponse.backgroundId
-            backgroundUrl = chatBackgroundResponse.backgroundUrl
             backgroundVersion = chatBackgroundResponse.backgroundVersion
             changed = chatBackgroundResponse.changed
             chatId = chatBackgroundResponse.chatId
@@ -213,29 +180,6 @@ private constructor(
             this.backgroundId = backgroundId
         }
 
-        /**
-         * Public URL of the persisted background image stored in R2. Returned after a successful
-         * PUT and on GET when a background has been set through the API. May be null if persistence
-         * failed or the background was set outside of the API.
-         */
-        fun backgroundUrl(backgroundUrl: String?) =
-            backgroundUrl(JsonField.ofNullable(backgroundUrl))
-
-        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
-        fun backgroundUrl(backgroundUrl: Optional<String>) =
-            backgroundUrl(backgroundUrl.getOrNull())
-
-        /**
-         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
-            this.backgroundUrl = backgroundUrl
-        }
-
         /** Version number of the background (for cache invalidation) */
         fun backgroundVersion(backgroundVersion: Long?) =
             backgroundVersion(JsonField.ofNullable(backgroundVersion))
@@ -326,7 +270,6 @@ private constructor(
         fun build(): ChatBackgroundResponse =
             ChatBackgroundResponse(
                 backgroundId,
-                backgroundUrl,
                 backgroundVersion,
                 changed,
                 chatId,
@@ -351,7 +294,6 @@ private constructor(
         }
 
         backgroundId()
-        backgroundUrl()
         backgroundVersion()
         changed()
         chatId()
@@ -375,7 +317,6 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (backgroundId.asKnown().isPresent) 1 else 0) +
-            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (if (backgroundVersion.asKnown().isPresent) 1 else 0) +
             (if (changed.asKnown().isPresent) 1 else 0) +
             (if (chatId.asKnown().isPresent) 1 else 0) +
@@ -388,7 +329,6 @@ private constructor(
 
         return other is ChatBackgroundResponse &&
             backgroundId == other.backgroundId &&
-            backgroundUrl == other.backgroundUrl &&
             backgroundVersion == other.backgroundVersion &&
             changed == other.changed &&
             chatId == other.chatId &&
@@ -399,7 +339,6 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             backgroundId,
-            backgroundUrl,
             backgroundVersion,
             changed,
             chatId,
@@ -411,5 +350,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
+        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
index 90a1f3a..2a496eb 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -8,7 +8,6 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
-import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.blooio.api.models.contacts.Pagination
@@ -246,7 +245,6 @@ private constructor(
         private val messageId: JsonField<String>,
         private val protocol: JsonField<Protocol>,
         private val reactions: JsonField<List<Reaction>>,
-        private val replyTo: JsonField<ReplyTo>,
         private val sender: JsonField<String>,
         private val status: JsonField<Status>,
         private val text: JsonField<String>,
@@ -279,9 +277,6 @@ private constructor(
             @JsonProperty("reactions")
             @ExcludeMissing
             reactions: JsonField<List<Reaction>> = JsonMissing.of(),
-            @JsonProperty("reply_to")
-            @ExcludeMissing
-            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
             @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
             @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -298,7 +293,6 @@ private constructor(
             messageId,
             protocol,
             reactions,
-            replyTo,
             sender,
             status,
             text,
@@ -361,15 +355,6 @@ private constructor(
          */
         fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
-        /**
-         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
-         * every GET endpoint that returns a single message or a list of messages.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
-
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -469,13 +454,6 @@ private constructor(
         @ExcludeMissing
         fun _reactions(): JsonField<List<Reaction>> = reactions
 
-        /**
-         * Returns the raw JSON value of [replyTo].
-         *
-         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
-
         /**
          * Returns the raw JSON value of [sender].
          *
@@ -543,7 +521,6 @@ private constructor(
             private var messageId: JsonField<String> = JsonMissing.of()
             private var protocol: JsonField<Protocol> = JsonMissing.of()
             private var reactions: JsonField<MutableList<Reaction>>? = null
-            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var sender: JsonField<String> = JsonMissing.of()
             private var status: JsonField<Status> = JsonMissing.of()
             private var text: JsonField<String> = JsonMissing.of()
@@ -561,7 +538,6 @@ private constructor(
                 messageId = message.messageId
                 protocol = message.protocol
                 reactions = message.reactions.map { it.toMutableList() }
-                replyTo = message.replyTo
                 sender = message.sender
                 status = message.status
                 text = message.text
@@ -698,24 +674,6 @@ private constructor(
                     }
             }
 
-            /**
-             * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
-             * every GET endpoint that returns a single message or a list of messages.
-             */
-            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
-
-            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
-            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
-
-            /**
-             * Sets [Builder.replyTo] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
-
             /**
              * Sender's phone number or email for inbound group messages. Null for outbound messages
              * and 1-1 chats.
@@ -832,7 +790,6 @@ private constructor(
                     messageId,
                     protocol,
                     (reactions ?: JsonMissing.of()).map { it.toImmutable() },
-                    replyTo,
                     sender,
                     status,
                     text,
@@ -866,7 +823,6 @@ private constructor(
             messageId()
             protocol().ifPresent { it.validate() }
             reactions().ifPresent { it.forEach { it.validate() } }
-            replyTo().ifPresent { it.validate() }
             sender()
             status().ifPresent { it.validate() }
             text()
@@ -899,7 +855,6 @@ private constructor(
                 (if (messageId.asKnown().isPresent) 1 else 0) +
                 (protocol.asKnown().getOrNull()?.validity() ?: 0) +
                 (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (sender.asKnown().isPresent) 1 else 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (text.asKnown().isPresent) 1 else 0) +
@@ -1199,287 +1154,6 @@ private constructor(
             override fun toString() = value.toString()
         }
 
-        /**
-         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
-         * every GET endpoint that returns a single message or a list of messages.
-         */
-        class ReplyTo
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val guid: JsonField<String>,
-            private val messageId: JsonField<String>,
-            private val partIndex: JsonField<Long>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
-
-            @JsonCreator
-            private constructor(
-                @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("message_id")
-                @ExcludeMissing
-                messageId: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("part_index")
-                @ExcludeMissing
-                partIndex: JsonField<Long> = JsonMissing.of(),
-            ) : this(guid, messageId, partIndex, mutableMapOf())
-
-            /**
-             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
-             * on-device record-of-truth identifier that survives even when `message_id` cannot be
-             * resolved.
-             *
-             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun guid(): Optional<String> = guid.getOptional("guid")
-
-            /**
-             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
-             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
-             *
-             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun messageId(): Optional<String> = messageId.getOptional("message_id")
-
-            /**
-             * Which part of the parent was replied to. 0 for the common single-part case.
-             *
-             * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun partIndex(): Long = partIndex.getRequired("part_index")
-
-            /**
-             * Returns the raw JSON value of [guid].
-             *
-             * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
-
-            /**
-             * Returns the raw JSON value of [messageId].
-             *
-             * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("message_id")
-            @ExcludeMissing
-            fun _messageId(): JsonField<String> = messageId
-
-            /**
-             * Returns the raw JSON value of [partIndex].
-             *
-             * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("part_index")
-            @ExcludeMissing
-            fun _partIndex(): JsonField<Long> = partIndex
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
-
-            fun toBuilder() = Builder().from(this)
-
-            companion object {
-
-                /**
-                 * Returns a mutable builder for constructing an instance of [ReplyTo].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .guid()
-                 * .messageId()
-                 * .partIndex()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
-            }
-
-            /** A builder for [ReplyTo]. */
-            class Builder internal constructor() {
-
-                private var guid: JsonField<String>? = null
-                private var messageId: JsonField<String>? = null
-                private var partIndex: JsonField<Long>? = null
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(replyTo: ReplyTo) = apply {
-                    guid = replyTo.guid
-                    messageId = replyTo.messageId
-                    partIndex = replyTo.partIndex
-                    additionalProperties = replyTo.additionalProperties.toMutableMap()
-                }
-
-                /**
-                 * The raw iMessage GUID of the parent. Always populated on real inline replies; the
-                 * on-device record-of-truth identifier that survives even when `message_id` cannot
-                 * be resolved.
-                 */
-                fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
-
-                /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
-                fun guid(guid: Optional<String>) = guid(guid.getOrNull())
-
-                /**
-                 * Sets [Builder.guid] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.guid] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun guid(guid: JsonField<String>) = apply { this.guid = guid }
-
-                /**
-                 * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
-                 * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
-                 */
-                fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
-
-                /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
-                fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
-
-                /**
-                 * Sets [Builder.messageId] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.messageId] with a well-typed [String] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
-
-                /** Which part of the parent was replied to. 0 for the common single-part case. */
-                fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
-
-                /**
-                 * Sets [Builder.partIndex] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.partIndex] with a well-typed [Long] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
-
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
-
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
-
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
-
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
-
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [ReplyTo].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .guid()
-                 * .messageId()
-                 * .partIndex()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): ReplyTo =
-                    ReplyTo(
-                        checkRequired("guid", guid),
-                        checkRequired("messageId", messageId),
-                        checkRequired("partIndex", partIndex),
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
-             */
-            fun validate(): ReplyTo = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                guid()
-                messageId()
-                partIndex()
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: BlooioInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (guid.asKnown().isPresent) 1 else 0) +
-                    (if (messageId.asKnown().isPresent) 1 else 0) +
-                    (if (partIndex.asKnown().isPresent) 1 else 0)
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is ReplyTo &&
-                    guid == other.guid &&
-                    messageId == other.messageId &&
-                    partIndex == other.partIndex &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(guid, messageId, partIndex, additionalProperties)
-            }
-
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
-        }
-
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -1663,7 +1337,6 @@ private constructor(
                 messageId == other.messageId &&
                 protocol == other.protocol &&
                 reactions == other.reactions &&
-                replyTo == other.replyTo &&
                 sender == other.sender &&
                 status == other.status &&
                 text == other.text &&
@@ -1682,7 +1355,6 @@ private constructor(
                 messageId,
                 protocol,
                 reactions,
-                replyTo,
                 sender,
                 status,
                 text,
@@ -1695,7 +1367,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
index f7170a1..165f086 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -8,7 +8,6 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
-import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.fasterxml.jackson.annotation.JsonAnyGetter
@@ -32,7 +31,6 @@ private constructor(
     private val messageId: JsonField<String>,
     private val protocol: JsonField<Protocol>,
     private val reactions: JsonField<List<Reaction>>,
-    private val replyTo: JsonField<ReplyTo>,
     private val sender: JsonField<String>,
     private val status: JsonField<Status>,
     private val text: JsonField<String>,
@@ -60,7 +58,6 @@ private constructor(
         @JsonProperty("reactions")
         @ExcludeMissing
         reactions: JsonField<List<Reaction>> = JsonMissing.of(),
-        @JsonProperty("reply_to") @ExcludeMissing replyTo: JsonField<ReplyTo> = JsonMissing.of(),
         @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -78,7 +75,6 @@ private constructor(
         messageId,
         protocol,
         reactions,
-        replyTo,
         sender,
         status,
         text,
@@ -145,15 +141,6 @@ private constructor(
      */
     fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
-    /**
-     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
-     * GET endpoint that returns a single message or a list of messages.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
-
     /**
      * Sender's phone number or email for inbound group messages. Null for outbound messages and 1-1
      * chats.
@@ -254,13 +241,6 @@ private constructor(
     @ExcludeMissing
     fun _reactions(): JsonField<List<Reaction>> = reactions
 
-    /**
-     * Returns the raw JSON value of [replyTo].
-     *
-     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
-
     /**
      * Returns the raw JSON value of [sender].
      *
@@ -328,7 +308,6 @@ private constructor(
         private var messageId: JsonField<String> = JsonMissing.of()
         private var protocol: JsonField<Protocol> = JsonMissing.of()
         private var reactions: JsonField<MutableList<Reaction>>? = null
-        private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
         private var sender: JsonField<String> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
         private var text: JsonField<String> = JsonMissing.of()
@@ -347,7 +326,6 @@ private constructor(
             messageId = messageRetrieveResponse.messageId
             protocol = messageRetrieveResponse.protocol
             reactions = messageRetrieveResponse.reactions.map { it.toMutableList() }
-            replyTo = messageRetrieveResponse.replyTo
             sender = messageRetrieveResponse.sender
             status = messageRetrieveResponse.status
             text = messageRetrieveResponse.text
@@ -494,23 +472,6 @@ private constructor(
                 }
         }
 
-        /**
-         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
-         * every GET endpoint that returns a single message or a list of messages.
-         */
-        fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
-
-        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
-        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
-
-        /**
-         * Sets [Builder.replyTo] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
-         */
-        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
-
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -622,7 +583,6 @@ private constructor(
                 messageId,
                 protocol,
                 (reactions ?: JsonMissing.of()).map { it.toImmutable() },
-                replyTo,
                 sender,
                 status,
                 text,
@@ -656,7 +616,6 @@ private constructor(
         messageId()
         protocol().ifPresent { it.validate() }
         reactions().ifPresent { it.forEach { it.validate() } }
-        replyTo().ifPresent { it.validate() }
         sender()
         status().ifPresent { it.validate() }
         text()
@@ -689,7 +648,6 @@ private constructor(
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (protocol.asKnown().getOrNull()?.validity() ?: 0) +
             (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-            (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
             (if (sender.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (text.asKnown().isPresent) 1 else 0) +
@@ -1204,276 +1162,6 @@ private constructor(
         override fun toString() = value.toString()
     }
 
-    /**
-     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
-     * GET endpoint that returns a single message or a list of messages.
-     */
-    class ReplyTo
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val guid: JsonField<String>,
-        private val messageId: JsonField<String>,
-        private val partIndex: JsonField<Long>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
-
-        @JsonCreator
-        private constructor(
-            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("message_id")
-            @ExcludeMissing
-            messageId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("part_index")
-            @ExcludeMissing
-            partIndex: JsonField<Long> = JsonMissing.of(),
-        ) : this(guid, messageId, partIndex, mutableMapOf())
-
-        /**
-         * The raw iMessage GUID of the parent. Always populated on real inline replies; the
-         * on-device record-of-truth identifier that survives even when `message_id` cannot be
-         * resolved.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun guid(): Optional<String> = guid.getOptional("guid")
-
-        /**
-         * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
-         * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun messageId(): Optional<String> = messageId.getOptional("message_id")
-
-        /**
-         * Which part of the parent was replied to. 0 for the common single-part case.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun partIndex(): Long = partIndex.getRequired("part_index")
-
-        /**
-         * Returns the raw JSON value of [guid].
-         *
-         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
-
-        /**
-         * Returns the raw JSON value of [messageId].
-         *
-         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
-
-        /**
-         * Returns the raw JSON value of [partIndex].
-         *
-         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
-
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
-
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
-
-        fun toBuilder() = Builder().from(this)
-
-        companion object {
-
-            /**
-             * Returns a mutable builder for constructing an instance of [ReplyTo].
-             *
-             * The following fields are required:
-             * ```java
-             * .guid()
-             * .messageId()
-             * .partIndex()
-             * ```
-             */
-            @JvmStatic fun builder() = Builder()
-        }
-
-        /** A builder for [ReplyTo]. */
-        class Builder internal constructor() {
-
-            private var guid: JsonField<String>? = null
-            private var messageId: JsonField<String>? = null
-            private var partIndex: JsonField<Long>? = null
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-            @JvmSynthetic
-            internal fun from(replyTo: ReplyTo) = apply {
-                guid = replyTo.guid
-                messageId = replyTo.messageId
-                partIndex = replyTo.partIndex
-                additionalProperties = replyTo.additionalProperties.toMutableMap()
-            }
-
-            /**
-             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
-             * on-device record-of-truth identifier that survives even when `message_id` cannot be
-             * resolved.
-             */
-            fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
-
-            /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
-            fun guid(guid: Optional<String>) = guid(guid.getOrNull())
-
-            /**
-             * Sets [Builder.guid] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
-
-            /**
-             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
-             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
-             */
-            fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
-
-            /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
-            fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
-
-            /**
-             * Sets [Builder.messageId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
-
-            /** Which part of the parent was replied to. 0 for the common single-part case. */
-            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
-
-            /**
-             * Sets [Builder.partIndex] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
-
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
-
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
-
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
-
-            /**
-             * Returns an immutable instance of [ReplyTo].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             *
-             * The following fields are required:
-             * ```java
-             * .guid()
-             * .messageId()
-             * .partIndex()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
-             */
-            fun build(): ReplyTo =
-                ReplyTo(
-                    checkRequired("guid", guid),
-                    checkRequired("messageId", messageId),
-                    checkRequired("partIndex", partIndex),
-                    additionalProperties.toMutableMap(),
-                )
-        }
-
-        private var validated: Boolean = false
-
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ReplyTo = apply {
-            if (validated) {
-                return@apply
-            }
-
-            guid()
-            messageId()
-            partIndex()
-            validated = true
-        }
-
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: BlooioInvalidDataException) {
-                false
-            }
-
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (guid.asKnown().isPresent) 1 else 0) +
-                (if (messageId.asKnown().isPresent) 1 else 0) +
-                (if (partIndex.asKnown().isPresent) 1 else 0)
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
-
-            return other is ReplyTo &&
-                guid == other.guid &&
-                messageId == other.messageId &&
-                partIndex == other.partIndex &&
-                additionalProperties == other.additionalProperties
-        }
-
-        private val hashCode: Int by lazy {
-            Objects.hash(guid, messageId, partIndex, additionalProperties)
-        }
-
-        override fun hashCode(): Int = hashCode
-
-        override fun toString() =
-            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
-    }
-
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -1653,7 +1341,6 @@ private constructor(
             messageId == other.messageId &&
             protocol == other.protocol &&
             reactions == other.reactions &&
-            replyTo == other.replyTo &&
             sender == other.sender &&
             status == other.status &&
             text == other.text &&
@@ -1673,7 +1360,6 @@ private constructor(
             messageId,
             protocol,
             reactions,
-            replyTo,
             sender,
             status,
             text,
@@ -1686,5 +1372,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index 91ea869..aed85aa 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -46,17 +46,6 @@ import kotlin.jvm.optionals.getOrNull
  * lasers, fireworks, celebration). Effects are an iMessage-only feature — when the recipient is on
  * SMS/RCS the message is delivered without the animation. Effects are not supported in multipart
  * (`parts`) mode.
- *
- * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
- * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
- * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common — the
- * message_id returned by an earlier send or surfaced on a `message.received` webhook), or `{
- * "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where the
- * parent wasn't recorded by Blooio. The reply must target the same chat and the same from-number as
- * the new send, and the parent must be no older than 30 days (the iMessage on-device retention
- * horizon). Reply support is iMessage-only and is rejected on Twilio, dashboard-Twilio, and hybrid
- * send paths; it's also rejected on multi-message fan-outs (`text` array or per-part URL-balloon
- * batch). See the `400` responses for the full set of `reply_target_*` error codes.
  */
 class MessageSendParams
 private constructor(
@@ -149,18 +138,6 @@ private constructor(
      */
     fun parts(): Optional<List<Part>> = body.parts()
 
-    /**
-     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
-     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
-     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
-     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
-     * reply on the recipient's device.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun replyTo(): Optional<ReplyTo> = body.replyTo()
-
     /**
      * If true, the contact card (Name & Photo) will be shared with this message. The contact card
      * is piggybacked onto the outgoing message. Defaults to false.
@@ -221,13 +198,6 @@ private constructor(
      */
     fun _parts(): JsonField<List<Part>> = body._parts()
 
-    /**
-     * Returns the raw JSON value of [replyTo].
-     *
-     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
-     */
-    fun _replyTo(): JsonField<ReplyTo> = body._replyTo()
-
     /**
      * Returns the raw JSON value of [shareContact].
      *
@@ -451,26 +421,6 @@ private constructor(
          */
         fun addPart(part: Part) = apply { body.addPart(part) }
 
-        /**
-         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
-         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
-         * replying to messages received before the row was minted in Blooio). The new send is
-         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
-         * renders as an inline reply on the recipient's device.
-         */
-        fun replyTo(replyTo: ReplyTo?) = apply { body.replyTo(replyTo) }
-
-        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
-        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
-
-        /**
-         * Sets [Builder.replyTo] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
-         * method is primarily for setting the field to an undocumented or not yet supported value.
-         */
-        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { body.replyTo(replyTo) }
-
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false.
@@ -683,7 +633,6 @@ private constructor(
         private val fromNumber: JsonField<String>,
         private val linkPreview: JsonField<LinkPreview>,
         private val parts: JsonField<List<Part>>,
-        private val replyTo: JsonField<ReplyTo>,
         private val shareContact: JsonField<Boolean>,
         private val text: JsonField<Text>,
         private val useTypingIndicator: JsonField<Boolean>,
@@ -703,9 +652,6 @@ private constructor(
             @ExcludeMissing
             linkPreview: JsonField<LinkPreview> = JsonMissing.of(),
             @JsonProperty("parts") @ExcludeMissing parts: JsonField<List<Part>> = JsonMissing.of(),
-            @JsonProperty("reply_to")
-            @ExcludeMissing
-            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("share_contact")
             @ExcludeMissing
             shareContact: JsonField<Boolean> = JsonMissing.of(),
@@ -719,7 +665,6 @@ private constructor(
             fromNumber,
             linkPreview,
             parts,
-            replyTo,
             shareContact,
             text,
             useTypingIndicator,
@@ -804,18 +749,6 @@ private constructor(
          */
         fun parts(): Optional<List<Part>> = parts.getOptional("parts")
 
-        /**
-         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
-         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
-         * replying to messages received before the row was minted in Blooio). The new send is
-         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
-         * renders as an inline reply on the recipient's device.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
-
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false.
@@ -884,13 +817,6 @@ private constructor(
          */
         @JsonProperty("parts") @ExcludeMissing fun _parts(): JsonField<List<Part>> = parts
 
-        /**
-         * Returns the raw JSON value of [replyTo].
-         *
-         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
-
         /**
          * Returns the raw JSON value of [shareContact].
          *
@@ -944,7 +870,6 @@ private constructor(
             private var fromNumber: JsonField<String> = JsonMissing.of()
             private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
             private var parts: JsonField<MutableList<Part>>? = null
-            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var shareContact: JsonField<Boolean> = JsonMissing.of()
             private var text: JsonField<Text> = JsonMissing.of()
             private var useTypingIndicator: JsonField<Boolean> = JsonMissing.of()
@@ -957,7 +882,6 @@ private constructor(
                 fromNumber = body.fromNumber
                 linkPreview = body.linkPreview
                 parts = body.parts.map { it.toMutableList() }
-                replyTo = body.replyTo
                 shareContact = body.shareContact
                 text = body.text
                 useTypingIndicator = body.useTypingIndicator
@@ -1121,27 +1045,6 @@ private constructor(
                     }
             }
 
-            /**
-             * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
-             * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful
-             * for replying to messages received before the row was minted in Blooio). The new send
-             * is dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which
-             * iMessage renders as an inline reply on the recipient's device.
-             */
-            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
-
-            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
-            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
-
-            /**
-             * Sets [Builder.replyTo] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
-
             /**
              * If true, the contact card (Name & Photo) will be shared with this message. The
              * contact card is piggybacked onto the outgoing message. Defaults to false.
@@ -1226,7 +1129,6 @@ private constructor(
                     fromNumber,
                     linkPreview,
                     (parts ?: JsonMissing.of()).map { it.toImmutable() },
-                    replyTo,
                     shareContact,
                     text,
                     useTypingIndicator,
@@ -1255,7 +1157,6 @@ private constructor(
             fromNumber()
             linkPreview().ifPresent { it.validate() }
             parts().ifPresent { it.forEach { it.validate() } }
-            replyTo().ifPresent { it.validate() }
             shareContact()
             text().ifPresent { it.validate() }
             useTypingIndicator()
@@ -1283,7 +1184,6 @@ private constructor(
                 (if (fromNumber.asKnown().isPresent) 1 else 0) +
                 (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
                 (parts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (shareContact.asKnown().isPresent) 1 else 0) +
                 (text.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (useTypingIndicator.asKnown().isPresent) 1 else 0)
@@ -1299,7 +1199,6 @@ private constructor(
                 fromNumber == other.fromNumber &&
                 linkPreview == other.linkPreview &&
                 parts == other.parts &&
-                replyTo == other.replyTo &&
                 shareContact == other.shareContact &&
                 text == other.text &&
                 useTypingIndicator == other.useTypingIndicator &&
@@ -1313,7 +1212,6 @@ private constructor(
                 fromNumber,
                 linkPreview,
                 parts,
-                replyTo,
                 shareContact,
                 text,
                 useTypingIndicator,
@@ -1324,7 +1222,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, replyTo=$replyTo, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
+            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
     }
 
     /** URL to the attachment */
@@ -2301,256 +2199,6 @@ private constructor(
             "Part{linkPreview=$linkPreview, mention=$mention, name=$name, text=$text, url=$url, additionalProperties=$additionalProperties}"
     }
 
-    /**
-     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
-     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
-     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
-     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
-     * reply on the recipient's device.
-     */
-    class ReplyTo
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val guid: JsonField<String>,
-        private val messageId: JsonField<String>,
-        private val partIndex: JsonField<Long>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
-
-        @JsonCreator
-        private constructor(
-            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("message_id")
-            @ExcludeMissing
-            messageId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("part_index")
-            @ExcludeMissing
-            partIndex: JsonField<Long> = JsonMissing.of(),
-        ) : this(guid, messageId, partIndex, mutableMapOf())
-
-        /**
-         * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio attempts to
-         * look up the parent via `provider_message_guid`; if the parent isn't in our table the send
-         * still proceeds (Lava will thread on the device when possible) and the response carries
-         * `parent_unresolved: true`.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun guid(): Optional<String> = guid.getOptional("guid")
-
-        /**
-         * Blooio `message_id` of the parent. Must belong to the same chat, same from-number, and be
-         * no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun messageId(): Optional<String> = messageId.getOptional("message_id")
-
-        /**
-         * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying to a
-         * single-part text message).
-         *
-         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun partIndex(): Optional<Long> = partIndex.getOptional("part_index")
-
-        /**
-         * Returns the raw JSON value of [guid].
-         *
-         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
-
-        /**
-         * Returns the raw JSON value of [messageId].
-         *
-         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
-
-        /**
-         * Returns the raw JSON value of [partIndex].
-         *
-         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
-
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
-
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
-
-        fun toBuilder() = Builder().from(this)
-
-        companion object {
-
-            /** Returns a mutable builder for constructing an instance of [ReplyTo]. */
-            @JvmStatic fun builder() = Builder()
-        }
-
-        /** A builder for [ReplyTo]. */
-        class Builder internal constructor() {
-
-            private var guid: JsonField<String> = JsonMissing.of()
-            private var messageId: JsonField<String> = JsonMissing.of()
-            private var partIndex: JsonField<Long> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-            @JvmSynthetic
-            internal fun from(replyTo: ReplyTo) = apply {
-                guid = replyTo.guid
-                messageId = replyTo.messageId
-                partIndex = replyTo.partIndex
-                additionalProperties = replyTo.additionalProperties.toMutableMap()
-            }
-
-            /**
-             * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio
-             * attempts to look up the parent via `provider_message_guid`; if the parent isn't in
-             * our table the send still proceeds (Lava will thread on the device when possible) and
-             * the response carries `parent_unresolved: true`.
-             */
-            fun guid(guid: String) = guid(JsonField.of(guid))
-
-            /**
-             * Sets [Builder.guid] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
-
-            /**
-             * Blooio `message_id` of the parent. Must belong to the same chat, same from-number,
-             * and be no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
-             */
-            fun messageId(messageId: String) = messageId(JsonField.of(messageId))
-
-            /**
-             * Sets [Builder.messageId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
-
-            /**
-             * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying
-             * to a single-part text message).
-             */
-            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
-
-            /**
-             * Sets [Builder.partIndex] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
-
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
-
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
-
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
-
-            /**
-             * Returns an immutable instance of [ReplyTo].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             */
-            fun build(): ReplyTo =
-                ReplyTo(guid, messageId, partIndex, additionalProperties.toMutableMap())
-        }
-
-        private var validated: Boolean = false
-
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ReplyTo = apply {
-            if (validated) {
-                return@apply
-            }
-
-            guid()
-            messageId()
-            partIndex()
-            validated = true
-        }
-
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: BlooioInvalidDataException) {
-                false
-            }
-
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (guid.asKnown().isPresent) 1 else 0) +
-                (if (messageId.asKnown().isPresent) 1 else 0) +
-                (if (partIndex.asKnown().isPresent) 1 else 0)
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
-
-            return other is ReplyTo &&
-                guid == other.guid &&
-                messageId == other.messageId &&
-                partIndex == other.partIndex &&
-                additionalProperties == other.additionalProperties
-        }
-
-        private val hashCode: Int by lazy {
-            Objects.hash(guid, messageId, partIndex, additionalProperties)
-        }
-
-        override fun hashCode(): Int = hashCode
-
-        override fun toString() =
-            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
-    }
-
     /**
      * Message text. Can be a single string or array of strings (each becomes a separate message)
      */
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
index 30b4213..9204c59 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -28,7 +28,6 @@ private constructor(
     private val groupId: JsonField<String>,
     private val messageId: JsonField<String>,
     private val messageIds: JsonField<List<String>>,
-    private val parentUnresolved: JsonField<Boolean>,
     private val participants: JsonField<List<String>>,
     private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -45,9 +44,6 @@ private constructor(
         @JsonProperty("message_ids")
         @ExcludeMissing
         messageIds: JsonField<List<String>> = JsonMissing.of(),
-        @JsonProperty("parent_unresolved")
-        @ExcludeMissing
-        parentUnresolved: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("participants")
         @ExcludeMissing
         participants: JsonField<List<String>> = JsonMissing.of(),
@@ -58,7 +54,6 @@ private constructor(
         groupId,
         messageId,
         messageIds,
-        parentUnresolved,
         participants,
         status,
         mutableMapOf(),
@@ -105,16 +100,6 @@ private constructor(
      */
     fun messageIds(): Optional<List<String>> = messageIds.getOptional("message_ids")
 
-    /**
-     * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and the
-     * GUID didn't map to any Blooio-minted row. The send still proceeds and the device may still
-     * thread it; this flag signals that Blooio couldn't link the new message to a known parent.
-     *
-     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
-     *   server responded with an unexpected value).
-     */
-    fun parentUnresolved(): Optional<Boolean> = parentUnresolved.getOptional("parent_unresolved")
-
     /**
      * List of participants (present for multi-recipient)
      *
@@ -170,16 +155,6 @@ private constructor(
     @ExcludeMissing
     fun _messageIds(): JsonField<List<String>> = messageIds
 
-    /**
-     * Returns the raw JSON value of [parentUnresolved].
-     *
-     * Unlike [parentUnresolved], this method doesn't throw if the JSON field has an unexpected
-     * type.
-     */
-    @JsonProperty("parent_unresolved")
-    @ExcludeMissing
-    fun _parentUnresolved(): JsonField<Boolean> = parentUnresolved
-
     /**
      * Returns the raw JSON value of [participants].
      *
@@ -222,7 +197,6 @@ private constructor(
         private var groupId: JsonField<String> = JsonMissing.of()
         private var messageId: JsonField<String> = JsonMissing.of()
         private var messageIds: JsonField<MutableList<String>>? = null
-        private var parentUnresolved: JsonField<Boolean> = JsonMissing.of()
         private var participants: JsonField<MutableList<String>>? = null
         private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -234,7 +208,6 @@ private constructor(
             groupId = messageSendResponse.groupId
             messageId = messageSendResponse.messageId
             messageIds = messageSendResponse.messageIds.map { it.toMutableList() }
-            parentUnresolved = messageSendResponse.parentUnresolved
             participants = messageSendResponse.participants.map { it.toMutableList() }
             status = messageSendResponse.status
             additionalProperties = messageSendResponse.additionalProperties.toMutableMap()
@@ -317,26 +290,6 @@ private constructor(
                 }
         }
 
-        /**
-         * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and
-         * the GUID didn't map to any Blooio-minted row. The send still proceeds and the device may
-         * still thread it; this flag signals that Blooio couldn't link the new message to a known
-         * parent.
-         */
-        fun parentUnresolved(parentUnresolved: Boolean) =
-            parentUnresolved(JsonField.of(parentUnresolved))
-
-        /**
-         * Sets [Builder.parentUnresolved] to an arbitrary JSON value.
-         *
-         * You should usually call [Builder.parentUnresolved] with a well-typed [Boolean] value
-         * instead. This method is primarily for setting the field to an undocumented or not yet
-         * supported value.
-         */
-        fun parentUnresolved(parentUnresolved: JsonField<Boolean>) = apply {
-            this.parentUnresolved = parentUnresolved
-        }
-
         /** List of participants (present for multi-recipient) */
         fun participants(participants: List<String>) = participants(JsonField.of(participants))
 
@@ -405,7 +358,6 @@ private constructor(
                 groupId,
                 messageId,
                 (messageIds ?: JsonMissing.of()).map { it.toImmutable() },
-                parentUnresolved,
                 (participants ?: JsonMissing.of()).map { it.toImmutable() },
                 status,
                 additionalProperties.toMutableMap(),
@@ -432,7 +384,6 @@ private constructor(
         groupId()
         messageId()
         messageIds()
-        parentUnresolved()
         participants()
         status().ifPresent { it.validate() }
         validated = true
@@ -458,7 +409,6 @@ private constructor(
             (if (groupId.asKnown().isPresent) 1 else 0) +
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (messageIds.asKnown().getOrNull()?.size ?: 0) +
-            (if (parentUnresolved.asKnown().isPresent) 1 else 0) +
             (participants.asKnown().getOrNull()?.size ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
@@ -608,7 +558,6 @@ private constructor(
             groupId == other.groupId &&
             messageId == other.messageId &&
             messageIds == other.messageIds &&
-            parentUnresolved == other.parentUnresolved &&
             participants == other.participants &&
             status == other.status &&
             additionalProperties == other.additionalProperties
@@ -621,7 +570,6 @@ private constructor(
             groupId,
             messageId,
             messageIds,
-            parentUnresolved,
             participants,
             status,
             additionalProperties,
@@ -631,5 +579,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, parentUnresolved=$parentUnresolved, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
+        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
index 3984bad..1fe39ae 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
@@ -46,7 +46,7 @@ interface ChatServiceAsync {
     /** Control typing indicators for conversations */
     fun typing(): TypingServiceAsync
 
-    /** Set, get, and remove conversation backgrounds */
+    /** View conversations and messages */
     fun background(): BackgroundServiceAsync
 
     /** Get details for a specific conversation. */
@@ -200,7 +200,7 @@ interface ChatServiceAsync {
         /** Control typing indicators for conversations */
         fun typing(): TypingServiceAsync.WithRawResponse
 
-        /** Set, get, and remove conversation backgrounds */
+        /** View conversations and messages */
         fun background(): BackgroundServiceAsync.WithRawResponse
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
index 971f007..4259ca4 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsyncImpl.kt
@@ -70,7 +70,7 @@ class ChatServiceAsyncImpl internal constructor(private val clientOptions: Clien
     /** Control typing indicators for conversations */
     override fun typing(): TypingServiceAsync = typing
 
-    /** Set, get, and remove conversation backgrounds */
+    /** View conversations and messages */
     override fun background(): BackgroundServiceAsync = background
 
     override fun retrieve(
@@ -142,7 +142,7 @@ class ChatServiceAsyncImpl internal constructor(private val clientOptions: Clien
         /** Control typing indicators for conversations */
         override fun typing(): TypingServiceAsync.WithRawResponse = typing
 
-        /** Set, get, and remove conversation backgrounds */
+        /** View conversations and messages */
         override fun background(): BackgroundServiceAsync.WithRawResponse = background
 
         private val retrieveHandler: Handler<ChatRetrieveResponse> =
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
index b40cb9d..6bd4305 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
@@ -12,7 +12,7 @@ import com.blooio.api.models.chats.background.ChatBackgroundResponse
 import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 
-/** Set, get, and remove conversation backgrounds */
+/** View conversations and messages */
 interface BackgroundServiceAsync {
 
     /**
@@ -103,9 +103,18 @@ interface BackgroundServiceAsync {
     /**
      * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
      *
-     * The uploaded image is converted into a PosterKit-compatible archive and applied to the
-     * iMessage conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP,
-     * HEIC/HEIF. Maximum file size: 10 MB.
+     * The request body must be `multipart/form-data` with a single `background` field containing
+     * the **raw image file bytes** (not a URL or base64 string). Supported formats: JPEG, PNG, GIF,
+     * WebP, HEIC/HEIF. Maximum file size: 10 MB.
+     *
+     * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
+     * ```bash
+     * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+     *   -H "Authorization: Bearer YOUR_API_KEY" \
+     *   -F "background=@/path/to/image.jpg;type=image/jpeg"
+     * ```
+     *
+     * When the chat id is a phone number, percent-encode the leading `+` as `%2B` in the URL path.
      */
     fun set(
         chatId: String,
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
index 95def31..8be72ed 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsyncImpl.kt
@@ -25,7 +25,7 @@ import java.util.concurrent.CompletableFuture
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Set, get, and remove conversation backgrounds */
+/** View conversations and messages */
 class BackgroundServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
     BackgroundServiceAsync {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
index 7c62793..411a07d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -162,18 +162,6 @@ interface MessageServiceAsync {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
-     *
-     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
-     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
-     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
-     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
-     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
-     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
-     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
-     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
-     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
-     * array or per-part URL-balloon batch). See the `400` responses for the full set of
-     * `reply_target_*` error codes.
      */
     fun send(chatId: String): CompletableFuture<MessageSendResponse> =
         send(chatId, MessageSendParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
index 9d3b430..3c2fd81 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
@@ -46,7 +46,7 @@ interface ChatService {
     /** Control typing indicators for conversations */
     fun typing(): TypingService
 
-    /** Set, get, and remove conversation backgrounds */
+    /** View conversations and messages */
     fun background(): BackgroundService
 
     /** Get details for a specific conversation. */
@@ -189,7 +189,7 @@ interface ChatService {
         /** Control typing indicators for conversations */
         fun typing(): TypingService.WithRawResponse
 
-        /** Set, get, and remove conversation backgrounds */
+        /** View conversations and messages */
         fun background(): BackgroundService.WithRawResponse
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
index 9d5d510..3630a1a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatServiceImpl.kt
@@ -66,7 +66,7 @@ class ChatServiceImpl internal constructor(private val clientOptions: ClientOpti
     /** Control typing indicators for conversations */
     override fun typing(): TypingService = typing
 
-    /** Set, get, and remove conversation backgrounds */
+    /** View conversations and messages */
     override fun background(): BackgroundService = background
 
     override fun retrieve(
@@ -135,7 +135,7 @@ class ChatServiceImpl internal constructor(private val clientOptions: ClientOpti
         /** Control typing indicators for conversations */
         override fun typing(): TypingService.WithRawResponse = typing
 
-        /** Set, get, and remove conversation backgrounds */
+        /** View conversations and messages */
         override fun background(): BackgroundService.WithRawResponse = background
 
         private val retrieveHandler: Handler<ChatRetrieveResponse> =
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
index 47f2e55..2731935 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
@@ -12,7 +12,7 @@ import com.blooio.api.models.chats.background.ChatBackgroundResponse
 import com.google.errorprone.annotations.MustBeClosed
 import java.util.function.Consumer
 
-/** Set, get, and remove conversation backgrounds */
+/** View conversations and messages */
 interface BackgroundService {
 
     /**
@@ -95,9 +95,18 @@ interface BackgroundService {
     /**
      * Set or update the background image for a conversation. Works for both 1-on-1 and group chats.
      *
-     * The uploaded image is converted into a PosterKit-compatible archive and applied to the
-     * iMessage conversation on the linked device. Supported formats: JPEG, PNG, GIF, WebP,
-     * HEIC/HEIF. Maximum file size: 10 MB.
+     * The request body must be `multipart/form-data` with a single `background` field containing
+     * the **raw image file bytes** (not a URL or base64 string). Supported formats: JPEG, PNG, GIF,
+     * WebP, HEIC/HEIF. Maximum file size: 10 MB.
+     *
+     * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
+     * ```bash
+     * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+     *   -H "Authorization: Bearer YOUR_API_KEY" \
+     *   -F "background=@/path/to/image.jpg;type=image/jpeg"
+     * ```
+     *
+     * When the chat id is a phone number, percent-encode the leading `+` as `%2B` in the URL path.
      */
     fun set(chatId: String, params: BackgroundSetParams): ChatBackgroundResponse =
         set(chatId, params, RequestOptions.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
index 5411d8a..45c79ec 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundServiceImpl.kt
@@ -24,7 +24,7 @@ import com.blooio.api.models.chats.background.ChatBackgroundResponse
 import java.util.function.Consumer
 import kotlin.jvm.optionals.getOrNull
 
-/** Set, get, and remove conversation backgrounds */
+/** View conversations and messages */
 class BackgroundServiceImpl internal constructor(private val clientOptions: ClientOptions) :
     BackgroundService {
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
index 861edcf..6f2100e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -147,18 +147,6 @@ interface MessageService {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
-     *
-     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
-     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
-     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
-     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
-     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
-     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
-     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
-     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
-     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
-     * array or per-part URL-balloon batch). See the `400` responses for the full set of
-     * `reply_target_*` error codes.
      */
     fun send(chatId: String): MessageSendResponse = send(chatId, MessageSendParams.none())
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
index 28b94e9..76639bc 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
@@ -18,8 +18,6 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
-                        .backgroundId("background_id")
-                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
@@ -55,8 +53,6 @@ internal class ChatListResponseTest {
             .containsExactly(
                 ChatListResponse.Chat.builder()
                     .id("id")
-                    .backgroundId("background_id")
-                    .backgroundUrl("https://example.com")
                     .contact(
                         ChatListResponse.Chat.Contact.builder()
                             .contactId("contact_id")
@@ -97,8 +93,6 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
-                        .backgroundId("background_id")
-                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
index bcb592b..d83add3 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
@@ -14,8 +14,6 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
-                .backgroundId("background_id")
-                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
@@ -46,8 +44,6 @@ internal class ChatRetrieveResponseTest {
                 .build()
 
         assertThat(chatRetrieveResponse.id()).contains("id")
-        assertThat(chatRetrieveResponse.backgroundId()).contains("background_id")
-        assertThat(chatRetrieveResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatRetrieveResponse.contact())
             .contains(
                 ChatRetrieveResponse.Contact.builder()
@@ -85,8 +81,6 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
-                .backgroundId("background_id")
-                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
index b738138..53e1631 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
@@ -14,7 +14,6 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
-                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")
@@ -22,7 +21,6 @@ internal class ChatBackgroundResponseTest {
                 .build()
 
         assertThat(chatBackgroundResponse.backgroundId()).contains("background_id")
-        assertThat(chatBackgroundResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatBackgroundResponse.backgroundVersion()).contains(0L)
         assertThat(chatBackgroundResponse.changed()).contains(true)
         assertThat(chatBackgroundResponse.chatId()).contains("chat_id")
@@ -35,7 +33,6 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
-                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
index c4fd065..921b646 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
@@ -34,13 +34,6 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
-                        .replyTo(
-                            MessageListResponse.Message.ReplyTo.builder()
-                                .guid("guid")
-                                .messageId("message_id")
-                                .partIndex(0L)
-                                .build()
-                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
@@ -70,13 +63,6 @@ internal class MessageListResponseTest {
                             .timeSent(0L)
                             .build()
                     )
-                    .replyTo(
-                        MessageListResponse.Message.ReplyTo.builder()
-                            .guid("guid")
-                            .messageId("message_id")
-                            .partIndex(0L)
-                            .build()
-                    )
                     .sender("sender")
                     .status(MessageListResponse.Message.Status.PENDING)
                     .text("text")
@@ -111,13 +97,6 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
-                        .replyTo(
-                            MessageListResponse.Message.ReplyTo.builder()
-                                .guid("guid")
-                                .messageId("message_id")
-                                .partIndex(0L)
-                                .build()
-                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
index c3d847f..b50572d 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
@@ -37,13 +37,6 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
-                .replyTo(
-                    MessageRetrieveResponse.ReplyTo.builder()
-                        .guid("guid")
-                        .messageId("message_id")
-                        .partIndex(0L)
-                        .build()
-                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
@@ -78,14 +71,6 @@ internal class MessageRetrieveResponseTest {
                     .timeSent(0L)
                     .build()
             )
-        assertThat(messageRetrieveResponse.replyTo())
-            .contains(
-                MessageRetrieveResponse.ReplyTo.builder()
-                    .guid("guid")
-                    .messageId("message_id")
-                    .partIndex(0L)
-                    .build()
-            )
         assertThat(messageRetrieveResponse.sender()).contains("sender")
         assertThat(messageRetrieveResponse.status())
             .contains(MessageRetrieveResponse.Status.PENDING)
@@ -121,13 +106,6 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
-                .replyTo(
-                    MessageRetrieveResponse.ReplyTo.builder()
-                        .guid("guid")
-                        .messageId("message_id")
-                        .partIndex(0L)
-                        .build()
-                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
index 5e15a03..fd602ad 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
@@ -31,13 +31,6 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
-            .replyTo(
-                MessageSendParams.ReplyTo.builder()
-                    .guid("guid")
-                    .messageId("message_id")
-                    .partIndex(0L)
-                    .build()
-            )
             .shareContact(true)
             .text("string")
             .useTypingIndicator(true)
@@ -79,13 +72,6 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
-                .replyTo(
-                    MessageSendParams.ReplyTo.builder()
-                        .guid("guid")
-                        .messageId("message_id")
-                        .partIndex(0L)
-                        .build()
-                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -132,13 +118,6 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
-                .replyTo(
-                    MessageSendParams.ReplyTo.builder()
-                        .guid("guid")
-                        .messageId("message_id")
-                        .partIndex(0L)
-                        .build()
-                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -164,14 +143,6 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
-        assertThat(body.replyTo())
-            .contains(
-                MessageSendParams.ReplyTo.builder()
-                    .guid("guid")
-                    .messageId("message_id")
-                    .partIndex(0L)
-                    .build()
-            )
         assertThat(body.shareContact()).contains(true)
         assertThat(body.text()).contains(MessageSendParams.Text.ofString("string"))
         assertThat(body.useTypingIndicator()).contains(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
index 1b06a5e..9bb1f1b 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
@@ -19,7 +19,6 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
-                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
@@ -29,7 +28,6 @@ internal class MessageSendResponseTest {
         assertThat(messageSendResponse.groupId()).contains("group_id")
         assertThat(messageSendResponse.messageId()).contains("message_id")
         assertThat(messageSendResponse.messageIds().getOrNull()).containsExactly("string")
-        assertThat(messageSendResponse.parentUnresolved()).contains(true)
         assertThat(messageSendResponse.participants().getOrNull()).containsExactly("string")
         assertThat(messageSendResponse.status()).contains(MessageSendResponse.Status.QUEUED)
     }
@@ -44,7 +42,6 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
-                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
index 40748f3..3a57799 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
@@ -124,13 +124,6 @@ internal class MessageServiceAsyncTest {
                             .url("url")
                             .build()
                     )
-                    .replyTo(
-                        MessageSendParams.ReplyTo.builder()
-                            .guid("guid")
-                            .messageId("message_id")
-                            .partIndex(0L)
-                            .build()
-                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
index da1b508..633bb81 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
@@ -120,13 +120,6 @@ internal class MessageServiceTest {
                             .url("url")
                             .build()
                     )
-                    .replyTo(
-                        MessageSendParams.ReplyTo.builder()
-                            .guid("guid")
-                            .messageId("message_id")
-                            .partIndex(0L)
-                            .build()
-                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)

From 62bd13a9dcfbdd3df4b764fb1bbe49b4481641ab Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 28 May 2026 21:20:25 +0000
Subject: [PATCH 51/63] feat(api): api update

---
 .stats.yml                                               | 4 ++--
 .../api/models/chats/messages/MessageReactParams.kt      | 9 +++------
 .../api/services/async/chats/MessageServiceAsync.kt      | 2 --
 .../blooio/api/services/blocking/chats/MessageService.kt | 2 --
 4 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 36f5ef8..a5d66de 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-164b95920b6f8c3bcf47d73fb582375e0e40e72a5d01a19ada82c19431b5853e.yml
-openapi_spec_hash: 988aee0a657a2411a646e306ed9e2e22
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-5bfdbbd81896415e7d35d5c75de7ac794321ec5842c37fab5369f9d716837581.yml
+openapi_spec_hash: ed104905ecf88a7159efed08b9680fce
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
index 642ee86..f8a3eab 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageReactParams.kt
@@ -28,8 +28,6 @@ import kotlin.jvm.optionals.getOrNull
  * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
  * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter by
  * message direction (inbound/outbound only).
- *
- * Emoji reactions require macOS 14 (Sonoma) or later on the device.
  */
 class MessageReactParams
 private constructor(
@@ -51,7 +49,6 @@ private constructor(
      * `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
      *
      * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`, `-🔥`).
-     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
      *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -146,7 +143,7 @@ private constructor(
          * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
          *
          * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
-         * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+         * `-🔥`).
          */
         fun reaction(reaction: String) = apply { body.reaction(reaction) }
 
@@ -350,7 +347,7 @@ private constructor(
          * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
          *
          * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
-         * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+         * `-🔥`).
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -427,7 +424,7 @@ private constructor(
              * `+laugh`, `-laugh`, `+emphasize`, `-emphasize`, `+question`, `-question`
              *
              * **Emoji reactions:** Any emoji prefixed with `+` or `-` (e.g. `+😂`, `-😂`, `+👍`,
-             * `-🔥`). Emoji reactions require macOS 14 (Sonoma) or later on the device.
+             * `-🔥`).
              */
             fun reaction(reaction: String) = reaction(JsonField.of(reaction))
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
index 411a07d..84755c9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -124,8 +124,6 @@ interface MessageServiceAsync {
      * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
      * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter
      * by message direction (inbound/outbound only).
-     *
-     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
      */
     fun react(
         messageId: String,
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
index 6f2100e..1141d3f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -112,8 +112,6 @@ interface MessageService {
      * The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last
      * message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter
      * by message direction (inbound/outbound only).
-     *
-     * Emoji reactions require macOS 14 (Sonoma) or later on the device.
      */
     fun react(messageId: String, params: MessageReactParams): MessageReactResponse =
         react(messageId, params, RequestOptions.none())

From 771db4a13cd1736ea91b9e61beb8a987628bcacc Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 29 May 2026 21:20:27 +0000
Subject: [PATCH 52/63] feat(api): api update

---
 .stats.yml                                        |  4 ++--
 .../models/chats/ChatShareContactCardParams.kt    |  3 +++
 .../models/chats/messages/MessageSendParams.kt    | 15 +++++++++++----
 .../contactcard/ContactCardUpdateParams.kt        |  4 ++++
 .../blooio/api/services/async/ChatServiceAsync.kt |  3 +++
 .../async/me/numbers/ContactCardServiceAsync.kt   |  4 ++++
 .../blooio/api/services/blocking/ChatService.kt   |  3 +++
 .../blocking/me/numbers/ContactCardService.kt     |  4 ++++
 8 files changed, 34 insertions(+), 6 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index a5d66de..d38d411 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-5bfdbbd81896415e7d35d5c75de7ac794321ec5842c37fab5369f9d716837581.yml
-openapi_spec_hash: ed104905ecf88a7159efed08b9680fce
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-46f59ef78fe3698c34ceea0a3ec36b2a2686471917c7c7d419eb12d128eac297.yml
+openapi_spec_hash: aa44af93cee78f8800ac64bae9a578c6
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
index 1c9208e..fb78c13 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatShareContactCardParams.kt
@@ -15,6 +15,9 @@ import kotlin.jvm.optionals.getOrNull
  * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be piggybacked
  * onto the next outgoing message (text or attachment) sent to this chat. This is idempotent —
  * calling it multiple times is harmless.
+ *
+ * ⚠️ **Plan requirement:** Contact card sharing is only available on **Dedicated Commercial** and
+ * **Dedicated Enterprise** plans. Numbers on other plans receive a `403`.
  */
 class ChatShareContactCardParams
 private constructor(
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index aed85aa..08630f9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -140,7 +140,8 @@ private constructor(
 
     /**
      * If true, the contact card (Name & Photo) will be shared with this message. The contact card
-     * is piggybacked onto the outgoing message. Defaults to false.
+     * is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on **Dedicated
+     * Commercial** and **Dedicated Enterprise** plans — other plans receive a `403`.
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -423,7 +424,9 @@ private constructor(
 
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
-         * card is piggybacked onto the outgoing message. Defaults to false.
+         * card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on
+         * **Dedicated Commercial** and **Dedicated Enterprise** plans — other plans receive a
+         * `403`.
          */
         fun shareContact(shareContact: Boolean) = apply { body.shareContact(shareContact) }
 
@@ -751,7 +754,9 @@ private constructor(
 
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
-         * card is piggybacked onto the outgoing message. Defaults to false.
+         * card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on
+         * **Dedicated Commercial** and **Dedicated Enterprise** plans — other plans receive a
+         * `403`.
          *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1047,7 +1052,9 @@ private constructor(
 
             /**
              * If true, the contact card (Name & Photo) will be shared with this message. The
-             * contact card is piggybacked onto the outgoing message. Defaults to false.
+             * contact card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only
+             * available on **Dedicated Commercial** and **Dedicated Enterprise** plans — other
+             * plans receive a `403`.
              */
             fun shareContact(shareContact: Boolean) = shareContact(JsonField.of(shareContact))
 
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
index fb2cead..9e9b8bc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/me/numbers/contactcard/ContactCardUpdateParams.kt
@@ -22,6 +22,10 @@ import kotlin.jvm.optionals.getOrNull
 /**
  * Update the personal contact card (Name & Photo) for the specified phone number. All fields are
  * optional — only provided fields are updated.
+ *
+ * ⚠️ **Plan requirement:** Setting the `first_name`, `last_name`, or `avatar` is only available on
+ * **Dedicated Commercial** and **Dedicated Enterprise** plans. Numbers on other plans receive a
+ * `403`.
  */
 class ContactCardUpdateParams
 private constructor(
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
index 1fe39ae..fa1fde8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/ChatServiceAsync.kt
@@ -140,6 +140,9 @@ interface ChatServiceAsync {
      * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be
      * piggybacked onto the next outgoing message (text or attachment) sent to this chat. This is
      * idempotent — calling it multiple times is harmless.
+     *
+     * ⚠️ **Plan requirement:** Contact card sharing is only available on **Dedicated Commercial**
+     * and **Dedicated Enterprise** plans. Numbers on other plans receive a `403`.
      */
     fun shareContactCard(chatId: String): CompletableFuture<ChatShareContactCardResponse> =
         shareContactCard(chatId, ChatShareContactCardParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
index 2bc1c33..58d8c4f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/me/numbers/ContactCardServiceAsync.kt
@@ -72,6 +72,10 @@ interface ContactCardServiceAsync {
     /**
      * Update the personal contact card (Name & Photo) for the specified phone number. All fields
      * are optional — only provided fields are updated.
+     *
+     * ⚠️ **Plan requirement:** Setting the `first_name`, `last_name`, or `avatar` is only available
+     * on **Dedicated Commercial** and **Dedicated Enterprise** plans. Numbers on other plans
+     * receive a `403`.
      */
     fun update(number: String): CompletableFuture<ContactCardUpdateResponse> =
         update(number, ContactCardUpdateParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
index 3c2fd81..8180b00 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/ChatService.kt
@@ -132,6 +132,9 @@ interface ChatService {
      * Stage the contact card (Name & Photo) for sharing in a chat. The contact card will be
      * piggybacked onto the next outgoing message (text or attachment) sent to this chat. This is
      * idempotent — calling it multiple times is harmless.
+     *
+     * ⚠️ **Plan requirement:** Contact card sharing is only available on **Dedicated Commercial**
+     * and **Dedicated Enterprise** plans. Numbers on other plans receive a `403`.
      */
     fun shareContactCard(chatId: String): ChatShareContactCardResponse =
         shareContactCard(chatId, ChatShareContactCardParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
index 702a821..bfd3acc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/me/numbers/ContactCardService.kt
@@ -67,6 +67,10 @@ interface ContactCardService {
     /**
      * Update the personal contact card (Name & Photo) for the specified phone number. All fields
      * are optional — only provided fields are updated.
+     *
+     * ⚠️ **Plan requirement:** Setting the `first_name`, `last_name`, or `avatar` is only available
+     * on **Dedicated Commercial** and **Dedicated Enterprise** plans. Numbers on other plans
+     * receive a `403`.
      */
     fun update(number: String): ContactCardUpdateResponse =
         update(number, ContactCardUpdateParams.none())

From ddc345895a8f3d40499f587ae3f5f0d34c51d1cb Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 29 May 2026 22:20:26 +0000
Subject: [PATCH 53/63] feat(api): api update

---
 .stats.yml                                                   | 4 ++--
 .../com/blooio/api/models/chats/typing/TypingStartParams.kt  | 2 ++
 .../com/blooio/api/models/chats/typing/TypingStopParams.kt   | 3 ++-
 .../blooio/api/services/async/chats/TypingServiceAsync.kt    | 5 ++++-
 .../com/blooio/api/services/blocking/chats/TypingService.kt  | 5 ++++-
 5 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index d38d411..52d7b70 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-46f59ef78fe3698c34ceea0a3ec36b2a2686471917c7c7d419eb12d128eac297.yml
-openapi_spec_hash: aa44af93cee78f8800ac64bae9a578c6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-89b373f13520ce524ae595019f2d18b83252e41615106e78b56495cb1bac6a17.yml
+openapi_spec_hash: 010188e6078b32cb3e43a8f66d6090f7
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
index f0db605..686dd9f 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStartParams.kt
@@ -13,6 +13,8 @@ import kotlin.jvm.optionals.getOrNull
 
 /**
  * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+ * Works for both 1:1 chats (pass a phone number or email as `chatId`) and group chats (pass the
+ * group ID, e.g. `grp_...`); in a group every participant sees the indicator.
  *
  * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS protocol
  * does not carry composing state. Calls against RCS-routed chats return 200 with a `warning` field
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
index 5bbb6d2..2584b1d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/typing/TypingStopParams.kt
@@ -12,7 +12,8 @@ import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
- * Stop the typing indicator for a chat.
+ * Stop the typing indicator for a chat. Works for both 1:1 chats (pass a phone number or email as
+ * `chatId`) and group chats (pass the group ID, e.g. `grp_...`).
  *
  * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS protocol
  * does not carry composing state. Calls against RCS-routed chats return 200 with a `warning` field
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
index c90518d..36516ca 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/TypingServiceAsync.kt
@@ -28,6 +28,8 @@ interface TypingServiceAsync {
 
     /**
      * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     * Works for both 1:1 chats (pass a phone number or email as `chatId`) and group chats (pass the
+     * group ID, e.g. `grp_...`); in a group every participant sees the indicator.
      *
      * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
      * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
@@ -65,7 +67,8 @@ interface TypingServiceAsync {
         start(chatId, TypingStartParams.none(), requestOptions)
 
     /**
-     * Stop the typing indicator for a chat.
+     * Stop the typing indicator for a chat. Works for both 1:1 chats (pass a phone number or email
+     * as `chatId`) and group chats (pass the group ID, e.g. `grp_...`).
      *
      * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
      * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
index 432ae0a..67ce06e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/TypingService.kt
@@ -28,6 +28,8 @@ interface TypingService {
 
     /**
      * Start the typing indicator for a chat. The indicator shows the recipient that you are typing.
+     * Works for both 1:1 chats (pass a phone number or email as `chatId`) and group chats (pass the
+     * group ID, e.g. `grp_...`); in a group every participant sees the indicator.
      *
      * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
      * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a
@@ -62,7 +64,8 @@ interface TypingService {
         start(chatId, TypingStartParams.none(), requestOptions)
 
     /**
-     * Stop the typing indicator for a chat.
+     * Stop the typing indicator for a chat. Works for both 1:1 chats (pass a phone number or email
+     * as `chatId`) and group chats (pass the group ID, e.g. `grp_...`).
      *
      * **RCS limitation:** typing indicators are only delivered for iMessage chats — the RCS
      * protocol does not carry composing state. Calls against RCS-routed chats return 200 with a

From d5f081ff6757c817eae3c9c6a415122d51892ffa Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 31 May 2026 06:20:24 +0000
Subject: [PATCH 54/63] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 52d7b70..8a65bf9 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-89b373f13520ce524ae595019f2d18b83252e41615106e78b56495cb1bac6a17.yml
-openapi_spec_hash: 010188e6078b32cb3e43a8f66d6090f7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-ad8942369c6c1d1ff02b4d71ab75d12c73c8895157ffc7ebde0932964b0bb3d0.yml
+openapi_spec_hash: 841aacf1e549afd1218f172eca40457e
 config_hash: 839e191496287972d18d39dcab8b19b7

From 932d8162c2cd61c1dc99420ffc57b7ba3cf3ec2b Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Tue, 2 Jun 2026 19:20:28 +0000
Subject: [PATCH 55/63] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../api/models/chats/ChatListResponse.kt      | 100 ++++-
 .../api/models/chats/ChatRetrieveResponse.kt  |  96 ++++-
 .../background/ChatBackgroundResponse.kt      |  65 +++-
 .../chats/messages/MessageListResponse.kt     | 330 +++++++++++++++-
 .../chats/messages/MessageRetrieveResponse.kt | 316 +++++++++++++++-
 .../chats/messages/MessageSendParams.kt       | 354 +++++++++++++++++-
 .../chats/messages/MessageSendResponse.kt     |  54 ++-
 .../async/chats/MessageServiceAsync.kt        |  12 +
 .../services/blocking/chats/MessageService.kt |  12 +
 .../api/models/chats/ChatListResponseTest.kt  |   6 +
 .../models/chats/ChatRetrieveResponseTest.kt  |   6 +
 .../background/ChatBackgroundResponseTest.kt  |   3 +
 .../chats/messages/MessageListResponseTest.kt |  21 ++
 .../messages/MessageRetrieveResponseTest.kt   |  22 ++
 .../chats/messages/MessageSendParamsTest.kt   |  29 ++
 .../chats/messages/MessageSendResponseTest.kt |   3 +
 .../async/chats/MessageServiceAsyncTest.kt    |   7 +
 .../blocking/chats/MessageServiceTest.kt      |   7 +
 19 files changed, 1437 insertions(+), 10 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 8a65bf9..2d2f694 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-ad8942369c6c1d1ff02b4d71ab75d12c73c8895157ffc7ebde0932964b0bb3d0.yml
-openapi_spec_hash: 841aacf1e549afd1218f172eca40457e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-11ec3fc93ebdd4d2d0699c400c1369866e3a892e8fb5270eaa409347a333b8c0.yml
+openapi_spec_hash: 7461099a5a1699f3082bb99147a2399d
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
index 35791ee..f306121 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListResponse.kt
@@ -204,6 +204,8 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
+        private val backgroundId: JsonField<String>,
+        private val backgroundUrl: JsonField<String>,
         private val contact: JsonField<Contact>,
         private val groupId: JsonField<String>,
         private val groupName: JsonField<String>,
@@ -223,6 +225,12 @@ private constructor(
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("background_id")
+            @ExcludeMissing
+            backgroundId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("background_url")
+            @ExcludeMissing
+            backgroundUrl: JsonField<String> = JsonMissing.of(),
             @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
             @JsonProperty("group_id") @ExcludeMissing groupId: JsonField<String> = JsonMissing.of(),
             @JsonProperty("group_name")
@@ -258,6 +266,8 @@ private constructor(
             @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
         ) : this(
             id,
+            backgroundId,
+            backgroundUrl,
             contact,
             groupId,
             groupName,
@@ -282,6 +292,22 @@ private constructor(
          */
         fun id(): Optional<String> = id.getOptional("id")
 
+        /**
+         * Identifier for the active chat background
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
+
+        /**
+         * Public URL of the chat background image (if one has been set via the API)
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
         /**
          * Contact info (only for non-group chats)
          *
@@ -377,6 +403,26 @@ private constructor(
          */
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+        /**
+         * Returns the raw JSON value of [backgroundId].
+         *
+         * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("background_id")
+        @ExcludeMissing
+        fun _backgroundId(): JsonField<String> = backgroundId
+
+        /**
+         * Returns the raw JSON value of [backgroundUrl].
+         *
+         * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
         /**
          * Returns the raw JSON value of [contact].
          *
@@ -512,6 +558,8 @@ private constructor(
         class Builder internal constructor() {
 
             private var id: JsonField<String> = JsonMissing.of()
+            private var backgroundId: JsonField<String> = JsonMissing.of()
+            private var backgroundUrl: JsonField<String> = JsonMissing.of()
             private var contact: JsonField<Contact> = JsonMissing.of()
             private var groupId: JsonField<String> = JsonMissing.of()
             private var groupName: JsonField<String> = JsonMissing.of()
@@ -530,6 +578,8 @@ private constructor(
             @JvmSynthetic
             internal fun from(chat: Chat) = apply {
                 id = chat.id
+                backgroundId = chat.backgroundId
+                backgroundUrl = chat.backgroundUrl
                 contact = chat.contact
                 groupId = chat.groupId
                 groupName = chat.groupName
@@ -558,6 +608,44 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
+            /** Identifier for the active chat background */
+            fun backgroundId(backgroundId: String?) =
+                backgroundId(JsonField.ofNullable(backgroundId))
+
+            /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
+            fun backgroundId(backgroundId: Optional<String>) =
+                backgroundId(backgroundId.getOrNull())
+
+            /**
+             * Sets [Builder.backgroundId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.backgroundId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun backgroundId(backgroundId: JsonField<String>) = apply {
+                this.backgroundId = backgroundId
+            }
+
+            /** Public URL of the chat background image (if one has been set via the API) */
+            fun backgroundUrl(backgroundUrl: String?) =
+                backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+            /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+            fun backgroundUrl(backgroundUrl: Optional<String>) =
+                backgroundUrl(backgroundUrl.getOrNull())
+
+            /**
+             * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.backgroundUrl] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+                this.backgroundUrl = backgroundUrl
+            }
+
             /** Contact info (only for non-group chats) */
             fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -784,6 +872,8 @@ private constructor(
             fun build(): Chat =
                 Chat(
                     id,
+                    backgroundId,
+                    backgroundUrl,
                     contact,
                     groupId,
                     groupName,
@@ -818,6 +908,8 @@ private constructor(
             }
 
             id()
+            backgroundId()
+            backgroundUrl()
             contact().ifPresent { it.validate() }
             groupId()
             groupName()
@@ -851,6 +943,8 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (id.asKnown().isPresent) 1 else 0) +
+                (if (backgroundId.asKnown().isPresent) 1 else 0) +
+                (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
                 (contact.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (groupId.asKnown().isPresent) 1 else 0) +
                 (if (groupName.asKnown().isPresent) 1 else 0) +
@@ -1249,6 +1343,8 @@ private constructor(
 
             return other is Chat &&
                 id == other.id &&
+                backgroundId == other.backgroundId &&
+                backgroundUrl == other.backgroundUrl &&
                 contact == other.contact &&
                 groupId == other.groupId &&
                 groupName == other.groupName &&
@@ -1268,6 +1364,8 @@ private constructor(
         private val hashCode: Int by lazy {
             Objects.hash(
                 id,
+                backgroundId,
+                backgroundUrl,
                 contact,
                 groupId,
                 groupName,
@@ -1288,7 +1386,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Chat{id=$id, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+            "Chat{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
index 78f609c..6310bf3 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatRetrieveResponse.kt
@@ -21,6 +21,8 @@ class ChatRetrieveResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val id: JsonField<String>,
+    private val backgroundId: JsonField<String>,
+    private val backgroundUrl: JsonField<String>,
     private val contact: JsonField<Contact>,
     private val firstMessageTime: JsonField<Long>,
     private val groupId: JsonField<String>,
@@ -41,6 +43,12 @@ private constructor(
     @JsonCreator
     private constructor(
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_id")
+        @ExcludeMissing
+        backgroundId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("contact") @ExcludeMissing contact: JsonField<Contact> = JsonMissing.of(),
         @JsonProperty("first_message_time")
         @ExcludeMissing
@@ -75,6 +83,8 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
     ) : this(
         id,
+        backgroundId,
+        backgroundUrl,
         contact,
         firstMessageTime,
         groupId,
@@ -100,6 +110,22 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * Identifier for the active chat background
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
+
+    /**
+     * Public URL of the chat background image (if one has been set via the API)
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
     /**
      * Contact info (only for non-group chats)
      *
@@ -201,6 +227,24 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [backgroundId].
+     *
+     * Unlike [backgroundId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_id")
+    @ExcludeMissing
+    fun _backgroundId(): JsonField<String> = backgroundId
+
+    /**
+     * Returns the raw JSON value of [backgroundUrl].
+     *
+     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_url")
+    @ExcludeMissing
+    fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
     /**
      * Returns the raw JSON value of [contact].
      *
@@ -339,6 +383,8 @@ private constructor(
     class Builder internal constructor() {
 
         private var id: JsonField<String> = JsonMissing.of()
+        private var backgroundId: JsonField<String> = JsonMissing.of()
+        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var contact: JsonField<Contact> = JsonMissing.of()
         private var firstMessageTime: JsonField<Long> = JsonMissing.of()
         private var groupId: JsonField<String> = JsonMissing.of()
@@ -358,6 +404,8 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatRetrieveResponse: ChatRetrieveResponse) = apply {
             id = chatRetrieveResponse.id
+            backgroundId = chatRetrieveResponse.backgroundId
+            backgroundUrl = chatRetrieveResponse.backgroundUrl
             contact = chatRetrieveResponse.contact
             firstMessageTime = chatRetrieveResponse.firstMessageTime
             groupId = chatRetrieveResponse.groupId
@@ -386,6 +434,42 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** Identifier for the active chat background */
+        fun backgroundId(backgroundId: String?) = backgroundId(JsonField.ofNullable(backgroundId))
+
+        /** Alias for calling [Builder.backgroundId] with `backgroundId.orElse(null)`. */
+        fun backgroundId(backgroundId: Optional<String>) = backgroundId(backgroundId.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundId(backgroundId: JsonField<String>) = apply {
+            this.backgroundId = backgroundId
+        }
+
+        /** Public URL of the chat background image (if one has been set via the API) */
+        fun backgroundUrl(backgroundUrl: String?) =
+            backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+        fun backgroundUrl(backgroundUrl: Optional<String>) =
+            backgroundUrl(backgroundUrl.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+            this.backgroundUrl = backgroundUrl
+        }
+
         /** Contact info (only for non-group chats) */
         fun contact(contact: Contact?) = contact(JsonField.ofNullable(contact))
 
@@ -614,6 +698,8 @@ private constructor(
         fun build(): ChatRetrieveResponse =
             ChatRetrieveResponse(
                 id,
+                backgroundId,
+                backgroundUrl,
                 contact,
                 firstMessageTime,
                 groupId,
@@ -648,6 +734,8 @@ private constructor(
         }
 
         id()
+        backgroundId()
+        backgroundUrl()
         contact().ifPresent { it.validate() }
         firstMessageTime()
         groupId()
@@ -681,6 +769,8 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (id.asKnown().isPresent) 1 else 0) +
+            (if (backgroundId.asKnown().isPresent) 1 else 0) +
+            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (contact.asKnown().getOrNull()?.validity() ?: 0) +
             (if (firstMessageTime.asKnown().isPresent) 1 else 0) +
             (if (groupId.asKnown().isPresent) 1 else 0) +
@@ -1067,6 +1157,8 @@ private constructor(
 
         return other is ChatRetrieveResponse &&
             id == other.id &&
+            backgroundId == other.backgroundId &&
+            backgroundUrl == other.backgroundUrl &&
             contact == other.contact &&
             firstMessageTime == other.firstMessageTime &&
             groupId == other.groupId &&
@@ -1087,6 +1179,8 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             id,
+            backgroundId,
+            backgroundUrl,
             contact,
             firstMessageTime,
             groupId,
@@ -1108,5 +1202,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatRetrieveResponse{id=$id, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
+        "ChatRetrieveResponse{id=$id, backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, contact=$contact, firstMessageTime=$firstMessageTime, groupId=$groupId, groupName=$groupName, inboundCount=$inboundCount, isGroup=$isGroup, lastInboundTime=$lastInboundTime, lastMessage=$lastMessage, lastMessageTime=$lastMessageTime, lastOutboundTime=$lastOutboundTime, memberCount=$memberCount, messageCount=$messageCount, outboundCount=$outboundCount, type=$type, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
index 1e35e39..2afde6d 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponse.kt
@@ -21,6 +21,7 @@ class ChatBackgroundResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val backgroundId: JsonField<String>,
+    private val backgroundUrl: JsonField<String>,
     private val backgroundVersion: JsonField<Long>,
     private val changed: JsonField<Boolean>,
     private val chatId: JsonField<String>,
@@ -33,6 +34,9 @@ private constructor(
         @JsonProperty("background_id")
         @ExcludeMissing
         backgroundId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("background_url")
+        @ExcludeMissing
+        backgroundUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("background_version")
         @ExcludeMissing
         backgroundVersion: JsonField<Long> = JsonMissing.of(),
@@ -41,7 +45,15 @@ private constructor(
         @JsonProperty("has_background")
         @ExcludeMissing
         hasBackground: JsonField<Boolean> = JsonMissing.of(),
-    ) : this(backgroundId, backgroundVersion, changed, chatId, hasBackground, mutableMapOf())
+    ) : this(
+        backgroundId,
+        backgroundUrl,
+        backgroundVersion,
+        changed,
+        chatId,
+        hasBackground,
+        mutableMapOf(),
+    )
 
     /**
      * Unique identifier for the current background, or null if none
@@ -51,6 +63,16 @@ private constructor(
      */
     fun backgroundId(): Optional<String> = backgroundId.getOptional("background_id")
 
+    /**
+     * Public URL of the persisted background image stored in R2. Returned after a successful PUT
+     * and on GET when a background has been set through the API. May be null if persistence failed
+     * or the background was set outside of the API.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun backgroundUrl(): Optional<String> = backgroundUrl.getOptional("background_url")
+
     /**
      * Version number of the background (for cache invalidation)
      *
@@ -92,6 +114,15 @@ private constructor(
     @ExcludeMissing
     fun _backgroundId(): JsonField<String> = backgroundId
 
+    /**
+     * Returns the raw JSON value of [backgroundUrl].
+     *
+     * Unlike [backgroundUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background_url")
+    @ExcludeMissing
+    fun _backgroundUrl(): JsonField<String> = backgroundUrl
+
     /**
      * Returns the raw JSON value of [backgroundVersion].
      *
@@ -147,6 +178,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var backgroundId: JsonField<String> = JsonMissing.of()
+        private var backgroundUrl: JsonField<String> = JsonMissing.of()
         private var backgroundVersion: JsonField<Long> = JsonMissing.of()
         private var changed: JsonField<Boolean> = JsonMissing.of()
         private var chatId: JsonField<String> = JsonMissing.of()
@@ -156,6 +188,7 @@ private constructor(
         @JvmSynthetic
         internal fun from(chatBackgroundResponse: ChatBackgroundResponse) = apply {
             backgroundId = chatBackgroundResponse.backgroundId
+            backgroundUrl = chatBackgroundResponse.backgroundUrl
             backgroundVersion = chatBackgroundResponse.backgroundVersion
             changed = chatBackgroundResponse.changed
             chatId = chatBackgroundResponse.chatId
@@ -180,6 +213,29 @@ private constructor(
             this.backgroundId = backgroundId
         }
 
+        /**
+         * Public URL of the persisted background image stored in R2. Returned after a successful
+         * PUT and on GET when a background has been set through the API. May be null if persistence
+         * failed or the background was set outside of the API.
+         */
+        fun backgroundUrl(backgroundUrl: String?) =
+            backgroundUrl(JsonField.ofNullable(backgroundUrl))
+
+        /** Alias for calling [Builder.backgroundUrl] with `backgroundUrl.orElse(null)`. */
+        fun backgroundUrl(backgroundUrl: Optional<String>) =
+            backgroundUrl(backgroundUrl.getOrNull())
+
+        /**
+         * Sets [Builder.backgroundUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.backgroundUrl] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun backgroundUrl(backgroundUrl: JsonField<String>) = apply {
+            this.backgroundUrl = backgroundUrl
+        }
+
         /** Version number of the background (for cache invalidation) */
         fun backgroundVersion(backgroundVersion: Long?) =
             backgroundVersion(JsonField.ofNullable(backgroundVersion))
@@ -270,6 +326,7 @@ private constructor(
         fun build(): ChatBackgroundResponse =
             ChatBackgroundResponse(
                 backgroundId,
+                backgroundUrl,
                 backgroundVersion,
                 changed,
                 chatId,
@@ -294,6 +351,7 @@ private constructor(
         }
 
         backgroundId()
+        backgroundUrl()
         backgroundVersion()
         changed()
         chatId()
@@ -317,6 +375,7 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (backgroundId.asKnown().isPresent) 1 else 0) +
+            (if (backgroundUrl.asKnown().isPresent) 1 else 0) +
             (if (backgroundVersion.asKnown().isPresent) 1 else 0) +
             (if (changed.asKnown().isPresent) 1 else 0) +
             (if (chatId.asKnown().isPresent) 1 else 0) +
@@ -329,6 +388,7 @@ private constructor(
 
         return other is ChatBackgroundResponse &&
             backgroundId == other.backgroundId &&
+            backgroundUrl == other.backgroundUrl &&
             backgroundVersion == other.backgroundVersion &&
             changed == other.changed &&
             chatId == other.chatId &&
@@ -339,6 +399,7 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             backgroundId,
+            backgroundUrl,
             backgroundVersion,
             changed,
             chatId,
@@ -350,5 +411,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
+        "ChatBackgroundResponse{backgroundId=$backgroundId, backgroundUrl=$backgroundUrl, backgroundVersion=$backgroundVersion, changed=$changed, chatId=$chatId, hasBackground=$hasBackground, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
index 2a496eb..90a1f3a 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -8,6 +8,7 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.blooio.api.models.contacts.Pagination
@@ -245,6 +246,7 @@ private constructor(
         private val messageId: JsonField<String>,
         private val protocol: JsonField<Protocol>,
         private val reactions: JsonField<List<Reaction>>,
+        private val replyTo: JsonField<ReplyTo>,
         private val sender: JsonField<String>,
         private val status: JsonField<Status>,
         private val text: JsonField<String>,
@@ -277,6 +279,9 @@ private constructor(
             @JsonProperty("reactions")
             @ExcludeMissing
             reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+            @JsonProperty("reply_to")
+            @ExcludeMissing
+            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
             @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
             @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -293,6 +298,7 @@ private constructor(
             messageId,
             protocol,
             reactions,
+            replyTo,
             sender,
             status,
             text,
@@ -355,6 +361,15 @@ private constructor(
          */
         fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -454,6 +469,13 @@ private constructor(
         @ExcludeMissing
         fun _reactions(): JsonField<List<Reaction>> = reactions
 
+        /**
+         * Returns the raw JSON value of [replyTo].
+         *
+         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
         /**
          * Returns the raw JSON value of [sender].
          *
@@ -521,6 +543,7 @@ private constructor(
             private var messageId: JsonField<String> = JsonMissing.of()
             private var protocol: JsonField<Protocol> = JsonMissing.of()
             private var reactions: JsonField<MutableList<Reaction>>? = null
+            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var sender: JsonField<String> = JsonMissing.of()
             private var status: JsonField<Status> = JsonMissing.of()
             private var text: JsonField<String> = JsonMissing.of()
@@ -538,6 +561,7 @@ private constructor(
                 messageId = message.messageId
                 protocol = message.protocol
                 reactions = message.reactions.map { it.toMutableList() }
+                replyTo = message.replyTo
                 sender = message.sender
                 status = message.status
                 text = message.text
@@ -674,6 +698,24 @@ private constructor(
                     }
             }
 
+            /**
+             * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+             * every GET endpoint that returns a single message or a list of messages.
+             */
+            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+            /**
+             * Sets [Builder.replyTo] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
             /**
              * Sender's phone number or email for inbound group messages. Null for outbound messages
              * and 1-1 chats.
@@ -790,6 +832,7 @@ private constructor(
                     messageId,
                     protocol,
                     (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                    replyTo,
                     sender,
                     status,
                     text,
@@ -823,6 +866,7 @@ private constructor(
             messageId()
             protocol().ifPresent { it.validate() }
             reactions().ifPresent { it.forEach { it.validate() } }
+            replyTo().ifPresent { it.validate() }
             sender()
             status().ifPresent { it.validate() }
             text()
@@ -855,6 +899,7 @@ private constructor(
                 (if (messageId.asKnown().isPresent) 1 else 0) +
                 (protocol.asKnown().getOrNull()?.validity() ?: 0) +
                 (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (sender.asKnown().isPresent) 1 else 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (text.asKnown().isPresent) 1 else 0) +
@@ -1154,6 +1199,287 @@ private constructor(
             override fun toString() = value.toString()
         }
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         */
+        class ReplyTo
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val guid: JsonField<String>,
+            private val messageId: JsonField<String>,
+            private val partIndex: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("message_id")
+                @ExcludeMissing
+                messageId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("part_index")
+                @ExcludeMissing
+                partIndex: JsonField<Long> = JsonMissing.of(),
+            ) : this(guid, messageId, partIndex, mutableMapOf())
+
+            /**
+             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+             * on-device record-of-truth identifier that survives even when `message_id` cannot be
+             * resolved.
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun guid(): Optional<String> = guid.getOptional("guid")
+
+            /**
+             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+            /**
+             * Which part of the parent was replied to. 0 for the common single-part case.
+             *
+             * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun partIndex(): Long = partIndex.getRequired("part_index")
+
+            /**
+             * Returns the raw JSON value of [guid].
+             *
+             * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+            /**
+             * Returns the raw JSON value of [messageId].
+             *
+             * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            fun _messageId(): JsonField<String> = messageId
+
+            /**
+             * Returns the raw JSON value of [partIndex].
+             *
+             * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            fun _partIndex(): JsonField<Long> = partIndex
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ReplyTo].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .guid()
+                 * .messageId()
+                 * .partIndex()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ReplyTo]. */
+            class Builder internal constructor() {
+
+                private var guid: JsonField<String>? = null
+                private var messageId: JsonField<String>? = null
+                private var partIndex: JsonField<Long>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(replyTo: ReplyTo) = apply {
+                    guid = replyTo.guid
+                    messageId = replyTo.messageId
+                    partIndex = replyTo.partIndex
+                    additionalProperties = replyTo.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+                 * on-device record-of-truth identifier that survives even when `message_id` cannot
+                 * be resolved.
+                 */
+                fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
+
+                /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
+                fun guid(guid: Optional<String>) = guid(guid.getOrNull())
+
+                /**
+                 * Sets [Builder.guid] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.guid] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+                /**
+                 * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+                 * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+                 */
+                fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
+
+                /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
+                fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+
+                /**
+                 * Sets [Builder.messageId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.messageId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+                /** Which part of the parent was replied to. 0 for the common single-part case. */
+                fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+                /**
+                 * Sets [Builder.partIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.partIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ReplyTo].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .guid()
+                 * .messageId()
+                 * .partIndex()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ReplyTo =
+                    ReplyTo(
+                        checkRequired("guid", guid),
+                        checkRequired("messageId", messageId),
+                        checkRequired("partIndex", partIndex),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ReplyTo = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                guid()
+                messageId()
+                partIndex()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: BlooioInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (guid.asKnown().isPresent) 1 else 0) +
+                    (if (messageId.asKnown().isPresent) 1 else 0) +
+                    (if (partIndex.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ReplyTo &&
+                    guid == other.guid &&
+                    messageId == other.messageId &&
+                    partIndex == other.partIndex &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(guid, messageId, partIndex, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+        }
+
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -1337,6 +1663,7 @@ private constructor(
                 messageId == other.messageId &&
                 protocol == other.protocol &&
                 reactions == other.reactions &&
+                replyTo == other.replyTo &&
                 sender == other.sender &&
                 status == other.status &&
                 text == other.text &&
@@ -1355,6 +1682,7 @@ private constructor(
                 messageId,
                 protocol,
                 reactions,
+                replyTo,
                 sender,
                 status,
                 text,
@@ -1367,7 +1695,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+            "Message{attachments=$attachments, direction=$direction, error=$error, externalId=$externalId, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
index 165f086..f7170a1 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -8,6 +8,7 @@ import com.blooio.api.core.JsonField
 import com.blooio.api.core.JsonMissing
 import com.blooio.api.core.JsonValue
 import com.blooio.api.core.checkKnown
+import com.blooio.api.core.checkRequired
 import com.blooio.api.core.toImmutable
 import com.blooio.api.errors.BlooioInvalidDataException
 import com.fasterxml.jackson.annotation.JsonAnyGetter
@@ -31,6 +32,7 @@ private constructor(
     private val messageId: JsonField<String>,
     private val protocol: JsonField<Protocol>,
     private val reactions: JsonField<List<Reaction>>,
+    private val replyTo: JsonField<ReplyTo>,
     private val sender: JsonField<String>,
     private val status: JsonField<Status>,
     private val text: JsonField<String>,
@@ -58,6 +60,7 @@ private constructor(
         @JsonProperty("reactions")
         @ExcludeMissing
         reactions: JsonField<List<Reaction>> = JsonMissing.of(),
+        @JsonProperty("reply_to") @ExcludeMissing replyTo: JsonField<ReplyTo> = JsonMissing.of(),
         @JsonProperty("sender") @ExcludeMissing sender: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
@@ -75,6 +78,7 @@ private constructor(
         messageId,
         protocol,
         reactions,
+        replyTo,
         sender,
         status,
         text,
@@ -141,6 +145,15 @@ private constructor(
      */
     fun reactions(): Optional<List<Reaction>> = reactions.getOptional("reactions")
 
+    /**
+     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
+     * GET endpoint that returns a single message or a list of messages.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
     /**
      * Sender's phone number or email for inbound group messages. Null for outbound messages and 1-1
      * chats.
@@ -241,6 +254,13 @@ private constructor(
     @ExcludeMissing
     fun _reactions(): JsonField<List<Reaction>> = reactions
 
+    /**
+     * Returns the raw JSON value of [replyTo].
+     *
+     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
     /**
      * Returns the raw JSON value of [sender].
      *
@@ -308,6 +328,7 @@ private constructor(
         private var messageId: JsonField<String> = JsonMissing.of()
         private var protocol: JsonField<Protocol> = JsonMissing.of()
         private var reactions: JsonField<MutableList<Reaction>>? = null
+        private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
         private var sender: JsonField<String> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
         private var text: JsonField<String> = JsonMissing.of()
@@ -326,6 +347,7 @@ private constructor(
             messageId = messageRetrieveResponse.messageId
             protocol = messageRetrieveResponse.protocol
             reactions = messageRetrieveResponse.reactions.map { it.toMutableList() }
+            replyTo = messageRetrieveResponse.replyTo
             sender = messageRetrieveResponse.sender
             status = messageRetrieveResponse.status
             text = messageRetrieveResponse.text
@@ -472,6 +494,23 @@ private constructor(
                 }
         }
 
+        /**
+         * Inline-reply parent reference. Identical shape on `message.received` webhooks and on
+         * every GET endpoint that returns a single message or a list of messages.
+         */
+        fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+        /**
+         * Sets [Builder.replyTo] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
         /**
          * Sender's phone number or email for inbound group messages. Null for outbound messages and
          * 1-1 chats.
@@ -583,6 +622,7 @@ private constructor(
                 messageId,
                 protocol,
                 (reactions ?: JsonMissing.of()).map { it.toImmutable() },
+                replyTo,
                 sender,
                 status,
                 text,
@@ -616,6 +656,7 @@ private constructor(
         messageId()
         protocol().ifPresent { it.validate() }
         reactions().ifPresent { it.forEach { it.validate() } }
+        replyTo().ifPresent { it.validate() }
         sender()
         status().ifPresent { it.validate() }
         text()
@@ -648,6 +689,7 @@ private constructor(
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (protocol.asKnown().getOrNull()?.validity() ?: 0) +
             (reactions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
             (if (sender.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (text.asKnown().isPresent) 1 else 0) +
@@ -1162,6 +1204,276 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Inline-reply parent reference. Identical shape on `message.received` webhooks and on every
+     * GET endpoint that returns a single message or a list of messages.
+     */
+    class ReplyTo
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val guid: JsonField<String>,
+        private val messageId: JsonField<String>,
+        private val partIndex: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            messageId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            partIndex: JsonField<Long> = JsonMissing.of(),
+        ) : this(guid, messageId, partIndex, mutableMapOf())
+
+        /**
+         * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+         * on-device record-of-truth identifier that survives even when `message_id` cannot be
+         * resolved.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun guid(): Optional<String> = guid.getOptional("guid")
+
+        /**
+         * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+         * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+        /**
+         * Which part of the parent was replied to. 0 for the common single-part case.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun partIndex(): Long = partIndex.getRequired("part_index")
+
+        /**
+         * Returns the raw JSON value of [guid].
+         *
+         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+        /**
+         * Returns the raw JSON value of [messageId].
+         *
+         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+        /**
+         * Returns the raw JSON value of [partIndex].
+         *
+         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ReplyTo].
+             *
+             * The following fields are required:
+             * ```java
+             * .guid()
+             * .messageId()
+             * .partIndex()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ReplyTo]. */
+        class Builder internal constructor() {
+
+            private var guid: JsonField<String>? = null
+            private var messageId: JsonField<String>? = null
+            private var partIndex: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(replyTo: ReplyTo) = apply {
+                guid = replyTo.guid
+                messageId = replyTo.messageId
+                partIndex = replyTo.partIndex
+                additionalProperties = replyTo.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The raw iMessage GUID of the parent. Always populated on real inline replies; the
+             * on-device record-of-truth identifier that survives even when `message_id` cannot be
+             * resolved.
+             */
+            fun guid(guid: String?) = guid(JsonField.ofNullable(guid))
+
+            /** Alias for calling [Builder.guid] with `guid.orElse(null)`. */
+            fun guid(guid: Optional<String>) = guid(guid.getOrNull())
+
+            /**
+             * Sets [Builder.guid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+            /**
+             * The Blooio `message_id` of the parent message. NULL when the parent isn't in our
+             * `messages` table (e.g., the original was sent from outside Blooio's pipeline).
+             */
+            fun messageId(messageId: String?) = messageId(JsonField.ofNullable(messageId))
+
+            /** Alias for calling [Builder.messageId] with `messageId.orElse(null)`. */
+            fun messageId(messageId: Optional<String>) = messageId(messageId.getOrNull())
+
+            /**
+             * Sets [Builder.messageId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+            /** Which part of the parent was replied to. 0 for the common single-part case. */
+            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+            /**
+             * Sets [Builder.partIndex] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ReplyTo].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .guid()
+             * .messageId()
+             * .partIndex()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ReplyTo =
+                ReplyTo(
+                    checkRequired("guid", guid),
+                    checkRequired("messageId", messageId),
+                    checkRequired("partIndex", partIndex),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ReplyTo = apply {
+            if (validated) {
+                return@apply
+            }
+
+            guid()
+            messageId()
+            partIndex()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (guid.asKnown().isPresent) 1 else 0) +
+                (if (messageId.asKnown().isPresent) 1 else 0) +
+                (if (partIndex.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ReplyTo &&
+                guid == other.guid &&
+                messageId == other.messageId &&
+                partIndex == other.partIndex &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(guid, messageId, partIndex, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+    }
+
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -1341,6 +1653,7 @@ private constructor(
             messageId == other.messageId &&
             protocol == other.protocol &&
             reactions == other.reactions &&
+            replyTo == other.replyTo &&
             sender == other.sender &&
             status == other.status &&
             text == other.text &&
@@ -1360,6 +1673,7 @@ private constructor(
             messageId,
             protocol,
             reactions,
+            replyTo,
             sender,
             status,
             text,
@@ -1372,5 +1686,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
+        "MessageRetrieveResponse{attachments=$attachments, chatId=$chatId, contact=$contact, direction=$direction, error=$error, internalId=$internalId, messageId=$messageId, protocol=$protocol, reactions=$reactions, replyTo=$replyTo, sender=$sender, status=$status, text=$text, timeDelivered=$timeDelivered, timeSent=$timeSent, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
index 08630f9..4de8d50 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendParams.kt
@@ -46,6 +46,17 @@ import kotlin.jvm.optionals.getOrNull
  * lasers, fireworks, celebration). Effects are an iMessage-only feature — when the recipient is on
  * SMS/RCS the message is delivered without the animation. Effects are not supported in multipart
  * (`parts`) mode.
+ *
+ * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+ * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+ * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common — the
+ * message_id returned by an earlier send or surfaced on a `message.received` webhook), or `{
+ * "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where the
+ * parent wasn't recorded by Blooio. The reply must target the same chat and the same from-number as
+ * the new send, and the parent must be no older than 30 days (the iMessage on-device retention
+ * horizon). Reply support is iMessage-only and is rejected on Twilio, dashboard-Twilio, and hybrid
+ * send paths; it's also rejected on multi-message fan-outs (`text` array or per-part URL-balloon
+ * batch). See the `400` responses for the full set of `reply_target_*` error codes.
  */
 class MessageSendParams
 private constructor(
@@ -138,6 +149,18 @@ private constructor(
      */
     fun parts(): Optional<List<Part>> = body.parts()
 
+    /**
+     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
+     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
+     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
+     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
+     * reply on the recipient's device.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun replyTo(): Optional<ReplyTo> = body.replyTo()
+
     /**
      * If true, the contact card (Name & Photo) will be shared with this message. The contact card
      * is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on **Dedicated
@@ -199,6 +222,13 @@ private constructor(
      */
     fun _parts(): JsonField<List<Part>> = body._parts()
 
+    /**
+     * Returns the raw JSON value of [replyTo].
+     *
+     * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _replyTo(): JsonField<ReplyTo> = body._replyTo()
+
     /**
      * Returns the raw JSON value of [shareContact].
      *
@@ -422,6 +452,26 @@ private constructor(
          */
         fun addPart(part: Part) = apply { body.addPart(part) }
 
+        /**
+         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
+         * replying to messages received before the row was minted in Blooio). The new send is
+         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
+         * renders as an inline reply on the recipient's device.
+         */
+        fun replyTo(replyTo: ReplyTo?) = apply { body.replyTo(replyTo) }
+
+        /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+        fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+        /**
+         * Sets [Builder.replyTo] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun replyTo(replyTo: JsonField<ReplyTo>) = apply { body.replyTo(replyTo) }
+
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on
@@ -636,6 +686,7 @@ private constructor(
         private val fromNumber: JsonField<String>,
         private val linkPreview: JsonField<LinkPreview>,
         private val parts: JsonField<List<Part>>,
+        private val replyTo: JsonField<ReplyTo>,
         private val shareContact: JsonField<Boolean>,
         private val text: JsonField<Text>,
         private val useTypingIndicator: JsonField<Boolean>,
@@ -655,6 +706,9 @@ private constructor(
             @ExcludeMissing
             linkPreview: JsonField<LinkPreview> = JsonMissing.of(),
             @JsonProperty("parts") @ExcludeMissing parts: JsonField<List<Part>> = JsonMissing.of(),
+            @JsonProperty("reply_to")
+            @ExcludeMissing
+            replyTo: JsonField<ReplyTo> = JsonMissing.of(),
             @JsonProperty("share_contact")
             @ExcludeMissing
             shareContact: JsonField<Boolean> = JsonMissing.of(),
@@ -668,6 +722,7 @@ private constructor(
             fromNumber,
             linkPreview,
             parts,
+            replyTo,
             shareContact,
             text,
             useTypingIndicator,
@@ -752,6 +807,18 @@ private constructor(
          */
         fun parts(): Optional<List<Part>> = parts.getOptional("parts")
 
+        /**
+         * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+         * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for
+         * replying to messages received before the row was minted in Blooio). The new send is
+         * dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which iMessage
+         * renders as an inline reply on the recipient's device.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun replyTo(): Optional<ReplyTo> = replyTo.getOptional("reply_to")
+
         /**
          * If true, the contact card (Name & Photo) will be shared with this message. The contact
          * card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only available on
@@ -822,6 +889,13 @@ private constructor(
          */
         @JsonProperty("parts") @ExcludeMissing fun _parts(): JsonField<List<Part>> = parts
 
+        /**
+         * Returns the raw JSON value of [replyTo].
+         *
+         * Unlike [replyTo], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reply_to") @ExcludeMissing fun _replyTo(): JsonField<ReplyTo> = replyTo
+
         /**
          * Returns the raw JSON value of [shareContact].
          *
@@ -875,6 +949,7 @@ private constructor(
             private var fromNumber: JsonField<String> = JsonMissing.of()
             private var linkPreview: JsonField<LinkPreview> = JsonMissing.of()
             private var parts: JsonField<MutableList<Part>>? = null
+            private var replyTo: JsonField<ReplyTo> = JsonMissing.of()
             private var shareContact: JsonField<Boolean> = JsonMissing.of()
             private var text: JsonField<Text> = JsonMissing.of()
             private var useTypingIndicator: JsonField<Boolean> = JsonMissing.of()
@@ -887,6 +962,7 @@ private constructor(
                 fromNumber = body.fromNumber
                 linkPreview = body.linkPreview
                 parts = body.parts.map { it.toMutableList() }
+                replyTo = body.replyTo
                 shareContact = body.shareContact
                 text = body.text
                 useTypingIndicator = body.useTypingIndicator
@@ -1050,6 +1126,27 @@ private constructor(
                     }
             }
 
+            /**
+             * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id`
+             * (preferred — references a Blooio-minted message) or `guid` (raw iMessage GUID, useful
+             * for replying to messages received before the row was minted in Blooio). The new send
+             * is dispatched to Lava with the resolved `selectedMessageGuid` + `partIndex`, which
+             * iMessage renders as an inline reply on the recipient's device.
+             */
+            fun replyTo(replyTo: ReplyTo?) = replyTo(JsonField.ofNullable(replyTo))
+
+            /** Alias for calling [Builder.replyTo] with `replyTo.orElse(null)`. */
+            fun replyTo(replyTo: Optional<ReplyTo>) = replyTo(replyTo.getOrNull())
+
+            /**
+             * Sets [Builder.replyTo] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.replyTo] with a well-typed [ReplyTo] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun replyTo(replyTo: JsonField<ReplyTo>) = apply { this.replyTo = replyTo }
+
             /**
              * If true, the contact card (Name & Photo) will be shared with this message. The
              * contact card is piggybacked onto the outgoing message. Defaults to false. ⚠️ Only
@@ -1136,6 +1233,7 @@ private constructor(
                     fromNumber,
                     linkPreview,
                     (parts ?: JsonMissing.of()).map { it.toImmutable() },
+                    replyTo,
                     shareContact,
                     text,
                     useTypingIndicator,
@@ -1164,6 +1262,7 @@ private constructor(
             fromNumber()
             linkPreview().ifPresent { it.validate() }
             parts().ifPresent { it.forEach { it.validate() } }
+            replyTo().ifPresent { it.validate() }
             shareContact()
             text().ifPresent { it.validate() }
             useTypingIndicator()
@@ -1191,6 +1290,7 @@ private constructor(
                 (if (fromNumber.asKnown().isPresent) 1 else 0) +
                 (linkPreview.asKnown().getOrNull()?.validity() ?: 0) +
                 (parts.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (replyTo.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (shareContact.asKnown().isPresent) 1 else 0) +
                 (text.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (useTypingIndicator.asKnown().isPresent) 1 else 0)
@@ -1206,6 +1306,7 @@ private constructor(
                 fromNumber == other.fromNumber &&
                 linkPreview == other.linkPreview &&
                 parts == other.parts &&
+                replyTo == other.replyTo &&
                 shareContact == other.shareContact &&
                 text == other.text &&
                 useTypingIndicator == other.useTypingIndicator &&
@@ -1219,6 +1320,7 @@ private constructor(
                 fromNumber,
                 linkPreview,
                 parts,
+                replyTo,
                 shareContact,
                 text,
                 useTypingIndicator,
@@ -1229,7 +1331,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
+            "Body{attachments=$attachments, effect=$effect, fromNumber=$fromNumber, linkPreview=$linkPreview, parts=$parts, replyTo=$replyTo, shareContact=$shareContact, text=$text, useTypingIndicator=$useTypingIndicator, additionalProperties=$additionalProperties}"
     }
 
     /** URL to the attachment */
@@ -2206,6 +2308,256 @@ private constructor(
             "Part{linkPreview=$linkPreview, mention=$mention, name=$name, text=$text, url=$url, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * Inline-reply target on `POST /chats/{chatId}/messages`. Pass either `message_id` (preferred —
+     * references a Blooio-minted message) or `guid` (raw iMessage GUID, useful for replying to
+     * messages received before the row was minted in Blooio). The new send is dispatched to Lava
+     * with the resolved `selectedMessageGuid` + `partIndex`, which iMessage renders as an inline
+     * reply on the recipient's device.
+     */
+    class ReplyTo
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val guid: JsonField<String>,
+        private val messageId: JsonField<String>,
+        private val partIndex: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("guid") @ExcludeMissing guid: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message_id")
+            @ExcludeMissing
+            messageId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("part_index")
+            @ExcludeMissing
+            partIndex: JsonField<Long> = JsonMissing.of(),
+        ) : this(guid, messageId, partIndex, mutableMapOf())
+
+        /**
+         * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio attempts to
+         * look up the parent via `provider_message_guid`; if the parent isn't in our table the send
+         * still proceeds (Lava will thread on the device when possible) and the response carries
+         * `parent_unresolved: true`.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun guid(): Optional<String> = guid.getOptional("guid")
+
+        /**
+         * Blooio `message_id` of the parent. Must belong to the same chat, same from-number, and be
+         * no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun messageId(): Optional<String> = messageId.getOptional("message_id")
+
+        /**
+         * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying to a
+         * single-part text message).
+         *
+         * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun partIndex(): Optional<Long> = partIndex.getOptional("part_index")
+
+        /**
+         * Returns the raw JSON value of [guid].
+         *
+         * Unlike [guid], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("guid") @ExcludeMissing fun _guid(): JsonField<String> = guid
+
+        /**
+         * Returns the raw JSON value of [messageId].
+         *
+         * Unlike [messageId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message_id") @ExcludeMissing fun _messageId(): JsonField<String> = messageId
+
+        /**
+         * Returns the raw JSON value of [partIndex].
+         *
+         * Unlike [partIndex], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("part_index") @ExcludeMissing fun _partIndex(): JsonField<Long> = partIndex
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [ReplyTo]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ReplyTo]. */
+        class Builder internal constructor() {
+
+            private var guid: JsonField<String> = JsonMissing.of()
+            private var messageId: JsonField<String> = JsonMissing.of()
+            private var partIndex: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(replyTo: ReplyTo) = apply {
+                guid = replyTo.guid
+                messageId = replyTo.messageId
+                partIndex = replyTo.partIndex
+                additionalProperties = replyTo.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Raw iMessage GUID of the parent. When supplied without a `message_id`, Blooio
+             * attempts to look up the parent via `provider_message_guid`; if the parent isn't in
+             * our table the send still proceeds (Lava will thread on the device when possible) and
+             * the response carries `parent_unresolved: true`.
+             */
+            fun guid(guid: String) = guid(JsonField.of(guid))
+
+            /**
+             * Sets [Builder.guid] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.guid] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun guid(guid: JsonField<String>) = apply { this.guid = guid }
+
+            /**
+             * Blooio `message_id` of the parent. Must belong to the same chat, same from-number,
+             * and be no older than 30 days. Returns 404 `reply_target_not_found` if unknown.
+             */
+            fun messageId(messageId: String) = messageId(JsonField.of(messageId))
+
+            /**
+             * Sets [Builder.messageId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.messageId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
+
+            /**
+             * Which part of the parent to reply to. Defaults to 0 (covers the 99% case of replying
+             * to a single-part text message).
+             */
+            fun partIndex(partIndex: Long) = partIndex(JsonField.of(partIndex))
+
+            /**
+             * Sets [Builder.partIndex] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.partIndex] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun partIndex(partIndex: JsonField<Long>) = apply { this.partIndex = partIndex }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ReplyTo].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): ReplyTo =
+                ReplyTo(guid, messageId, partIndex, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws BlooioInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ReplyTo = apply {
+            if (validated) {
+                return@apply
+            }
+
+            guid()
+            messageId()
+            partIndex()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: BlooioInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (guid.asKnown().isPresent) 1 else 0) +
+                (if (messageId.asKnown().isPresent) 1 else 0) +
+                (if (partIndex.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ReplyTo &&
+                guid == other.guid &&
+                messageId == other.messageId &&
+                partIndex == other.partIndex &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(guid, messageId, partIndex, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
+    }
+
     /**
      * Message text. Can be a single string or array of strings (each becomes a separate message)
      */
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
index 9204c59..30b4213 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -28,6 +28,7 @@ private constructor(
     private val groupId: JsonField<String>,
     private val messageId: JsonField<String>,
     private val messageIds: JsonField<List<String>>,
+    private val parentUnresolved: JsonField<Boolean>,
     private val participants: JsonField<List<String>>,
     private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -44,6 +45,9 @@ private constructor(
         @JsonProperty("message_ids")
         @ExcludeMissing
         messageIds: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("parent_unresolved")
+        @ExcludeMissing
+        parentUnresolved: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("participants")
         @ExcludeMissing
         participants: JsonField<List<String>> = JsonMissing.of(),
@@ -54,6 +58,7 @@ private constructor(
         groupId,
         messageId,
         messageIds,
+        parentUnresolved,
         participants,
         status,
         mutableMapOf(),
@@ -100,6 +105,16 @@ private constructor(
      */
     fun messageIds(): Optional<List<String>> = messageIds.getOptional("message_ids")
 
+    /**
+     * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and the
+     * GUID didn't map to any Blooio-minted row. The send still proceeds and the device may still
+     * thread it; this flag signals that Blooio couldn't link the new message to a known parent.
+     *
+     * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parentUnresolved(): Optional<Boolean> = parentUnresolved.getOptional("parent_unresolved")
+
     /**
      * List of participants (present for multi-recipient)
      *
@@ -155,6 +170,16 @@ private constructor(
     @ExcludeMissing
     fun _messageIds(): JsonField<List<String>> = messageIds
 
+    /**
+     * Returns the raw JSON value of [parentUnresolved].
+     *
+     * Unlike [parentUnresolved], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("parent_unresolved")
+    @ExcludeMissing
+    fun _parentUnresolved(): JsonField<Boolean> = parentUnresolved
+
     /**
      * Returns the raw JSON value of [participants].
      *
@@ -197,6 +222,7 @@ private constructor(
         private var groupId: JsonField<String> = JsonMissing.of()
         private var messageId: JsonField<String> = JsonMissing.of()
         private var messageIds: JsonField<MutableList<String>>? = null
+        private var parentUnresolved: JsonField<Boolean> = JsonMissing.of()
         private var participants: JsonField<MutableList<String>>? = null
         private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -208,6 +234,7 @@ private constructor(
             groupId = messageSendResponse.groupId
             messageId = messageSendResponse.messageId
             messageIds = messageSendResponse.messageIds.map { it.toMutableList() }
+            parentUnresolved = messageSendResponse.parentUnresolved
             participants = messageSendResponse.participants.map { it.toMutableList() }
             status = messageSendResponse.status
             additionalProperties = messageSendResponse.additionalProperties.toMutableMap()
@@ -290,6 +317,26 @@ private constructor(
                 }
         }
 
+        /**
+         * Present (and `true`) only when `reply_to.guid` was supplied without a `message_id` and
+         * the GUID didn't map to any Blooio-minted row. The send still proceeds and the device may
+         * still thread it; this flag signals that Blooio couldn't link the new message to a known
+         * parent.
+         */
+        fun parentUnresolved(parentUnresolved: Boolean) =
+            parentUnresolved(JsonField.of(parentUnresolved))
+
+        /**
+         * Sets [Builder.parentUnresolved] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parentUnresolved] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parentUnresolved(parentUnresolved: JsonField<Boolean>) = apply {
+            this.parentUnresolved = parentUnresolved
+        }
+
         /** List of participants (present for multi-recipient) */
         fun participants(participants: List<String>) = participants(JsonField.of(participants))
 
@@ -358,6 +405,7 @@ private constructor(
                 groupId,
                 messageId,
                 (messageIds ?: JsonMissing.of()).map { it.toImmutable() },
+                parentUnresolved,
                 (participants ?: JsonMissing.of()).map { it.toImmutable() },
                 status,
                 additionalProperties.toMutableMap(),
@@ -384,6 +432,7 @@ private constructor(
         groupId()
         messageId()
         messageIds()
+        parentUnresolved()
         participants()
         status().ifPresent { it.validate() }
         validated = true
@@ -409,6 +458,7 @@ private constructor(
             (if (groupId.asKnown().isPresent) 1 else 0) +
             (if (messageId.asKnown().isPresent) 1 else 0) +
             (messageIds.asKnown().getOrNull()?.size ?: 0) +
+            (if (parentUnresolved.asKnown().isPresent) 1 else 0) +
             (participants.asKnown().getOrNull()?.size ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
@@ -558,6 +608,7 @@ private constructor(
             groupId == other.groupId &&
             messageId == other.messageId &&
             messageIds == other.messageIds &&
+            parentUnresolved == other.parentUnresolved &&
             participants == other.participants &&
             status == other.status &&
             additionalProperties == other.additionalProperties
@@ -570,6 +621,7 @@ private constructor(
             groupId,
             messageId,
             messageIds,
+            parentUnresolved,
             participants,
             status,
             additionalProperties,
@@ -579,5 +631,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
+        "MessageSendResponse{count=$count, groupCreated=$groupCreated, groupId=$groupId, messageId=$messageId, messageIds=$messageIds, parentUnresolved=$parentUnresolved, participants=$participants, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
index 84755c9..de51d70 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/MessageServiceAsync.kt
@@ -160,6 +160,18 @@ interface MessageServiceAsync {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
+     *
+     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
+     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
+     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
+     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
+     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
+     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
+     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
+     * array or per-part URL-balloon batch). See the `400` responses for the full set of
+     * `reply_target_*` error codes.
      */
     fun send(chatId: String): CompletableFuture<MessageSendResponse> =
         send(chatId, MessageSendParams.none())
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
index 1141d3f..2b524b8 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/MessageService.kt
@@ -145,6 +145,18 @@ interface MessageService {
      * confetti, love, lasers, fireworks, celebration). Effects are an iMessage-only feature — when
      * the recipient is on SMS/RCS the message is delivered without the animation. Effects are not
      * supported in multipart (`parts`) mode.
+     *
+     * **Threaded replies (iMessage inline reply):** set the optional `reply_to` field to send the
+     * outgoing message as a reply to a specific earlier message. Two shapes are accepted: `{
+     * "message_id": "msg_…" }` references a Blooio-minted message in the same chat (most common —
+     * the message_id returned by an earlier send or surfaced on a `message.received` webhook), or
+     * `{ "guid": "…", "part_index": 0 }` references the raw iMessage GUID for the rare case where
+     * the parent wasn't recorded by Blooio. The reply must target the same chat and the same
+     * from-number as the new send, and the parent must be no older than 30 days (the iMessage
+     * on-device retention horizon). Reply support is iMessage-only and is rejected on Twilio,
+     * dashboard-Twilio, and hybrid send paths; it's also rejected on multi-message fan-outs (`text`
+     * array or per-part URL-balloon batch). See the `400` responses for the full set of
+     * `reply_target_*` error codes.
      */
     fun send(chatId: String): MessageSendResponse = send(chatId, MessageSendParams.none())
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
index 76639bc..28b94e9 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatListResponseTest.kt
@@ -18,6 +18,8 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
+                        .backgroundId("background_id")
+                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
@@ -53,6 +55,8 @@ internal class ChatListResponseTest {
             .containsExactly(
                 ChatListResponse.Chat.builder()
                     .id("id")
+                    .backgroundId("background_id")
+                    .backgroundUrl("https://example.com")
                     .contact(
                         ChatListResponse.Chat.Contact.builder()
                             .contactId("contact_id")
@@ -93,6 +97,8 @@ internal class ChatListResponseTest {
                 .addChat(
                     ChatListResponse.Chat.builder()
                         .id("id")
+                        .backgroundId("background_id")
+                        .backgroundUrl("https://example.com")
                         .contact(
                             ChatListResponse.Chat.Contact.builder()
                                 .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
index d83add3..bcb592b 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/ChatRetrieveResponseTest.kt
@@ -14,6 +14,8 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
+                .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
@@ -44,6 +46,8 @@ internal class ChatRetrieveResponseTest {
                 .build()
 
         assertThat(chatRetrieveResponse.id()).contains("id")
+        assertThat(chatRetrieveResponse.backgroundId()).contains("background_id")
+        assertThat(chatRetrieveResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatRetrieveResponse.contact())
             .contains(
                 ChatRetrieveResponse.Contact.builder()
@@ -81,6 +85,8 @@ internal class ChatRetrieveResponseTest {
         val chatRetrieveResponse =
             ChatRetrieveResponse.builder()
                 .id("id")
+                .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .contact(
                     ChatRetrieveResponse.Contact.builder()
                         .contactId("contact_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
index 53e1631..b738138 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/background/ChatBackgroundResponseTest.kt
@@ -14,6 +14,7 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")
@@ -21,6 +22,7 @@ internal class ChatBackgroundResponseTest {
                 .build()
 
         assertThat(chatBackgroundResponse.backgroundId()).contains("background_id")
+        assertThat(chatBackgroundResponse.backgroundUrl()).contains("https://example.com")
         assertThat(chatBackgroundResponse.backgroundVersion()).contains(0L)
         assertThat(chatBackgroundResponse.changed()).contains(true)
         assertThat(chatBackgroundResponse.chatId()).contains("chat_id")
@@ -33,6 +35,7 @@ internal class ChatBackgroundResponseTest {
         val chatBackgroundResponse =
             ChatBackgroundResponse.builder()
                 .backgroundId("background_id")
+                .backgroundUrl("https://example.com")
                 .backgroundVersion(0L)
                 .changed(true)
                 .chatId("chat_id")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
index 921b646..c4fd065 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
@@ -34,6 +34,13 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
+                        .replyTo(
+                            MessageListResponse.Message.ReplyTo.builder()
+                                .guid("guid")
+                                .messageId("message_id")
+                                .partIndex(0L)
+                                .build()
+                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
@@ -63,6 +70,13 @@ internal class MessageListResponseTest {
                             .timeSent(0L)
                             .build()
                     )
+                    .replyTo(
+                        MessageListResponse.Message.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .sender("sender")
                     .status(MessageListResponse.Message.Status.PENDING)
                     .text("text")
@@ -97,6 +111,13 @@ internal class MessageListResponseTest {
                                 .timeSent(0L)
                                 .build()
                         )
+                        .replyTo(
+                            MessageListResponse.Message.ReplyTo.builder()
+                                .guid("guid")
+                                .messageId("message_id")
+                                .partIndex(0L)
+                                .build()
+                        )
                         .sender("sender")
                         .status(MessageListResponse.Message.Status.PENDING)
                         .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
index b50572d..c3d847f 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
@@ -37,6 +37,13 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
+                .replyTo(
+                    MessageRetrieveResponse.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
@@ -71,6 +78,14 @@ internal class MessageRetrieveResponseTest {
                     .timeSent(0L)
                     .build()
             )
+        assertThat(messageRetrieveResponse.replyTo())
+            .contains(
+                MessageRetrieveResponse.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
         assertThat(messageRetrieveResponse.sender()).contains("sender")
         assertThat(messageRetrieveResponse.status())
             .contains(MessageRetrieveResponse.Status.PENDING)
@@ -106,6 +121,13 @@ internal class MessageRetrieveResponseTest {
                         .timeSent(0L)
                         .build()
                 )
+                .replyTo(
+                    MessageRetrieveResponse.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .sender("sender")
                 .status(MessageRetrieveResponse.Status.PENDING)
                 .text("text")
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
index fd602ad..5e15a03 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendParamsTest.kt
@@ -31,6 +31,13 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
+            .replyTo(
+                MessageSendParams.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
             .shareContact(true)
             .text("string")
             .useTypingIndicator(true)
@@ -72,6 +79,13 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
+                .replyTo(
+                    MessageSendParams.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -118,6 +132,13 @@ internal class MessageSendParamsTest {
                         .url("url")
                         .build()
                 )
+                .replyTo(
+                    MessageSendParams.ReplyTo.builder()
+                        .guid("guid")
+                        .messageId("message_id")
+                        .partIndex(0L)
+                        .build()
+                )
                 .shareContact(true)
                 .text("string")
                 .useTypingIndicator(true)
@@ -143,6 +164,14 @@ internal class MessageSendParamsTest {
                     .url("url")
                     .build()
             )
+        assertThat(body.replyTo())
+            .contains(
+                MessageSendParams.ReplyTo.builder()
+                    .guid("guid")
+                    .messageId("message_id")
+                    .partIndex(0L)
+                    .build()
+            )
         assertThat(body.shareContact()).contains(true)
         assertThat(body.text()).contains(MessageSendParams.Text.ofString("string"))
         assertThat(body.useTypingIndicator()).contains(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
index 9bb1f1b..1b06a5e 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageSendResponseTest.kt
@@ -19,6 +19,7 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
+                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
@@ -28,6 +29,7 @@ internal class MessageSendResponseTest {
         assertThat(messageSendResponse.groupId()).contains("group_id")
         assertThat(messageSendResponse.messageId()).contains("message_id")
         assertThat(messageSendResponse.messageIds().getOrNull()).containsExactly("string")
+        assertThat(messageSendResponse.parentUnresolved()).contains(true)
         assertThat(messageSendResponse.participants().getOrNull()).containsExactly("string")
         assertThat(messageSendResponse.status()).contains(MessageSendResponse.Status.QUEUED)
     }
@@ -42,6 +44,7 @@ internal class MessageSendResponseTest {
                 .groupId("group_id")
                 .messageId("message_id")
                 .addMessageId("string")
+                .parentUnresolved(true)
                 .addParticipant("string")
                 .status(MessageSendResponse.Status.QUEUED)
                 .build()
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
index 3a57799..40748f3 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/async/chats/MessageServiceAsyncTest.kt
@@ -124,6 +124,13 @@ internal class MessageServiceAsyncTest {
                             .url("url")
                             .build()
                     )
+                    .replyTo(
+                        MessageSendParams.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
index 633bb81..da1b508 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/services/blocking/chats/MessageServiceTest.kt
@@ -120,6 +120,13 @@ internal class MessageServiceTest {
                             .url("url")
                             .build()
                     )
+                    .replyTo(
+                        MessageSendParams.ReplyTo.builder()
+                            .guid("guid")
+                            .messageId("message_id")
+                            .partIndex(0L)
+                            .build()
+                    )
                     .shareContact(true)
                     .text("string")
                     .useTypingIndicator(true)

From 7f51cf6db5c2f96e794de5e08e17d120440b42e8 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 19 Jun 2026 08:20:27 +0000
Subject: [PATCH 56/63] feat(api): api update

---
 .stats.yml                                    |  4 ++--
 .../blooio/api/models/chats/ChatListParams.kt | 20 +++++++++++++++----
 .../chats/background/BackgroundSetParams.kt   |  2 +-
 .../chats/messages/MessageListParams.kt       | 20 +++++++++++++++----
 .../api/models/contacts/ContactListParams.kt  | 20 +++++++++++++++----
 .../api/models/groups/GroupListParams.kt      | 20 +++++++++++++++----
 .../models/groups/members/MemberListParams.kt | 20 +++++++++++++++----
 .../api/models/webhooks/logs/LogListParams.kt | 20 +++++++++++++++----
 .../async/chats/BackgroundServiceAsync.kt     |  2 +-
 .../blocking/chats/BackgroundService.kt       |  2 +-
 10 files changed, 101 insertions(+), 29 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 2d2f694..29f6b09 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-11ec3fc93ebdd4d2d0699c400c1369866e3a892e8fb5270eaa409347a333b8c0.yml
-openapi_spec_hash: 7461099a5a1699f3082bb99147a2399d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-fbf531ca47a2361a9adec0b9845e3569e800f7add519b96776c047cc227e90cc.yml
+openapi_spec_hash: 636c8fd0d0264e47b02eecb86fc9b22d
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
index 31fd4ff..cba7bbc 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/ChatListParams.kt
@@ -24,10 +24,16 @@ private constructor(
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Search query (matches phone/email or contact name) */
@@ -72,7 +78,10 @@ private constructor(
             additionalQueryParams = chatListParams.additionalQueryParams.toBuilder()
         }
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -85,7 +94,10 @@ private constructor(
         /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
         fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
index 0893718..5f3fafe 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/background/BackgroundSetParams.kt
@@ -32,7 +32,7 @@ import kotlin.jvm.optionals.getOrNull
  *
  * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
  * ```bash
- * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+ * curl -X PUT "https://api.blooio.com/v2/api/chats/%2B15551234567/background" \
  *   -H "Authorization: Bearer YOUR_API_KEY" \
  *   -F "background=@/path/to/image.jpg;type=image/jpeg"
  * ```
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
index ff7429b..7e2af9c 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListParams.kt
@@ -32,10 +32,16 @@ private constructor(
     /** Filter by message direction */
     fun direction(): Optional<Direction> = Optional.ofNullable(direction)
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Only messages sent after this timestamp (ms) */
@@ -100,7 +106,10 @@ private constructor(
         /** Alias for calling [Builder.direction] with `direction.orElse(null)`. */
         fun direction(direction: Optional<Direction>) = direction(direction.getOrNull())
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -113,7 +122,10 @@ private constructor(
         /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
         fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
index ac09196..a4d7dc3 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/contacts/ContactListParams.kt
@@ -24,10 +24,16 @@ private constructor(
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Search query (matches identifier or name) */
@@ -72,7 +78,10 @@ private constructor(
             additionalQueryParams = contactListParams.additionalQueryParams.toBuilder()
         }
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -85,7 +94,10 @@ private constructor(
         /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
         fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
index 87540f8..5d076e6 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/GroupListParams.kt
@@ -24,10 +24,16 @@ private constructor(
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Search query (matches group name) */
@@ -72,7 +78,10 @@ private constructor(
             additionalQueryParams = groupListParams.additionalQueryParams.toBuilder()
         }
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -85,7 +94,10 @@ private constructor(
         /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
         fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
index 7bf365a..44f4de4 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/groups/members/MemberListParams.kt
@@ -21,10 +21,16 @@ private constructor(
 
     fun groupId(): Optional<String> = Optional.ofNullable(groupId)
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Additional headers to send with the request. */
@@ -66,7 +72,10 @@ private constructor(
         /** Alias for calling [Builder.groupId] with `groupId.orElse(null)`. */
         fun groupId(groupId: Optional<String>) = groupId(groupId.getOrNull())
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -79,7 +88,10 @@ private constructor(
         /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
         fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
index 6e6f7b2..9bd25f2 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListParams.kt
@@ -29,7 +29,10 @@ private constructor(
 
     fun webhookId(): Optional<String> = Optional.ofNullable(webhookId)
 
-    /** Maximum number of items to return (1-200) */
+    /**
+     * Maximum number of items to return in a single response. Must be between 1 and 200; defaults
+     * to 50. Use together with `offset` to page through large result sets.
+     */
     fun limit(): Optional<Long> = Optional.ofNullable(limit)
 
     /** Maximum HTTP status code */
@@ -38,7 +41,10 @@ private constructor(
     /** Minimum HTTP status code */
     fun minStatus(): Optional<Long> = Optional.ofNullable(minStatus)
 
-    /** Number of items to skip */
+    /**
+     * Number of items to skip before returning results. Combine with `limit` for page-based
+     * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+     */
     fun offset(): Optional<Long> = Optional.ofNullable(offset)
 
     /** Sort order by attempted time */
@@ -94,7 +100,10 @@ private constructor(
         /** Alias for calling [Builder.webhookId] with `webhookId.orElse(null)`. */
         fun webhookId(webhookId: Optional<String>) = webhookId(webhookId.getOrNull())
 
-        /** Maximum number of items to return (1-200) */
+        /**
+         * Maximum number of items to return in a single response. Must be between 1 and 200;
+         * defaults to 50. Use together with `offset` to page through large result sets.
+         */
         fun limit(limit: Long?) = apply { this.limit = limit }
 
         /**
@@ -133,7 +142,10 @@ private constructor(
         /** Alias for calling [Builder.minStatus] with `minStatus.orElse(null)`. */
         fun minStatus(minStatus: Optional<Long>) = minStatus(minStatus.getOrNull())
 
-        /** Number of items to skip */
+        /**
+         * Number of items to skip before returning results. Combine with `limit` for page-based
+         * pagination (e.g. `offset=50&limit=50` returns the second page). Defaults to 0.
+         */
         fun offset(offset: Long?) = apply { this.offset = offset }
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
index 6bd4305..e453b60 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/async/chats/BackgroundServiceAsync.kt
@@ -109,7 +109,7 @@ interface BackgroundServiceAsync {
      *
      * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
      * ```bash
-     * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+     * curl -X PUT "https://api.blooio.com/v2/api/chats/%2B15551234567/background" \
      *   -H "Authorization: Bearer YOUR_API_KEY" \
      *   -F "background=@/path/to/image.jpg;type=image/jpeg"
      * ```
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
index 2731935..a364e8e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/services/blocking/chats/BackgroundService.kt
@@ -101,7 +101,7 @@ interface BackgroundService {
      *
      * **Example with curl** — note the `@` prefix that tells curl to read the file from disk:
      * ```bash
-     * curl -X PUT "https://backend.blooio.com/v2/api/chats/%2B15551234567/background" \
+     * curl -X PUT "https://api.blooio.com/v2/api/chats/%2B15551234567/background" \
      *   -H "Authorization: Bearer YOUR_API_KEY" \
      *   -F "background=@/path/to/image.jpg;type=image/jpeg"
      * ```

From ee72ac8987ab0bcfd54340dbe0390f6d4f8fed63 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 01:20:28 +0000
Subject: [PATCH 57/63] feat(api): api update

---
 .stats.yml                                    |  4 +-
 .../messages/MessageGetStatusResponse.kt      | 69 ++++++++++++++++---
 .../chats/messages/MessageListResponse.kt     | 69 ++++++++++++++++---
 .../chats/messages/MessageRetrieveResponse.kt | 69 ++++++++++++++++---
 .../chats/messages/MessageSendResponse.kt     | 17 ++++-
 .../models/webhooks/logs/LogListResponse.kt   | 68 +++++++++++++-----
 .../messages/MessageGetStatusResponseTest.kt  |  6 +-
 .../chats/messages/MessageListResponseTest.kt |  6 +-
 .../messages/MessageRetrieveResponseTest.kt   |  6 +-
 .../webhooks/logs/LogListResponseTest.kt      |  6 +-
 10 files changed, 257 insertions(+), 63 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 29f6b09..4573161 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-fbf531ca47a2361a9adec0b9845e3569e800f7add519b96776c047cc227e90cc.yml
-openapi_spec_hash: 636c8fd0d0264e47b02eecb86fc9b22d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-97fe57f345af4c53c5065cac2521795c0594eacd6bd094effeef5ecf72fb4dde.yml
+openapi_spec_hash: e087a558db51de03fbe6e0b2faa1d8b3
 config_hash: 839e191496287972d18d39dcab8b19b7
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
index e39d007..9e1d646 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponse.kt
@@ -82,12 +82,26 @@ private constructor(
     fun messageId(): Optional<String> = messageId.getOptional("message_id")
 
     /**
+     * Transport used to carry the message; never null. `pending` = accepted and dispatched, wire
+     * service not resolved yet (settles within seconds of send); `imessage` = delivered over
+     * iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS (green
+     * bubble); `unknown` = accepted by the carrier but the wire service could not be resolved
+     * before the tracking window closed (see `error`).
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun protocol(): Optional<Protocol> = protocol.getOptional("protocol")
 
     /**
+     * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued` =
+     * accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to Apple/the
+     * carrier (protocol resolution happens around here); `delivered` = a delivery receipt was
+     * received; `failed` = could not be delivered (see `error`); `cancellation_requested` = a
+     * cancel was requested for a still-queued message (best-effort); `cancelled` = cancelled before
+     * dispatch. Inbound messages are surfaced via webhooks with `received`; read receipts arrive as
+     * a `read` event.
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -252,10 +266,14 @@ private constructor(
          */
         fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
 
-        fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
-
-        /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
-        fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+        /**
+         * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+         * wire service not resolved yet (settles within seconds of send); `imessage` = delivered
+         * over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS
+         * (green bubble); `unknown` = accepted by the carrier but the wire service could not be
+         * resolved before the tracking window closed (see `error`).
+         */
+        fun protocol(protocol: Protocol) = protocol(JsonField.of(protocol))
 
         /**
          * Sets [Builder.protocol] to an arbitrary JSON value.
@@ -266,6 +284,15 @@ private constructor(
          */
         fun protocol(protocol: JsonField<Protocol>) = apply { this.protocol = protocol }
 
+        /**
+         * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued`
+         * = accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to
+         * Apple/the carrier (protocol resolution happens around here); `delivered` = a delivery
+         * receipt was received; `failed` = could not be delivered (see `error`);
+         * `cancellation_requested` = a cancel was requested for a still-queued message
+         * (best-effort); `cancelled` = cancelled before dispatch. Inbound messages are surfaced via
+         * webhooks with `received`; read receipts arrive as a `read` event.
+         */
         fun status(status: Status?) = status(JsonField.ofNullable(status))
 
         /** Alias for calling [Builder.status] with `status.orElse(null)`. */
@@ -536,6 +563,13 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Transport used to carry the message; never null. `pending` = accepted and dispatched, wire
+     * service not resolved yet (settles within seconds of send); `imessage` = delivered over
+     * iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS (green
+     * bubble); `unknown` = accepted by the carrier but the wire service could not be resolved
+     * before the tracking window closed (see `error`).
+     */
     class Protocol @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -550,23 +584,26 @@ private constructor(
 
         companion object {
 
+            @JvmField val PENDING = of("pending")
+
+            @JvmField val UNKNOWN = of("unknown")
+
             @JvmField val IMESSAGE = of("imessage")
 
             @JvmField val SMS = of("sms")
 
             @JvmField val RCS = of("rcs")
 
-            @JvmField val NON_IMESSAGE = of("non-imessage")
-
             @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
         }
 
         /** An enum containing [Protocol]'s known values. */
         enum class Known {
+            PENDING,
+            UNKNOWN,
             IMESSAGE,
             SMS,
             RCS,
-            NON_IMESSAGE,
         }
 
         /**
@@ -579,10 +616,11 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            PENDING,
+            UNKNOWN,
             IMESSAGE,
             SMS,
             RCS,
-            NON_IMESSAGE,
             /** An enum member indicating that [Protocol] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -596,10 +634,11 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                PENDING -> Value.PENDING
+                UNKNOWN -> Value.UNKNOWN
                 IMESSAGE -> Value.IMESSAGE
                 SMS -> Value.SMS
                 RCS -> Value.RCS
-                NON_IMESSAGE -> Value.NON_IMESSAGE
                 else -> Value._UNKNOWN
             }
 
@@ -614,10 +653,11 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                PENDING -> Known.PENDING
+                UNKNOWN -> Known.UNKNOWN
                 IMESSAGE -> Known.IMESSAGE
                 SMS -> Known.SMS
                 RCS -> Known.RCS
-                NON_IMESSAGE -> Known.NON_IMESSAGE
                 else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
             }
 
@@ -682,6 +722,15 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued` =
+     * accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to Apple/the
+     * carrier (protocol resolution happens around here); `delivered` = a delivery receipt was
+     * received; `failed` = could not be delivered (see `error`); `cancellation_requested` = a
+     * cancel was requested for a still-queued message (best-effort); `cancelled` = cancelled before
+     * dispatch. Inbound messages are surfaced via webhooks with `received`; read receipts arrive as
+     * a `read` event.
+     */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
index 90a1f3a..fccbab0 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageListResponse.kt
@@ -348,6 +348,12 @@ private constructor(
         fun messageId(): Optional<String> = messageId.getOptional("message_id")
 
         /**
+         * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+         * wire service not resolved yet (settles within seconds of send); `imessage` = delivered
+         * over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS
+         * (green bubble); `unknown` = accepted by the carrier but the wire service could not be
+         * resolved before the tracking window closed (see `error`).
+         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
@@ -380,6 +386,14 @@ private constructor(
         fun sender(): Optional<String> = sender.getOptional("sender")
 
         /**
+         * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued`
+         * = accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to
+         * Apple/the carrier (protocol resolution happens around here); `delivered` = a delivery
+         * receipt was received; `failed` = could not be delivered (see `error`);
+         * `cancellation_requested` = a cancel was requested for a still-queued message
+         * (best-effort); `cancelled` = cancelled before dispatch. Inbound messages are surfaced via
+         * webhooks with `received`; read receipts arrive as a `read` event.
+         *
          * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
@@ -658,10 +672,14 @@ private constructor(
              */
             fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
 
-            fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
-
-            /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
-            fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+            /**
+             * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+             * wire service not resolved yet (settles within seconds of send); `imessage` =
+             * delivered over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back
+             * to SMS/MMS (green bubble); `unknown` = accepted by the carrier but the wire service
+             * could not be resolved before the tracking window closed (see `error`).
+             */
+            fun protocol(protocol: Protocol) = protocol(JsonField.of(protocol))
 
             /**
              * Sets [Builder.protocol] to an arbitrary JSON value.
@@ -734,6 +752,15 @@ private constructor(
              */
             fun sender(sender: JsonField<String>) = apply { this.sender = sender }
 
+            /**
+             * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch;
+             * `queued` = accepted and waiting to be handed to Apple/the carrier; `sent` = handed
+             * off to Apple/the carrier (protocol resolution happens around here); `delivered` = a
+             * delivery receipt was received; `failed` = could not be delivered (see `error`);
+             * `cancellation_requested` = a cancel was requested for a still-queued message
+             * (best-effort); `cancelled` = cancelled before dispatch. Inbound messages are surfaced
+             * via webhooks with `received`; read receipts arrive as a `read` event.
+             */
             fun status(status: Status?) = status(JsonField.ofNullable(status))
 
             /** Alias for calling [Builder.status] with `status.orElse(null)`. */
@@ -1047,6 +1074,13 @@ private constructor(
             override fun toString() = value.toString()
         }
 
+        /**
+         * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+         * wire service not resolved yet (settles within seconds of send); `imessage` = delivered
+         * over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS
+         * (green bubble); `unknown` = accepted by the carrier but the wire service could not be
+         * resolved before the tracking window closed (see `error`).
+         */
         class Protocol @JsonCreator private constructor(private val value: JsonField<String>) :
             Enum {
 
@@ -1062,23 +1096,26 @@ private constructor(
 
             companion object {
 
+                @JvmField val PENDING = of("pending")
+
+                @JvmField val UNKNOWN = of("unknown")
+
                 @JvmField val IMESSAGE = of("imessage")
 
                 @JvmField val SMS = of("sms")
 
                 @JvmField val RCS = of("rcs")
 
-                @JvmField val NON_IMESSAGE = of("non-imessage")
-
                 @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
             }
 
             /** An enum containing [Protocol]'s known values. */
             enum class Known {
+                PENDING,
+                UNKNOWN,
                 IMESSAGE,
                 SMS,
                 RCS,
-                NON_IMESSAGE,
             }
 
             /**
@@ -1091,10 +1128,11 @@ private constructor(
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
+                PENDING,
+                UNKNOWN,
                 IMESSAGE,
                 SMS,
                 RCS,
-                NON_IMESSAGE,
                 /**
                  * An enum member indicating that [Protocol] was instantiated with an unknown value.
                  */
@@ -1110,10 +1148,11 @@ private constructor(
              */
             fun value(): Value =
                 when (this) {
+                    PENDING -> Value.PENDING
+                    UNKNOWN -> Value.UNKNOWN
                     IMESSAGE -> Value.IMESSAGE
                     SMS -> Value.SMS
                     RCS -> Value.RCS
-                    NON_IMESSAGE -> Value.NON_IMESSAGE
                     else -> Value._UNKNOWN
                 }
 
@@ -1128,10 +1167,11 @@ private constructor(
              */
             fun known(): Known =
                 when (this) {
+                    PENDING -> Known.PENDING
+                    UNKNOWN -> Known.UNKNOWN
                     IMESSAGE -> Known.IMESSAGE
                     SMS -> Known.SMS
                     RCS -> Known.RCS
-                    NON_IMESSAGE -> Known.NON_IMESSAGE
                     else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
                 }
 
@@ -1480,6 +1520,15 @@ private constructor(
                 "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
         }
 
+        /**
+         * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued`
+         * = accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to
+         * Apple/the carrier (protocol resolution happens around here); `delivered` = a delivery
+         * receipt was received; `failed` = could not be delivered (see `error`);
+         * `cancellation_requested` = a cancel was requested for a still-queued message
+         * (best-effort); `cancelled` = cancelled before dispatch. Inbound messages are surfaced via
+         * webhooks with `received`; read receipts arrive as a `read` event.
+         */
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
index f7170a1..f72a5d9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponse.kt
@@ -132,6 +132,12 @@ private constructor(
     fun messageId(): Optional<String> = messageId.getOptional("message_id")
 
     /**
+     * Transport used to carry the message; never null. `pending` = accepted and dispatched, wire
+     * service not resolved yet (settles within seconds of send); `imessage` = delivered over
+     * iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS (green
+     * bubble); `unknown` = accepted by the carrier but the wire service could not be resolved
+     * before the tracking window closed (see `error`).
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -164,6 +170,14 @@ private constructor(
     fun sender(): Optional<String> = sender.getOptional("sender")
 
     /**
+     * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued` =
+     * accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to Apple/the
+     * carrier (protocol resolution happens around here); `delivered` = a delivery receipt was
+     * received; `failed` = could not be delivered (see `error`); `cancellation_requested` = a
+     * cancel was requested for a still-queued message (best-effort); `cancelled` = cancelled before
+     * dispatch. Inbound messages are surfaced via webhooks with `received`; read receipts arrive as
+     * a `read` event.
+     *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
@@ -454,10 +468,14 @@ private constructor(
          */
         fun messageId(messageId: JsonField<String>) = apply { this.messageId = messageId }
 
-        fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
-
-        /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
-        fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+        /**
+         * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+         * wire service not resolved yet (settles within seconds of send); `imessage` = delivered
+         * over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS
+         * (green bubble); `unknown` = accepted by the carrier but the wire service could not be
+         * resolved before the tracking window closed (see `error`).
+         */
+        fun protocol(protocol: Protocol) = protocol(JsonField.of(protocol))
 
         /**
          * Sets [Builder.protocol] to an arbitrary JSON value.
@@ -528,6 +546,15 @@ private constructor(
          */
         fun sender(sender: JsonField<String>) = apply { this.sender = sender }
 
+        /**
+         * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued`
+         * = accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to
+         * Apple/the carrier (protocol resolution happens around here); `delivered` = a delivery
+         * receipt was received; `failed` = could not be delivered (see `error`);
+         * `cancellation_requested` = a cancel was requested for a still-queued message
+         * (best-effort); `cancelled` = cancelled before dispatch. Inbound messages are surfaced via
+         * webhooks with `received`; read receipts arrive as a `read` event.
+         */
         fun status(status: Status?) = status(JsonField.ofNullable(status))
 
         /** Alias for calling [Builder.status] with `status.orElse(null)`. */
@@ -1058,6 +1085,13 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Transport used to carry the message; never null. `pending` = accepted and dispatched, wire
+     * service not resolved yet (settles within seconds of send); `imessage` = delivered over
+     * iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back to SMS/MMS (green
+     * bubble); `unknown` = accepted by the carrier but the wire service could not be resolved
+     * before the tracking window closed (see `error`).
+     */
     class Protocol @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
@@ -1072,23 +1106,26 @@ private constructor(
 
         companion object {
 
+            @JvmField val PENDING = of("pending")
+
+            @JvmField val UNKNOWN = of("unknown")
+
             @JvmField val IMESSAGE = of("imessage")
 
             @JvmField val SMS = of("sms")
 
             @JvmField val RCS = of("rcs")
 
-            @JvmField val NON_IMESSAGE = of("non-imessage")
-
             @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
         }
 
         /** An enum containing [Protocol]'s known values. */
         enum class Known {
+            PENDING,
+            UNKNOWN,
             IMESSAGE,
             SMS,
             RCS,
-            NON_IMESSAGE,
         }
 
         /**
@@ -1101,10 +1138,11 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            PENDING,
+            UNKNOWN,
             IMESSAGE,
             SMS,
             RCS,
-            NON_IMESSAGE,
             /** An enum member indicating that [Protocol] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -1118,10 +1156,11 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                PENDING -> Value.PENDING
+                UNKNOWN -> Value.UNKNOWN
                 IMESSAGE -> Value.IMESSAGE
                 SMS -> Value.SMS
                 RCS -> Value.RCS
-                NON_IMESSAGE -> Value.NON_IMESSAGE
                 else -> Value._UNKNOWN
             }
 
@@ -1136,10 +1175,11 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                PENDING -> Known.PENDING
+                UNKNOWN -> Known.UNKNOWN
                 IMESSAGE -> Known.IMESSAGE
                 SMS -> Known.SMS
                 RCS -> Known.RCS
-                NON_IMESSAGE -> Known.NON_IMESSAGE
                 else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
             }
 
@@ -1474,6 +1514,15 @@ private constructor(
             "ReplyTo{guid=$guid, messageId=$messageId, partIndex=$partIndex, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * Delivery lifecycle state. `pending` = persisted and being prepared for dispatch; `queued` =
+     * accepted and waiting to be handed to Apple/the carrier; `sent` = handed off to Apple/the
+     * carrier (protocol resolution happens around here); `delivered` = a delivery receipt was
+     * received; `failed` = could not be delivered (see `error`); `cancellation_requested` = a
+     * cancel was requested for a still-queued message (best-effort); `cancelled` = cancelled before
+     * dispatch. Inbound messages are surfaced via webhooks with `received`; read receipts arrive as
+     * a `read` event.
+     */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
index 30b4213..437439e 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/chats/messages/MessageSendResponse.kt
@@ -124,7 +124,9 @@ private constructor(
     fun participants(): Optional<List<String>> = participants.getOptional("participants")
 
     /**
-     * Initial status of the message(s)
+     * Initial status of the message(s). `queued` = accepted for delivery (the normal 202 result);
+     * `failed` = rejected before dispatch. Subsequent transitions (`sent` → `delivered`, or
+     * `failed`) are reported via the status endpoint and `message.status` webhooks.
      *
      * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -363,7 +365,12 @@ private constructor(
                 }
         }
 
-        /** Initial status of the message(s) */
+        /**
+         * Initial status of the message(s). `queued` = accepted for delivery (the normal 202
+         * result); `failed` = rejected before dispatch. Subsequent transitions (`sent` →
+         * `delivered`, or `failed`) are reported via the status endpoint and `message.status`
+         * webhooks.
+         */
         fun status(status: Status) = status(JsonField.of(status))
 
         /**
@@ -462,7 +469,11 @@ private constructor(
             (participants.asKnown().getOrNull()?.size ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
-    /** Initial status of the message(s) */
+    /**
+     * Initial status of the message(s). `queued` = accepted for delivery (the normal 202 result);
+     * `failed` = rejected before dispatch. Subsequent transitions (`sent` → `delivered`, or
+     * `failed`) are reported via the status endpoint and `message.status` webhooks.
+     */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
         /**
diff --git a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
index 52774a7..9b1edd9 100644
--- a/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
+++ b/blooio-java-core/src/main/kotlin/com/blooio/api/models/webhooks/logs/LogListResponse.kt
@@ -853,7 +853,11 @@ private constructor(
                 participants.getOptional("participants")
 
             /**
-             * Message protocol
+             * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+             * wire service not resolved yet (settles within seconds of send); `imessage` =
+             * delivered over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back
+             * to SMS/MMS (green bubble); `unknown` = accepted by the carrier but the wire service
+             * could not be resolved before the tracking window closed (see `error`).
              *
              * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
              *   the server responded with an unexpected value).
@@ -885,7 +889,11 @@ private constructor(
             fun sentAt(): Optional<Long> = sentAt.getOptional("sent_at")
 
             /**
-             * Message status
+             * Message status carried by the event. `queued` / `pending` = accepted, not yet handed
+             * off; `sent` = handed to Apple/the carrier; `delivered` = a delivery receipt was
+             * received; `read` = a read receipt was received (iMessage, when the recipient has read
+             * receipts on); `failed` = delivery failed (see `error_code` / `error_message`);
+             * `received` = an inbound message arrived.
              *
              * @throws BlooioInvalidDataException if the JSON field has an unexpected type (e.g. if
              *   the server responded with an unexpected value).
@@ -1358,11 +1366,15 @@ private constructor(
                         }
                 }
 
-                /** Message protocol */
-                fun protocol(protocol: Protocol?) = protocol(JsonField.ofNullable(protocol))
-
-                /** Alias for calling [Builder.protocol] with `protocol.orElse(null)`. */
-                fun protocol(protocol: Optional<Protocol>) = protocol(protocol.getOrNull())
+                /**
+                 * Transport used to carry the message; never null. `pending` = accepted and
+                 * dispatched, wire service not resolved yet (settles within seconds of send);
+                 * `imessage` = delivered over iMessage (blue bubble); `rcs` = delivered over RCS;
+                 * `sms` = fell back to SMS/MMS (green bubble); `unknown` = accepted by the carrier
+                 * but the wire service could not be resolved before the tracking window closed (see
+                 * `error`).
+                 */
+                fun protocol(protocol: Protocol) = protocol(JsonField.of(protocol))
 
                 /**
                  * Sets [Builder.protocol] to an arbitrary JSON value.
@@ -1432,7 +1444,13 @@ private constructor(
                  */
                 fun sentAt(sentAt: JsonField<Long>) = apply { this.sentAt = sentAt }
 
-                /** Message status */
+                /**
+                 * Message status carried by the event. `queued` / `pending` = accepted, not yet
+                 * handed off; `sent` = handed to Apple/the carrier; `delivered` = a delivery
+                 * receipt was received; `read` = a read receipt was received (iMessage, when the
+                 * recipient has read receipts on); `failed` = delivery failed (see `error_code` /
+                 * `error_message`); `received` = an inbound message arrived.
+                 */
                 fun status(status: Status) = status(JsonField.of(status))
 
                 /**
@@ -2030,7 +2048,13 @@ private constructor(
                     "Participant{contactId=$contactId, identifier=$identifier, name=$name, additionalProperties=$additionalProperties}"
             }
 
-            /** Message protocol */
+            /**
+             * Transport used to carry the message; never null. `pending` = accepted and dispatched,
+             * wire service not resolved yet (settles within seconds of send); `imessage` =
+             * delivered over iMessage (blue bubble); `rcs` = delivered over RCS; `sms` = fell back
+             * to SMS/MMS (green bubble); `unknown` = accepted by the carrier but the wire service
+             * could not be resolved before the tracking window closed (see `error`).
+             */
             class Protocol @JsonCreator private constructor(private val value: JsonField<String>) :
                 Enum {
 
@@ -2046,23 +2070,26 @@ private constructor(
 
                 companion object {
 
+                    @JvmField val PENDING = of("pending")
+
+                    @JvmField val UNKNOWN = of("unknown")
+
                     @JvmField val IMESSAGE = of("imessage")
 
                     @JvmField val SMS = of("sms")
 
                     @JvmField val RCS = of("rcs")
 
-                    @JvmField val NON_IMESSAGE = of("non-imessage")
-
                     @JvmStatic fun of(value: String) = Protocol(JsonField.of(value))
                 }
 
                 /** An enum containing [Protocol]'s known values. */
                 enum class Known {
+                    PENDING,
+                    UNKNOWN,
                     IMESSAGE,
                     SMS,
                     RCS,
-                    NON_IMESSAGE,
                 }
 
                 /**
@@ -2075,10 +2102,11 @@ private constructor(
                  * - It was constructed with an arbitrary value using the [of] method.
                  */
                 enum class Value {
+                    PENDING,
+                    UNKNOWN,
                     IMESSAGE,
                     SMS,
                     RCS,
-                    NON_IMESSAGE,
                     /**
                      * An enum member indicating that [Protocol] was instantiated with an unknown
                      * value.
@@ -2095,10 +2123,11 @@ private constructor(
                  */
                 fun value(): Value =
                     when (this) {
+                        PENDING -> Value.PENDING
+                        UNKNOWN -> Value.UNKNOWN
                         IMESSAGE -> Value.IMESSAGE
                         SMS -> Value.SMS
                         RCS -> Value.RCS
-                        NON_IMESSAGE -> Value.NON_IMESSAGE
                         else -> Value._UNKNOWN
                     }
 
@@ -2113,10 +2142,11 @@ private constructor(
                  */
                 fun known(): Known =
                     when (this) {
+                        PENDING -> Known.PENDING
+                        UNKNOWN -> Known.UNKNOWN
                         IMESSAGE -> Known.IMESSAGE
                         SMS -> Known.SMS
                         RCS -> Known.RCS
-                        NON_IMESSAGE -> Known.NON_IMESSAGE
                         else -> throw BlooioInvalidDataException("Unknown Protocol: $value")
                     }
 
@@ -2184,7 +2214,13 @@ private constructor(
                 override fun toString() = value.toString()
             }
 
-            /** Message status */
+            /**
+             * Message status carried by the event. `queued` / `pending` = accepted, not yet handed
+             * off; `sent` = handed to Apple/the carrier; `delivered` = a delivery receipt was
+             * received; `read` = a read receipt was received (iMessage, when the recipient has read
+             * receipts on); `failed` = delivery failed (see `error_code` / `error_message`);
+             * `received` = an inbound message arrived.
+             */
             class Status @JsonCreator private constructor(private val value: JsonField<String>) :
                 Enum {
 
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
index 5001166..c3f84a9 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageGetStatusResponseTest.kt
@@ -17,7 +17,7 @@ internal class MessageGetStatusResponseTest {
                 .direction(MessageGetStatusResponse.Direction.INBOUND)
                 .error("error")
                 .messageId("message_id")
-                .protocol(MessageGetStatusResponse.Protocol.IMESSAGE)
+                .protocol(MessageGetStatusResponse.Protocol.PENDING)
                 .status(MessageGetStatusResponse.Status.PENDING)
                 .timeDelivered(0L)
                 .timeSent(0L)
@@ -29,7 +29,7 @@ internal class MessageGetStatusResponseTest {
         assertThat(messageGetStatusResponse.error()).contains("error")
         assertThat(messageGetStatusResponse.messageId()).contains("message_id")
         assertThat(messageGetStatusResponse.protocol())
-            .contains(MessageGetStatusResponse.Protocol.IMESSAGE)
+            .contains(MessageGetStatusResponse.Protocol.PENDING)
         assertThat(messageGetStatusResponse.status())
             .contains(MessageGetStatusResponse.Status.PENDING)
         assertThat(messageGetStatusResponse.timeDelivered()).contains(0L)
@@ -45,7 +45,7 @@ internal class MessageGetStatusResponseTest {
                 .direction(MessageGetStatusResponse.Direction.INBOUND)
                 .error("error")
                 .messageId("message_id")
-                .protocol(MessageGetStatusResponse.Protocol.IMESSAGE)
+                .protocol(MessageGetStatusResponse.Protocol.PENDING)
                 .status(MessageGetStatusResponse.Status.PENDING)
                 .timeDelivered(0L)
                 .timeSent(0L)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
index c4fd065..fdf4598 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageListResponseTest.kt
@@ -25,7 +25,7 @@ internal class MessageListResponseTest {
                         .externalId("external_id")
                         .internalId("internal_id")
                         .messageId("message_id")
-                        .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                        .protocol(MessageListResponse.Message.Protocol.PENDING)
                         .addReaction(
                             Reaction.builder()
                                 .isAdded(true)
@@ -61,7 +61,7 @@ internal class MessageListResponseTest {
                     .externalId("external_id")
                     .internalId("internal_id")
                     .messageId("message_id")
-                    .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                    .protocol(MessageListResponse.Message.Protocol.PENDING)
                     .addReaction(
                         Reaction.builder()
                             .isAdded(true)
@@ -102,7 +102,7 @@ internal class MessageListResponseTest {
                         .externalId("external_id")
                         .internalId("internal_id")
                         .messageId("message_id")
-                        .protocol(MessageListResponse.Message.Protocol.IMESSAGE)
+                        .protocol(MessageListResponse.Message.Protocol.PENDING)
                         .addReaction(
                             Reaction.builder()
                                 .isAdded(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
index c3d847f..342fa07 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/chats/messages/MessageRetrieveResponseTest.kt
@@ -28,7 +28,7 @@ internal class MessageRetrieveResponseTest {
                 .error("error")
                 .internalId("internal_id")
                 .messageId("message_id")
-                .protocol(MessageRetrieveResponse.Protocol.IMESSAGE)
+                .protocol(MessageRetrieveResponse.Protocol.PENDING)
                 .addReaction(
                     Reaction.builder()
                         .isAdded(true)
@@ -68,7 +68,7 @@ internal class MessageRetrieveResponseTest {
         assertThat(messageRetrieveResponse.internalId()).contains("internal_id")
         assertThat(messageRetrieveResponse.messageId()).contains("message_id")
         assertThat(messageRetrieveResponse.protocol())
-            .contains(MessageRetrieveResponse.Protocol.IMESSAGE)
+            .contains(MessageRetrieveResponse.Protocol.PENDING)
         assertThat(messageRetrieveResponse.reactions().getOrNull())
             .containsExactly(
                 Reaction.builder()
@@ -112,7 +112,7 @@ internal class MessageRetrieveResponseTest {
                 .error("error")
                 .internalId("internal_id")
                 .messageId("message_id")
-                .protocol(MessageRetrieveResponse.Protocol.IMESSAGE)
+                .protocol(MessageRetrieveResponse.Protocol.PENDING)
                 .addReaction(
                     Reaction.builder()
                         .isAdded(true)
diff --git a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
index 9fb98dc..405e4c7 100644
--- a/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
+++ b/blooio-java-core/src/test/kotlin/com/blooio/api/models/webhooks/logs/LogListResponseTest.kt
@@ -43,7 +43,7 @@ internal class LogListResponseTest {
                                         .name("name")
                                         .build()
                                 )
-                                .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                                .protocol(LogListResponse.Log.EventBody.Protocol.PENDING)
                                 .readAt(0L)
                                 .sender("sender")
                                 .sentAt(0L)
@@ -110,7 +110,7 @@ internal class LogListResponseTest {
                                     .name("name")
                                     .build()
                             )
-                            .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                            .protocol(LogListResponse.Log.EventBody.Protocol.PENDING)
                             .readAt(0L)
                             .sender("sender")
                             .sentAt(0L)
@@ -182,7 +182,7 @@ internal class LogListResponseTest {
                                         .name("name")
                                         .build()
                                 )
-                                .protocol(LogListResponse.Log.EventBody.Protocol.IMESSAGE)
+                                .protocol(LogListResponse.Log.EventBody.Protocol.PENDING)
                                 .readAt(0L)
                                 .sender("sender")
                                 .sentAt(0L)

From 17dc98df02fbf2f61b95baafaeab473e5d0aa1ba Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 18 Jul 2026 02:09:45 +0000
Subject: [PATCH 58/63] feat(stlc): configurable CI runner and
 private-production-repo support in workflow templates

---
 .github/workflows/ci.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 389b3f6..05479a1 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -18,7 +18,7 @@ jobs:
   lint:
     timeout-minutes: 15
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
@@ -45,7 +45,7 @@ jobs:
     permissions:
       contents: read
       id-token: write
-    runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
@@ -88,7 +88,7 @@ jobs:
   test:
     timeout-minutes: 15
     name: test
-    runs-on: ${{ github.repository == 'stainless-sdks/blooio-java' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

From 4b8f22fac862a1c8810c7b42c90597ec9a00d221 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 18 Jul 2026 18:20:28 +0000
Subject: [PATCH 59/63] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4573161..9fefe1e 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-97fe57f345af4c53c5065cac2521795c0594eacd6bd094effeef5ecf72fb4dde.yml
-openapi_spec_hash: e087a558db51de03fbe6e0b2faa1d8b3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-48672bb20ddabae9ba6fe497480d26fd4c03079b27e0cb93c3f0decd773bbebc.yml
+openapi_spec_hash: 3064147b2273936d7a3922f6778c64f7
 config_hash: 839e191496287972d18d39dcab8b19b7

From 5b5de21af3d3bdea0ca1105c42d8425cc23582c1 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 24 Jul 2026 08:20:29 +0000
Subject: [PATCH 60/63] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 9fefe1e..4236de9 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-48672bb20ddabae9ba6fe497480d26fd4c03079b27e0cb93c3f0decd773bbebc.yml
-openapi_spec_hash: 3064147b2273936d7a3922f6778c64f7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-1cd5a817a6e1e1b6fcd4a9775ce688843f231161a23ad60d545e97c60df304b6.yml
+openapi_spec_hash: 115398aaf337063929c7d212deaaa730
 config_hash: 839e191496287972d18d39dcab8b19b7

From 696dcee2f3f031514cb93d215793be57e798d127 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Fri, 24 Jul 2026 20:20:25 +0000
Subject: [PATCH 61/63] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4236de9..3b51066 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-1cd5a817a6e1e1b6fcd4a9775ce688843f231161a23ad60d545e97c60df304b6.yml
-openapi_spec_hash: 115398aaf337063929c7d212deaaa730
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-c60428133ba2fc28b472f6f628637fd0acba87e0213bbb85a0e8bf8c1ef3ba79.yml
+openapi_spec_hash: 51ceab56aca9165d221f1294b27c140e
 config_hash: 839e191496287972d18d39dcab8b19b7

From 6008dedf895afeb1853ac251a05c970c0f29ff5e Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 25 Jul 2026 21:20:28 +0000
Subject: [PATCH 62/63] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 3b51066..fa485b0 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 54
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-c60428133ba2fc28b472f6f628637fd0acba87e0213bbb85a0e8bf8c1ef3ba79.yml
-openapi_spec_hash: 51ceab56aca9165d221f1294b27c140e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/blooio/blooio-4cfd8aadba2015ef9746f076452ef853f194ce40602854c29ce76842eff021a9.yml
+openapi_spec_hash: 8137fd23f3a30da82f83a8ac74a433f8
 config_hash: 839e191496287972d18d39dcab8b19b7

From 366f9e605693de56355129e0958dde2b7a1637ca Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 25 Jul 2026 21:21:10 +0000
Subject: [PATCH 63/63] release: 0.1.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 74 +++++++++++++++++++++++++++++++++++
 README.md                     | 10 ++---
 build.gradle.kts              |  2 +-
 4 files changed, 81 insertions(+), 7 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 2ed3b71..3d2ac0b 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.0.4"
+  ".": "0.1.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index af9651d..0fb25e0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,79 @@
 # Changelog
 
+## 0.1.0 (2026-07-25)
+
+Full Changelog: [v0.0.4...v0.1.0](https://github.com/Blooio/blooio-java-sdk/compare/v0.0.4...v0.1.0)
+
+### Features
+
+* **api:** api update ([ee72ac8](https://github.com/Blooio/blooio-java-sdk/commit/ee72ac8987ab0bcfd54340dbe0390f6d4f8fed63))
+* **api:** api update ([7f51cf6](https://github.com/Blooio/blooio-java-sdk/commit/7f51cf6db5c2f96e794de5e08e17d120440b42e8))
+* **api:** api update ([932d816](https://github.com/Blooio/blooio-java-sdk/commit/932d8162c2cd61c1dc99420ffc57b7ba3cf3ec2b))
+* **api:** api update ([ddc3458](https://github.com/Blooio/blooio-java-sdk/commit/ddc345895a8f3d40499f587ae3f5f0d34c51d1cb))
+* **api:** api update ([771db4a](https://github.com/Blooio/blooio-java-sdk/commit/771db4a13cd1736ea91b9e61beb8a987628bcacc))
+* **api:** api update ([62bd13a](https://github.com/Blooio/blooio-java-sdk/commit/62bd13a9dcfbdd3df4b764fb1bbe49b4481641ab))
+* **api:** api update ([242656c](https://github.com/Blooio/blooio-java-sdk/commit/242656c18bf53215a8064e1675aa1f8376d9c785))
+* **api:** api update ([b2ef3c6](https://github.com/Blooio/blooio-java-sdk/commit/b2ef3c62456ee3161c147df9d4d2189d61ff51b8))
+* **api:** api update ([e80c968](https://github.com/Blooio/blooio-java-sdk/commit/e80c968881cf120159070e90dfc1b6c3245dcfa9))
+* **api:** api update ([42ee71f](https://github.com/Blooio/blooio-java-sdk/commit/42ee71ffdc0961088155f55f433beceb12021350))
+* **api:** api update ([80f6a3d](https://github.com/Blooio/blooio-java-sdk/commit/80f6a3d0d669e0cfd2d399ba44193eb0e78e84f5))
+* **api:** api update ([1c697d5](https://github.com/Blooio/blooio-java-sdk/commit/1c697d5bd9f91a4a495d5d71667de5271e8cac0f))
+* **api:** manual updates ([1ae97f1](https://github.com/Blooio/blooio-java-sdk/commit/1ae97f141b08fc16fba03a7d99d6eace0e512001))
+* **api:** manual updates ([e112bbf](https://github.com/Blooio/blooio-java-sdk/commit/e112bbf06bcdf1bb105d9bf924a29f652ac28eb4))
+* **client:** add `HttpRequest#url()` method ([dd2bca3](https://github.com/Blooio/blooio-java-sdk/commit/dd2bca38596e4ef7626ef23d1a73ce7678a4375e))
+* **client:** allow configuring dispatcher executor service ([4f0db30](https://github.com/Blooio/blooio-java-sdk/commit/4f0db3097b9b0c1876887115146216c0b3a50c30))
+* **client:** improve logging ([b1579ce](https://github.com/Blooio/blooio-java-sdk/commit/b1579ce887a34b5a401642abe28d25d16d1c9194))
+* **client:** more robust error parsing ([8d94c9e](https://github.com/Blooio/blooio-java-sdk/commit/8d94c9ea92fb107cb3bbf301db7132cf0e70feb5))
+* **client:** send `X-Stainless-Kotlin-Version` header ([f6d45cd](https://github.com/Blooio/blooio-java-sdk/commit/f6d45cddc950b7443fb661d4804c4986ef89c187))
+* **client:** support proxy authentication ([8e5c00e](https://github.com/Blooio/blooio-java-sdk/commit/8e5c00ecbd7d4ba6e9c3f06d0001c2a953ac564e))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([17dc98d](https://github.com/Blooio/blooio-java-sdk/commit/17dc98df02fbf2f61b95baafaeab473e5d0aa1ba))
+
+
+### Bug Fixes
+
+* **client:** disallow coercion from float to int ([3ee28c5](https://github.com/Blooio/blooio-java-sdk/commit/3ee28c5e8bd033c3d96134fb13903941de2e8735))
+* **client:** fully respect max retries ([2ddb812](https://github.com/Blooio/blooio-java-sdk/commit/2ddb8126d441b260c80b9ef3b87a24f9ce20b5be))
+* **client:** preserve time zone in lenient date-time parsing ([573fcaf](https://github.com/Blooio/blooio-java-sdk/commit/573fcaf71930c387314fb18231334b542df8a47f))
+* **client:** send retry count header for max retries 0 ([2ddb812](https://github.com/Blooio/blooio-java-sdk/commit/2ddb8126d441b260c80b9ef3b87a24f9ce20b5be))
+* date time deserialization leniency ([b2ac60a](https://github.com/Blooio/blooio-java-sdk/commit/b2ac60a271022b4f389feee2e73467927b2c7a51))
+
+
+### Performance Improvements
+
+* **client:** create one json mapper ([6ef289e](https://github.com/Blooio/blooio-java-sdk/commit/6ef289e91429c1d6e5b7eea1746b0bb9ce24645b))
+
+
+### Chores
+
+* **ci:** upgrade `actions/github-script` ([a32a19d](https://github.com/Blooio/blooio-java-sdk/commit/a32a19dcfbeff710c7c6c0b4daaa8ed98107294a))
+* **ci:** upgrade `actions/setup-java` ([67eb04e](https://github.com/Blooio/blooio-java-sdk/commit/67eb04e66d48b47097af4e8d66f093688ff1f8ef))
+* **internal:** allow passing args to `./scripts/test` ([a8da670](https://github.com/Blooio/blooio-java-sdk/commit/a8da67050906f36094fdf4cf4fb278d6abe01f58))
+* **internal:** clean up maven repo artifact script and add html documentation to repo root ([d441da9](https://github.com/Blooio/blooio-java-sdk/commit/d441da9aa8607881a63e2ed14b9037fcccf1600d))
+* **internal:** codegen related update ([ccf0356](https://github.com/Blooio/blooio-java-sdk/commit/ccf03561744755a1bd800449143bc61b847b17ab))
+* **internal:** codegen related update ([58fcb73](https://github.com/Blooio/blooio-java-sdk/commit/58fcb730f98e0c1c1d8006b0aeb96f0aeb678a8b))
+* **internal:** codegen related update ([d939776](https://github.com/Blooio/blooio-java-sdk/commit/d9397764180aeb78502302531fbc19c928fa1ab5))
+* **internal:** codegen related update ([cdac773](https://github.com/Blooio/blooio-java-sdk/commit/cdac773c08fdbc1cfa3ddc812efaa40fb2da4a90))
+* **internal:** codegen related update ([d5926e0](https://github.com/Blooio/blooio-java-sdk/commit/d5926e0c1019ba3d777459623b0b847a286c7b97))
+* **internal:** correct cache invalidation for `SKIP_MOCK_TESTS` ([d3c3b9c](https://github.com/Blooio/blooio-java-sdk/commit/d3c3b9c5e26275edbc5897780f4338d88e65eb7d))
+* **internal:** depend on packages directly in example ([2ddb812](https://github.com/Blooio/blooio-java-sdk/commit/2ddb8126d441b260c80b9ef3b87a24f9ce20b5be))
+* **internal:** improve maven repo docs ([24c2d4b](https://github.com/Blooio/blooio-java-sdk/commit/24c2d4b5b8e3295a5218d2f999fd796fef269b88))
+* **internal:** remove mock server code ([2720979](https://github.com/Blooio/blooio-java-sdk/commit/2720979743e942537ebb7314e83b8f64bc8e3455))
+* **internal:** support uploading Maven repo artifacts to stainless package server ([d790509](https://github.com/Blooio/blooio-java-sdk/commit/d7905093b659e696e05478ee514fbbad370cc9d0))
+* **internal:** update `actions/checkout` version ([8cfab13](https://github.com/Blooio/blooio-java-sdk/commit/8cfab13629687564f829968a161b50843d8ddc73))
+* **internal:** update maven repo doc to include authentication ([0259720](https://github.com/Blooio/blooio-java-sdk/commit/025972007906b16f60bb8dc09ff3433c752f4be0))
+* **internal:** upgrade AssertJ ([0c278a7](https://github.com/Blooio/blooio-java-sdk/commit/0c278a7a62ba05270a09d4ad6d4e0c1eadebd280))
+* redact api-key headers in debug logs ([e7c56e6](https://github.com/Blooio/blooio-java-sdk/commit/e7c56e6299d79215ca5495603e92df1b358af702))
+* remove duplicated dokka setup ([c0c274e](https://github.com/Blooio/blooio-java-sdk/commit/c0c274e30b1bbee4384bd90848bb2ba78be70cae))
+* test on Jackson 2.14.0 to avoid encountering FasterXML/jackson-databind[#3240](https://github.com/Blooio/blooio-java-sdk/issues/3240) in tests ([b2ac60a](https://github.com/Blooio/blooio-java-sdk/commit/b2ac60a271022b4f389feee2e73467927b2c7a51))
+* update mock server docs ([00e0cf5](https://github.com/Blooio/blooio-java-sdk/commit/00e0cf57e1fb18ddcc685aeea1cce58ac6decf0c))
+* update SDK settings ([c05f9fb](https://github.com/Blooio/blooio-java-sdk/commit/c05f9fb421415ac928f815b14c27c794cf0e771e))
+
+
+### Documentation
+
+* add comment for arbitrary value fields ([a636226](https://github.com/Blooio/blooio-java-sdk/commit/a636226690a94e032e7b7d6e8fcf9d2f373bcfc3))
+* clarify forwards compat behavior ([d05e295](https://github.com/Blooio/blooio-java-sdk/commit/d05e295ff73aeb1af17db057f1903375d8719bef))
+
 ## 0.0.4 (2025-12-03)
 
 Full Changelog: [v0.0.3...v0.0.4](https://github.com/Blooio/blooio-java-sdk/compare/v0.0.3...v0.0.4)
diff --git a/README.md b/README.md
index 441553f..17f6b42 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <!-- x-release-please-start-version -->
 
-[![Maven Central](https://img.shields.io/maven-central/v/com.blooio.api/blooio-java)](https://central.sonatype.com/artifact/com.blooio.api/blooio-java/0.0.4)
-[![javadoc](https://javadoc.io/badge2/com.blooio.api/blooio-java/0.0.4/javadoc.svg)](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4)
+[![Maven Central](https://img.shields.io/maven-central/v/com.blooio.api/blooio-java)](https://central.sonatype.com/artifact/com.blooio.api/blooio-java/0.1.0)
+[![javadoc](https://javadoc.io/badge2/com.blooio.api/blooio-java/0.1.0/javadoc.svg)](https://javadoc.io/doc/com.blooio.api/blooio-java/0.1.0)
 
 <!-- x-release-please-end -->
 
@@ -13,7 +13,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [blooio.com](https://blooio.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.blooio.api/blooio-java/0.0.4).
+The REST API documentation can be found on [blooio.com](https://blooio.com). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.blooio.api/blooio-java/0.1.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [blooio.com](https://blooio.com). Jav
 ### Gradle
 
 ```kotlin
-implementation("com.blooio.api:blooio-java:0.0.4")
+implementation("com.blooio.api:blooio-java:0.1.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.blooio.api:blooio-java:0.0.4")
 <dependency>
   <groupId>com.blooio.api</groupId>
   <artifactId>blooio-java</artifactId>
-  <version>0.0.4</version>
+  <version>0.1.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index b711e00..59ff9a1 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -9,7 +9,7 @@ repositories {
 
 allprojects {
     group = "com.blooio.api"
-    version = "0.0.4" // x-release-please-version
+    version = "0.1.0" // x-release-please-version
 }
 
 subprojects {