From 0b5a0a6ab6df4b9c90bdbb68aea0965fda0772a9 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sat, 8 Aug 2026 21:17:42 +0000
Subject: [PATCH 1/3] feat(api): api update

---
 .stats.yml                                    |   4 +-
 .../models/inbox/InboxConnectEmailParams.kt   | 243 +++++++++++++++++-
 .../models/inbox/InboxConnectEmailResponse.kt | 180 ++++++++++++-
 .../inbox/InboxConnectEmailParamsTest.kt      |   3 +
 .../inbox/InboxConnectEmailResponseTest.kt    |   4 +
 .../services/async/InboxServiceAsyncTest.kt   |   1 +
 .../api/services/blocking/InboxServiceTest.kt |   1 +
 7 files changed, 428 insertions(+), 8 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index e7b8198..8fb9d77 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 20
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-cd8e042a9746bbe9bd180614fccc7597b85f4e8f6a29da6cd2f4cbf831fb2fbe.yml
-openapi_spec_hash: e27c0d9cd8cdeb348c88e6c4e8777e39
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-5c6cdb8b7a2c0ba449927687bc378823ac947b26b7c2e6c379ae14668b73979a.yml
+openapi_spec_hash: 6bc024b866f01da53e2cfd6e404157c7
 config_hash: 5509bb7a961ae2e79114b24c381606d4
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
index 12bb059..4e78e84 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
@@ -2,6 +2,7 @@
 
 package com.cas_parser.api.models.inbox
 
+import com.cas_parser.api.core.Enum
 import com.cas_parser.api.core.ExcludeMissing
 import com.cas_parser.api.core.JsonField
 import com.cas_parser.api.core.JsonMissing
@@ -18,6 +19,7 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /**
  * Initiate OAuth flow to connect user's email inbox.
@@ -51,6 +53,19 @@ private constructor(
      */
     fun redirectUri(): String = body.redirectUri()
 
+    /**
+     * Mail provider to connect. Defaults to `gmail`.
+     * - `gmail` - Google accounts
+     * - `outlook` - Microsoft accounts
+     *
+     * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned in
+     * the response.
+     *
+     * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun provider(): Optional<Provider> = body.provider()
+
     /**
      * State parameter for CSRF protection (returned in redirect)
      *
@@ -66,6 +81,13 @@ private constructor(
      */
     fun _redirectUri(): JsonField<String> = body._redirectUri()
 
+    /**
+     * Returns the raw JSON value of [provider].
+     *
+     * Unlike [provider], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _provider(): JsonField<Provider> = body._provider()
+
     /**
      * Returns the raw JSON value of [state].
      *
@@ -116,6 +138,7 @@ 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:
          * - [redirectUri]
+         * - [provider]
          * - [state]
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
@@ -132,6 +155,25 @@ private constructor(
          */
         fun redirectUri(redirectUri: JsonField<String>) = apply { body.redirectUri(redirectUri) }
 
+        /**
+         * Mail provider to connect. Defaults to `gmail`.
+         * - `gmail` - Google accounts
+         * - `outlook` - Microsoft accounts
+         *
+         * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned
+         * in the response.
+         */
+        fun provider(provider: Provider) = apply { body.provider(provider) }
+
+        /**
+         * Sets [Builder.provider] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.provider] with a well-typed [Provider] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun provider(provider: JsonField<Provider>) = apply { body.provider(provider) }
+
         /** State parameter for CSRF protection (returned in redirect) */
         fun state(state: String) = apply { body.state(state) }
 
@@ -290,6 +332,7 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val redirectUri: JsonField<String>,
+        private val provider: JsonField<Provider>,
         private val state: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
@@ -299,8 +342,11 @@ private constructor(
             @JsonProperty("redirect_uri")
             @ExcludeMissing
             redirectUri: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("provider")
+            @ExcludeMissing
+            provider: JsonField<Provider> = JsonMissing.of(),
             @JsonProperty("state") @ExcludeMissing state: JsonField<String> = JsonMissing.of(),
-        ) : this(redirectUri, state, mutableMapOf())
+        ) : this(redirectUri, provider, state, mutableMapOf())
 
         /**
          * Your callback URL to receive the inbox_token (must be http or https)
@@ -310,6 +356,19 @@ private constructor(
          */
         fun redirectUri(): String = redirectUri.getRequired("redirect_uri")
 
+        /**
+         * Mail provider to connect. Defaults to `gmail`.
+         * - `gmail` - Google accounts
+         * - `outlook` - Microsoft accounts
+         *
+         * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned
+         * in the response.
+         *
+         * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun provider(): Optional<Provider> = provider.getOptional("provider")
+
         /**
          * State parameter for CSRF protection (returned in redirect)
          *
@@ -327,6 +386,13 @@ private constructor(
         @ExcludeMissing
         fun _redirectUri(): JsonField<String> = redirectUri
 
+        /**
+         * Returns the raw JSON value of [provider].
+         *
+         * Unlike [provider], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("provider") @ExcludeMissing fun _provider(): JsonField<Provider> = provider
+
         /**
          * Returns the raw JSON value of [state].
          *
@@ -363,12 +429,14 @@ private constructor(
         class Builder internal constructor() {
 
             private var redirectUri: JsonField<String>? = null
+            private var provider: JsonField<Provider> = JsonMissing.of()
             private var state: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(body: Body) = apply {
                 redirectUri = body.redirectUri
+                provider = body.provider
                 state = body.state
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
@@ -387,6 +455,25 @@ private constructor(
                 this.redirectUri = redirectUri
             }
 
+            /**
+             * Mail provider to connect. Defaults to `gmail`.
+             * - `gmail` - Google accounts
+             * - `outlook` - Microsoft accounts
+             *
+             * Any value other than `outlook` is treated as `gmail`. The resolved provider is
+             * returned in the response.
+             */
+            fun provider(provider: Provider) = provider(JsonField.of(provider))
+
+            /**
+             * Sets [Builder.provider] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.provider] with a well-typed [Provider] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun provider(provider: JsonField<Provider>) = apply { this.provider = provider }
+
             /** State parameter for CSRF protection (returned in redirect) */
             fun state(state: String) = state(JsonField.of(state))
 
@@ -433,6 +520,7 @@ private constructor(
             fun build(): Body =
                 Body(
                     checkRequired("redirectUri", redirectUri),
+                    provider,
                     state,
                     additionalProperties.toMutableMap(),
                 )
@@ -455,6 +543,7 @@ private constructor(
             }
 
             redirectUri()
+            provider().ifPresent { it.validate() }
             state()
             validated = true
         }
@@ -476,6 +565,7 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (redirectUri.asKnown().isPresent) 1 else 0) +
+                (provider.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (state.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
@@ -485,16 +575,163 @@ private constructor(
 
             return other is Body &&
                 redirectUri == other.redirectUri &&
+                provider == other.provider &&
                 state == other.state &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(redirectUri, state, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(redirectUri, provider, state, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{redirectUri=$redirectUri, state=$state, additionalProperties=$additionalProperties}"
+            "Body{redirectUri=$redirectUri, provider=$provider, state=$state, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Mail provider to connect. Defaults to `gmail`.
+     * - `gmail` - Google accounts
+     * - `outlook` - Microsoft accounts
+     *
+     * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned in
+     * the response.
+     */
+    class Provider @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 GMAIL = of("gmail")
+
+            @JvmField val OUTLOOK = of("outlook")
+
+            @JvmStatic fun of(value: String) = Provider(JsonField.of(value))
+        }
+
+        /** An enum containing [Provider]'s known values. */
+        enum class Known {
+            GMAIL,
+            OUTLOOK,
+        }
+
+        /**
+         * An enum containing [Provider]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Provider] 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 {
+            GMAIL,
+            OUTLOOK,
+            /** An enum member indicating that [Provider] 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) {
+                GMAIL -> Value.GMAIL
+                OUTLOOK -> Value.OUTLOOK
+                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 CasParserInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                GMAIL -> Known.GMAIL
+                OUTLOOK -> Known.OUTLOOK
+                else -> throw CasParserInvalidDataException("Unknown Provider: $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 CasParserInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                CasParserInvalidDataException("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 CasParserInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Provider = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: CasParserInvalidDataException) {
+                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 Provider && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
index 968248e..d9c9bb9 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
@@ -2,6 +2,7 @@
 
 package com.cas_parser.api.models.inbox
 
+import com.cas_parser.api.core.Enum
 import com.cas_parser.api.core.ExcludeMissing
 import com.cas_parser.api.core.JsonField
 import com.cas_parser.api.core.JsonMissing
@@ -14,12 +15,14 @@ import com.fasterxml.jackson.annotation.JsonProperty
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 class InboxConnectEmailResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val expiresIn: JsonField<Long>,
     private val oauthUrl: JsonField<String>,
+    private val provider: JsonField<Provider>,
     private val status: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -28,8 +31,9 @@ private constructor(
     private constructor(
         @JsonProperty("expires_in") @ExcludeMissing expiresIn: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("oauth_url") @ExcludeMissing oauthUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("provider") @ExcludeMissing provider: JsonField<Provider> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<String> = JsonMissing.of(),
-    ) : this(expiresIn, oauthUrl, status, mutableMapOf())
+    ) : this(expiresIn, oauthUrl, provider, status, mutableMapOf())
 
     /**
      * Seconds until the OAuth URL expires (typically 10 minutes)
@@ -47,6 +51,14 @@ private constructor(
      */
     fun oauthUrl(): Optional<String> = oauthUrl.getOptional("oauth_url")
 
+    /**
+     * The provider this OAuth URL was generated for
+     *
+     * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun provider(): Optional<Provider> = provider.getOptional("provider")
+
     /**
      * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -67,6 +79,13 @@ private constructor(
      */
     @JsonProperty("oauth_url") @ExcludeMissing fun _oauthUrl(): JsonField<String> = oauthUrl
 
+    /**
+     * Returns the raw JSON value of [provider].
+     *
+     * Unlike [provider], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("provider") @ExcludeMissing fun _provider(): JsonField<Provider> = provider
+
     /**
      * Returns the raw JSON value of [status].
      *
@@ -99,6 +118,7 @@ private constructor(
 
         private var expiresIn: JsonField<Long> = JsonMissing.of()
         private var oauthUrl: JsonField<String> = JsonMissing.of()
+        private var provider: JsonField<Provider> = JsonMissing.of()
         private var status: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -106,6 +126,7 @@ private constructor(
         internal fun from(inboxConnectEmailResponse: InboxConnectEmailResponse) = apply {
             expiresIn = inboxConnectEmailResponse.expiresIn
             oauthUrl = inboxConnectEmailResponse.oauthUrl
+            provider = inboxConnectEmailResponse.provider
             status = inboxConnectEmailResponse.status
             additionalProperties = inboxConnectEmailResponse.additionalProperties.toMutableMap()
         }
@@ -132,6 +153,18 @@ private constructor(
          */
         fun oauthUrl(oauthUrl: JsonField<String>) = apply { this.oauthUrl = oauthUrl }
 
+        /** The provider this OAuth URL was generated for */
+        fun provider(provider: Provider) = provider(JsonField.of(provider))
+
+        /**
+         * Sets [Builder.provider] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.provider] with a well-typed [Provider] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun provider(provider: JsonField<Provider>) = apply { this.provider = provider }
+
         fun status(status: String) = status(JsonField.of(status))
 
         /**
@@ -170,6 +203,7 @@ private constructor(
             InboxConnectEmailResponse(
                 expiresIn,
                 oauthUrl,
+                provider,
                 status,
                 additionalProperties.toMutableMap(),
             )
@@ -192,6 +226,7 @@ private constructor(
 
         expiresIn()
         oauthUrl()
+        provider().ifPresent { it.validate() }
         status()
         validated = true
     }
@@ -213,8 +248,146 @@ private constructor(
     internal fun validity(): Int =
         (if (expiresIn.asKnown().isPresent) 1 else 0) +
             (if (oauthUrl.asKnown().isPresent) 1 else 0) +
+            (provider.asKnown().getOrNull()?.validity() ?: 0) +
             (if (status.asKnown().isPresent) 1 else 0)
 
+    /** The provider this OAuth URL was generated for */
+    class Provider @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 GMAIL = of("gmail")
+
+            @JvmField val OUTLOOK = of("outlook")
+
+            @JvmStatic fun of(value: String) = Provider(JsonField.of(value))
+        }
+
+        /** An enum containing [Provider]'s known values. */
+        enum class Known {
+            GMAIL,
+            OUTLOOK,
+        }
+
+        /**
+         * An enum containing [Provider]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Provider] 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 {
+            GMAIL,
+            OUTLOOK,
+            /** An enum member indicating that [Provider] 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) {
+                GMAIL -> Value.GMAIL
+                OUTLOOK -> Value.OUTLOOK
+                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 CasParserInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                GMAIL -> Known.GMAIL
+                OUTLOOK -> Known.OUTLOOK
+                else -> throw CasParserInvalidDataException("Unknown Provider: $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 CasParserInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                CasParserInvalidDataException("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 CasParserInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Provider = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: CasParserInvalidDataException) {
+                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 Provider && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -223,16 +396,17 @@ private constructor(
         return other is InboxConnectEmailResponse &&
             expiresIn == other.expiresIn &&
             oauthUrl == other.oauthUrl &&
+            provider == other.provider &&
             status == other.status &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(expiresIn, oauthUrl, status, additionalProperties)
+        Objects.hash(expiresIn, oauthUrl, provider, status, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "InboxConnectEmailResponse{expiresIn=$expiresIn, oauthUrl=$oauthUrl, status=$status, additionalProperties=$additionalProperties}"
+        "InboxConnectEmailResponse{expiresIn=$expiresIn, oauthUrl=$oauthUrl, provider=$provider, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParamsTest.kt b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParamsTest.kt
index 568051f..0808a2b 100644
--- a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParamsTest.kt
+++ b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParamsTest.kt
@@ -11,6 +11,7 @@ internal class InboxConnectEmailParamsTest {
     fun create() {
         InboxConnectEmailParams.builder()
             .redirectUri("https://yourapp.com/oauth-callback")
+            .provider(InboxConnectEmailParams.Provider.OUTLOOK)
             .state("abc123")
             .build()
     }
@@ -20,12 +21,14 @@ internal class InboxConnectEmailParamsTest {
         val params =
             InboxConnectEmailParams.builder()
                 .redirectUri("https://yourapp.com/oauth-callback")
+                .provider(InboxConnectEmailParams.Provider.OUTLOOK)
                 .state("abc123")
                 .build()
 
         val body = params._body()
 
         assertThat(body.redirectUri()).isEqualTo("https://yourapp.com/oauth-callback")
+        assertThat(body.provider()).contains(InboxConnectEmailParams.Provider.OUTLOOK)
         assertThat(body.state()).contains("abc123")
     }
 
diff --git a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponseTest.kt b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponseTest.kt
index 2a2f511..3025036 100644
--- a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponseTest.kt
+++ b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponseTest.kt
@@ -15,12 +15,15 @@ internal class InboxConnectEmailResponseTest {
             InboxConnectEmailResponse.builder()
                 .expiresIn(600L)
                 .oauthUrl("https://accounts.google.com/o/oauth2/v2/auth?client_id=...")
+                .provider(InboxConnectEmailResponse.Provider.OUTLOOK)
                 .status("success")
                 .build()
 
         assertThat(inboxConnectEmailResponse.expiresIn()).contains(600L)
         assertThat(inboxConnectEmailResponse.oauthUrl())
             .contains("https://accounts.google.com/o/oauth2/v2/auth?client_id=...")
+        assertThat(inboxConnectEmailResponse.provider())
+            .contains(InboxConnectEmailResponse.Provider.OUTLOOK)
         assertThat(inboxConnectEmailResponse.status()).contains("success")
     }
 
@@ -31,6 +34,7 @@ internal class InboxConnectEmailResponseTest {
             InboxConnectEmailResponse.builder()
                 .expiresIn(600L)
                 .oauthUrl("https://accounts.google.com/o/oauth2/v2/auth?client_id=...")
+                .provider(InboxConnectEmailResponse.Provider.OUTLOOK)
                 .status("success")
                 .build()
 
diff --git a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncTest.kt b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncTest.kt
index 47362c1..429cea2 100644
--- a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncTest.kt
+++ b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncTest.kt
@@ -38,6 +38,7 @@ internal class InboxServiceAsyncTest {
             inboxServiceAsync.connectEmail(
                 InboxConnectEmailParams.builder()
                     .redirectUri("https://yourapp.com/oauth-callback")
+                    .provider(InboxConnectEmailParams.Provider.OUTLOOK)
                     .state("abc123")
                     .build()
             )
diff --git a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/blocking/InboxServiceTest.kt b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/blocking/InboxServiceTest.kt
index dc041fb..1787cf1 100644
--- a/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/blocking/InboxServiceTest.kt
+++ b/cas-parser-java-core/src/test/kotlin/com/cas_parser/api/services/blocking/InboxServiceTest.kt
@@ -37,6 +37,7 @@ internal class InboxServiceTest {
             inboxService.connectEmail(
                 InboxConnectEmailParams.builder()
                     .redirectUri("https://yourapp.com/oauth-callback")
+                    .provider(InboxConnectEmailParams.Provider.OUTLOOK)
                     .state("abc123")
                     .build()
             )

From fc2389bdcf955faa09806458c8ea75e9647b1a18 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 9 Aug 2026 12:18:02 +0000
Subject: [PATCH 2/3] feat(api): api update

---
 .stats.yml                                    |  4 +-
 .../cas_parser/api/client/CasParserClient.kt  | 16 ++++-
 .../api/client/CasParserClientAsync.kt        | 16 ++++-
 .../api/client/CasParserClientAsyncImpl.kt    | 16 ++++-
 .../api/client/CasParserClientImpl.kt         | 16 ++++-
 .../models/inbox/InboxConnectEmailParams.kt   | 69 +++++++++++++------
 .../models/inbox/InboxConnectEmailResponse.kt |  6 ++
 .../models/inbox/InboxListCasFilesResponse.kt |  4 +-
 .../api/services/async/InboxServiceAsync.kt   | 14 +++-
 .../services/async/InboxServiceAsyncImpl.kt   |  8 ++-
 .../api/services/blocking/InboxService.kt     | 14 +++-
 .../api/services/blocking/InboxServiceImpl.kt |  8 ++-
 12 files changed, 152 insertions(+), 39 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 8fb9d77..c12f542 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 20
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-5c6cdb8b7a2c0ba449927687bc378823ac947b26b7c2e6c379ae14668b73979a.yml
-openapi_spec_hash: 6bc024b866f01da53e2cfd6e404157c7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser/cas-parser-4d179917b01ea51a3325e7b37ecbbb60d0ba8f60381fe715ff3ec31284ca8042.yml
+openapi_spec_hash: d027d37bd7051aa8c05fe1820c05b316
 config_hash: 5509bb7a961ae2e79114b24c381606d4
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClient.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClient.kt
index 41b761e..83082f6 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClient.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClient.kt
@@ -94,7 +94,13 @@ interface CasParserClient {
     /**
      * Endpoints for importing CAS files directly from user email inboxes.
      *
-     * **Supported Providers:** Gmail (more coming soon)
+     * **Supported Providers:**
+     * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+     * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+     *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+     *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+     *   including custom domains.
+     * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
      *
      * **How it works:**
      * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -209,7 +215,13 @@ interface CasParserClient {
         /**
          * Endpoints for importing CAS files directly from user email inboxes.
          *
-         * **Supported Providers:** Gmail (more coming soon)
+         * **Supported Providers:**
+         * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+         * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`,
+         *   `@hotmail.com`, `@live.com`, `@msn.com`, and localised variants such as
+         *   `@hotmail.co.uk`, `@live.in`, `@hotmail.fr`. Any other address registered as a personal
+         *   Microsoft account also works, including custom domains.
+         * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
          *
          * **How it works:**
          * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsync.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsync.kt
index 8c613f7..9508d18 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsync.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsync.kt
@@ -94,7 +94,13 @@ interface CasParserClientAsync {
     /**
      * Endpoints for importing CAS files directly from user email inboxes.
      *
-     * **Supported Providers:** Gmail (more coming soon)
+     * **Supported Providers:**
+     * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+     * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+     *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+     *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+     *   including custom domains.
+     * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
      *
      * **How it works:**
      * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -213,7 +219,13 @@ interface CasParserClientAsync {
         /**
          * Endpoints for importing CAS files directly from user email inboxes.
          *
-         * **Supported Providers:** Gmail (more coming soon)
+         * **Supported Providers:**
+         * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+         * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`,
+         *   `@hotmail.com`, `@live.com`, `@msn.com`, and localised variants such as
+         *   `@hotmail.co.uk`, `@live.in`, `@hotmail.fr`. Any other address registered as a personal
+         *   Microsoft account also works, including custom domains.
+         * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
          *
          * **How it works:**
          * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsyncImpl.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsyncImpl.kt
index 35c5a95..6eb9b52 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsyncImpl.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientAsyncImpl.kt
@@ -137,7 +137,13 @@ class CasParserClientAsyncImpl(private val clientOptions: ClientOptions) : CasPa
     /**
      * Endpoints for importing CAS files directly from user email inboxes.
      *
-     * **Supported Providers:** Gmail (more coming soon)
+     * **Supported Providers:**
+     * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+     * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+     *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+     *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+     *   including custom domains.
+     * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
      *
      * **How it works:**
      * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -289,7 +295,13 @@ class CasParserClientAsyncImpl(private val clientOptions: ClientOptions) : CasPa
         /**
          * Endpoints for importing CAS files directly from user email inboxes.
          *
-         * **Supported Providers:** Gmail (more coming soon)
+         * **Supported Providers:**
+         * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+         * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`,
+         *   `@hotmail.com`, `@live.com`, `@msn.com`, and localised variants such as
+         *   `@hotmail.co.uk`, `@live.in`, `@hotmail.fr`. Any other address registered as a personal
+         *   Microsoft account also works, including custom domains.
+         * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
          *
          * **How it works:**
          * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientImpl.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientImpl.kt
index 50bfe57..7e0d442 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientImpl.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/client/CasParserClientImpl.kt
@@ -131,7 +131,13 @@ class CasParserClientImpl(private val clientOptions: ClientOptions) : CasParserC
     /**
      * Endpoints for importing CAS files directly from user email inboxes.
      *
-     * **Supported Providers:** Gmail (more coming soon)
+     * **Supported Providers:**
+     * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+     * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+     *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+     *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+     *   including custom domains.
+     * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
      *
      * **How it works:**
      * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -283,7 +289,13 @@ class CasParserClientImpl(private val clientOptions: ClientOptions) : CasParserC
         /**
          * Endpoints for importing CAS files directly from user email inboxes.
          *
-         * **Supported Providers:** Gmail (more coming soon)
+         * **Supported Providers:**
+         * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+         * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`,
+         *   `@hotmail.com`, `@live.com`, `@msn.com`, and localised variants such as
+         *   `@hotmail.co.uk`, `@live.in`, `@hotmail.fr`. Any other address registered as a personal
+         *   Microsoft account also works, including custom domains.
+         * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
          *
          * **How it works:**
          * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
index 4e78e84..be98a8d 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailParams.kt
@@ -36,7 +36,10 @@ import kotlin.jvm.optionals.getOrNull
  * - `error` - Error code (e.g., `access_denied`, `token_exchange_failed`)
  * - `state` - Your original state parameter
  *
- * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls.
+ * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls. The token
+ * is long-lived (it stores an encrypted refresh token), so a single OAuth connect gives ongoing
+ * access to both historical and future CAS statements in the user's inbox. Reuse the same token
+ * until the user revokes access via `/v4/inbox/disconnect` or their provider's account settings.
  */
 class InboxConnectEmailParams
 private constructor(
@@ -55,11 +58,14 @@ private constructor(
 
     /**
      * Mail provider to connect. Defaults to `gmail`.
-     * - `gmail` - Google accounts
-     * - `outlook` - Microsoft accounts
+     * - `gmail` - Google accounts: `@gmail.com` and Google Workspace domains.
+     * - `outlook` - personal Microsoft accounts: `@outlook.com`, `@hotmail.com`, `@live.com`,
+     *   `@msn.com` and localised variants (`@hotmail.co.uk`, `@live.in`, `@hotmail.fr`). Any other
+     *   address registered as a personal Microsoft account also works, including custom domains.
+     * - `zoho` - Zoho Mail accounts, including custom domains hosted on Zoho.
      *
-     * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned in
-     * the response.
+     * Any unrecognised value is treated as `gmail`. The resolved provider is returned in the
+     * response.
      *
      * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -157,11 +163,15 @@ private constructor(
 
         /**
          * Mail provider to connect. Defaults to `gmail`.
-         * - `gmail` - Google accounts
-         * - `outlook` - Microsoft accounts
+         * - `gmail` - Google accounts: `@gmail.com` and Google Workspace domains.
+         * - `outlook` - personal Microsoft accounts: `@outlook.com`, `@hotmail.com`, `@live.com`,
+         *   `@msn.com` and localised variants (`@hotmail.co.uk`, `@live.in`, `@hotmail.fr`). Any
+         *   other address registered as a personal Microsoft account also works, including custom
+         *   domains.
+         * - `zoho` - Zoho Mail accounts, including custom domains hosted on Zoho.
          *
-         * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned
-         * in the response.
+         * Any unrecognised value is treated as `gmail`. The resolved provider is returned in the
+         * response.
          */
         fun provider(provider: Provider) = apply { body.provider(provider) }
 
@@ -358,11 +368,15 @@ private constructor(
 
         /**
          * Mail provider to connect. Defaults to `gmail`.
-         * - `gmail` - Google accounts
-         * - `outlook` - Microsoft accounts
+         * - `gmail` - Google accounts: `@gmail.com` and Google Workspace domains.
+         * - `outlook` - personal Microsoft accounts: `@outlook.com`, `@hotmail.com`, `@live.com`,
+         *   `@msn.com` and localised variants (`@hotmail.co.uk`, `@live.in`, `@hotmail.fr`). Any
+         *   other address registered as a personal Microsoft account also works, including custom
+         *   domains.
+         * - `zoho` - Zoho Mail accounts, including custom domains hosted on Zoho.
          *
-         * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned
-         * in the response.
+         * Any unrecognised value is treated as `gmail`. The resolved provider is returned in the
+         * response.
          *
          * @throws CasParserInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -457,11 +471,15 @@ private constructor(
 
             /**
              * Mail provider to connect. Defaults to `gmail`.
-             * - `gmail` - Google accounts
-             * - `outlook` - Microsoft accounts
+             * - `gmail` - Google accounts: `@gmail.com` and Google Workspace domains.
+             * - `outlook` - personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+             *   `@live.com`, `@msn.com` and localised variants (`@hotmail.co.uk`, `@live.in`,
+             *   `@hotmail.fr`). Any other address registered as a personal Microsoft account also
+             *   works, including custom domains.
+             * - `zoho` - Zoho Mail accounts, including custom domains hosted on Zoho.
              *
-             * Any value other than `outlook` is treated as `gmail`. The resolved provider is
-             * returned in the response.
+             * Any unrecognised value is treated as `gmail`. The resolved provider is returned in
+             * the response.
              */
             fun provider(provider: Provider) = provider(JsonField.of(provider))
 
@@ -592,11 +610,14 @@ private constructor(
 
     /**
      * Mail provider to connect. Defaults to `gmail`.
-     * - `gmail` - Google accounts
-     * - `outlook` - Microsoft accounts
+     * - `gmail` - Google accounts: `@gmail.com` and Google Workspace domains.
+     * - `outlook` - personal Microsoft accounts: `@outlook.com`, `@hotmail.com`, `@live.com`,
+     *   `@msn.com` and localised variants (`@hotmail.co.uk`, `@live.in`, `@hotmail.fr`). Any other
+     *   address registered as a personal Microsoft account also works, including custom domains.
+     * - `zoho` - Zoho Mail accounts, including custom domains hosted on Zoho.
      *
-     * Any value other than `outlook` is treated as `gmail`. The resolved provider is returned in
-     * the response.
+     * Any unrecognised value is treated as `gmail`. The resolved provider is returned in the
+     * response.
      */
     class Provider @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -616,6 +637,8 @@ private constructor(
 
             @JvmField val OUTLOOK = of("outlook")
 
+            @JvmField val ZOHO = of("zoho")
+
             @JvmStatic fun of(value: String) = Provider(JsonField.of(value))
         }
 
@@ -623,6 +646,7 @@ private constructor(
         enum class Known {
             GMAIL,
             OUTLOOK,
+            ZOHO,
         }
 
         /**
@@ -637,6 +661,7 @@ private constructor(
         enum class Value {
             GMAIL,
             OUTLOOK,
+            ZOHO,
             /** An enum member indicating that [Provider] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -652,6 +677,7 @@ private constructor(
             when (this) {
                 GMAIL -> Value.GMAIL
                 OUTLOOK -> Value.OUTLOOK
+                ZOHO -> Value.ZOHO
                 else -> Value._UNKNOWN
             }
 
@@ -668,6 +694,7 @@ private constructor(
             when (this) {
                 GMAIL -> Known.GMAIL
                 OUTLOOK -> Known.OUTLOOK
+                ZOHO -> Known.ZOHO
                 else -> throw CasParserInvalidDataException("Unknown Provider: $value")
             }
 
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
index d9c9bb9..98ae215 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxConnectEmailResponse.kt
@@ -270,6 +270,8 @@ private constructor(
 
             @JvmField val OUTLOOK = of("outlook")
 
+            @JvmField val ZOHO = of("zoho")
+
             @JvmStatic fun of(value: String) = Provider(JsonField.of(value))
         }
 
@@ -277,6 +279,7 @@ private constructor(
         enum class Known {
             GMAIL,
             OUTLOOK,
+            ZOHO,
         }
 
         /**
@@ -291,6 +294,7 @@ private constructor(
         enum class Value {
             GMAIL,
             OUTLOOK,
+            ZOHO,
             /** An enum member indicating that [Provider] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -306,6 +310,7 @@ private constructor(
             when (this) {
                 GMAIL -> Value.GMAIL
                 OUTLOOK -> Value.OUTLOOK
+                ZOHO -> Value.ZOHO
                 else -> Value._UNKNOWN
             }
 
@@ -322,6 +327,7 @@ private constructor(
             when (this) {
                 GMAIL -> Known.GMAIL
                 OUTLOOK -> Known.OUTLOOK
+                ZOHO -> Known.ZOHO
                 else -> throw CasParserInvalidDataException("Unknown Provider: $value")
             }
 
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxListCasFilesResponse.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxListCasFilesResponse.kt
index 2240910..5d24622 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxListCasFilesResponse.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/models/inbox/InboxListCasFilesResponse.kt
@@ -294,7 +294,7 @@ private constructor(
 
         /**
          * URL expiration time in seconds. Defaults vary by source:
-         * - Gmail Inbox Import: 86400 (24h)
+         * - Email Inbox Import (Gmail, Outlook, Zoho): 86400 (24h)
          * - Inbound Email with `callback_url` set: 172800 (48h)
          * - Inbound Email without `callback_url`: aligned with the session TTL (~30 min)
          *
@@ -490,7 +490,7 @@ private constructor(
 
             /**
              * URL expiration time in seconds. Defaults vary by source:
-             * - Gmail Inbox Import: 86400 (24h)
+             * - Email Inbox Import (Gmail, Outlook, Zoho): 86400 (24h)
              * - Inbound Email with `callback_url` set: 172800 (48h)
              * - Inbound Email without `callback_url`: aligned with the session TTL (~30 min)
              */
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsync.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsync.kt
index d2a2a85..48499d1 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsync.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsync.kt
@@ -19,7 +19,13 @@ import java.util.function.Consumer
 /**
  * Endpoints for importing CAS files directly from user email inboxes.
  *
- * **Supported Providers:** Gmail (more coming soon)
+ * **Supported Providers:**
+ * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+ * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+ *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+ *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+ *   including custom domains.
+ * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
  *
  * **How it works:**
  * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -79,7 +85,11 @@ interface InboxServiceAsync {
      * - `error` - Error code (e.g., `access_denied`, `token_exchange_failed`)
      * - `state` - Your original state parameter
      *
-     * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls.
+     * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls. The
+     * token is long-lived (it stores an encrypted refresh token), so a single OAuth connect gives
+     * ongoing access to both historical and future CAS statements in the user's inbox. Reuse the
+     * same token until the user revokes access via `/v4/inbox/disconnect` or their provider's
+     * account settings.
      */
     fun connectEmail(
         params: InboxConnectEmailParams
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncImpl.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncImpl.kt
index f3f2599..429fdab 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncImpl.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/async/InboxServiceAsyncImpl.kt
@@ -29,7 +29,13 @@ import java.util.function.Consumer
 /**
  * Endpoints for importing CAS files directly from user email inboxes.
  *
- * **Supported Providers:** Gmail (more coming soon)
+ * **Supported Providers:**
+ * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+ * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+ *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+ *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+ *   including custom domains.
+ * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
  *
  * **How it works:**
  * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxService.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxService.kt
index 051365a..0f13697 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxService.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxService.kt
@@ -19,7 +19,13 @@ import java.util.function.Consumer
 /**
  * Endpoints for importing CAS files directly from user email inboxes.
  *
- * **Supported Providers:** Gmail (more coming soon)
+ * **Supported Providers:**
+ * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+ * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+ *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+ *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+ *   including custom domains.
+ * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
  *
  * **How it works:**
  * 1. Call `POST /v4/inbox/connect` to get an OAuth URL
@@ -78,7 +84,11 @@ interface InboxService {
      * - `error` - Error code (e.g., `access_denied`, `token_exchange_failed`)
      * - `state` - Your original state parameter
      *
-     * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls.
+     * **Store the `inbox_token` client-side** and use it for all subsequent inbox API calls. The
+     * token is long-lived (it stores an encrypted refresh token), so a single OAuth connect gives
+     * ongoing access to both historical and future CAS statements in the user's inbox. Reuse the
+     * same token until the user revokes access via `/v4/inbox/disconnect` or their provider's
+     * account settings.
      */
     fun connectEmail(params: InboxConnectEmailParams): InboxConnectEmailResponse =
         connectEmail(params, RequestOptions.none())
diff --git a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxServiceImpl.kt b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxServiceImpl.kt
index 4abb1e6..0a9f7fd 100644
--- a/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxServiceImpl.kt
+++ b/cas-parser-java-core/src/main/kotlin/com/cas_parser/api/services/blocking/InboxServiceImpl.kt
@@ -28,7 +28,13 @@ import java.util.function.Consumer
 /**
  * Endpoints for importing CAS files directly from user email inboxes.
  *
- * **Supported Providers:** Gmail (more coming soon)
+ * **Supported Providers:**
+ * - **Gmail** (`gmail`, default) — `@gmail.com` and Google Workspace domains
+ * - **Microsoft** (`outlook`) — personal Microsoft accounts: `@outlook.com`, `@hotmail.com`,
+ *   `@live.com`, `@msn.com`, and localised variants such as `@hotmail.co.uk`, `@live.in`,
+ *   `@hotmail.fr`. Any other address registered as a personal Microsoft account also works,
+ *   including custom domains.
+ * - **Zoho Mail** (`zoho`) — Zoho-hosted mailboxes, including custom domains
  *
  * **How it works:**
  * 1. Call `POST /v4/inbox/connect` to get an OAuth URL

From 7af0f72defc17df1835a478906575180d6c6cc48 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Sun, 9 Aug 2026 12:18:35 +0000
Subject: [PATCH 3/3] release: 0.9.0

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

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 6538ca9..6d78745 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.8.0"
+  ".": "0.9.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 49291ba..679b312 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.9.0 (2026-08-09)
+
+Full Changelog: [v0.8.0...v0.9.0](https://github.com/CASParser/cas-parser-java/compare/v0.8.0...v0.9.0)
+
+### Features
+
+* **api:** api update ([fc2389b](https://github.com/CASParser/cas-parser-java/commit/fc2389bdcf955faa09806458c8ea75e9647b1a18))
+* **api:** api update ([0b5a0a6](https://github.com/CASParser/cas-parser-java/commit/0b5a0a6ab6df4b9c90bdbb68aea0965fda0772a9))
+
 ## 0.8.0 (2026-08-04)
 
 Full Changelog: [v0.7.1...v0.8.0](https://github.com/CASParser/cas-parser-java/compare/v0.7.1...v0.8.0)
diff --git a/README.md b/README.md
index e406e83..38599f9 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.cas_parser.api/cas-parser-java)](https://central.sonatype.com/artifact/com.cas_parser.api/cas-parser-java/0.8.0)
-[![javadoc](https://javadoc.io/badge2/com.cas_parser.api/cas-parser-java/0.8.0/javadoc.svg)](https://javadoc.io/doc/com.cas_parser.api/cas-parser-java/0.8.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.cas_parser.api/cas-parser-java)](https://central.sonatype.com/artifact/com.cas_parser.api/cas-parser-java/0.9.0)
+[![javadoc](https://javadoc.io/badge2/com.cas_parser.api/cas-parser-java/0.9.0/javadoc.svg)](https://javadoc.io/doc/com.cas_parser.api/cas-parser-java/0.9.0)
 
 <!-- x-release-please-end -->
 
@@ -22,7 +22,7 @@ Use the Cas Parser MCP Server to enable AI assistants to interact with this API,
 
 <!-- x-release-please-start-version -->
 
-The REST API documentation can be found on [casparser.in](https://casparser.in/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.cas_parser.api/cas-parser-java/0.8.0).
+The REST API documentation can be found on [casparser.in](https://casparser.in/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.cas_parser.api/cas-parser-java/0.9.0).
 
 <!-- x-release-please-end -->
 
@@ -33,7 +33,7 @@ The REST API documentation can be found on [casparser.in](https://casparser.in/d
 ### Gradle
 
 ```kotlin
-implementation("com.cas_parser.api:cas-parser-java:0.8.0")
+implementation("com.cas_parser.api:cas-parser-java:0.9.0")
 ```
 
 ### Maven
@@ -42,7 +42,7 @@ implementation("com.cas_parser.api:cas-parser-java:0.8.0")
 <dependency>
   <groupId>com.cas_parser.api</groupId>
   <artifactId>cas-parser-java</artifactId>
-  <version>0.8.0</version>
+  <version>0.9.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 264d238..2471416 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -9,7 +9,7 @@ repositories {
 
 allprojects {
     group = "com.cas_parser.api"
-    version = "0.8.0" // x-release-please-version
+    version = "0.9.0" // x-release-please-version
 }
 
 subprojects {