Add delivery method option to member email update (#126)

Co-authored-by: Stytch Codegen Bot <[email protected]>

Author: ci-stytch

stytch/src/main/kotlin/com/stytch/java/b2b/api/organizationsmembers/OrganizationsMembers.kt

@@ -451,13 +451,18 @@ public interface Members {
      * [unlinked](https://stytch.com/docs/b2b/api/unlink-retired-member-email))
      * - Must not be updating for another member (i.e. two members cannot attempt to update to the same email at once)
      *
-     * The member will receive an Email Magic Link that expires in 5 minutes. If they do not verify their new email address in
-     * that timeframe, the email
+     * The member will receive an Email Magic Link (or Email OTP Code, if `EMAIL_OTP` is specified as the delivery method)
+     * that expires in 5 minutes. If they do not verify their new email address in that timeframe, the email
      * will be freed up for other members to use.
      *
-     * The Magic Link will redirect to your `login_redirect_url` (or the configured default if one isn't provided), and you
-     * should invoke the [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal
-     * to complete the flow.
+     * If using Email Magic Links, the magic link will redirect to your `login_redirect_url` (or the configured default if one
+     * isn't provided), and you should invoke the
+     * [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal to complete the
+     * flow.
+     *
+     * If using Email OTP Codes, you should invoke the
+     * [Authenticate Email OTP Code](https://stytch.com/docs/b2b/api/authenticate-email-otp) endpoint as normal to complete
+     * the flow. Make sure to pass the new email address to the endpoint.
      */
     public suspend fun startEmailUpdate(
         data: StartEmailUpdateRequest,
@@ -474,13 +479,18 @@ public interface Members {
      * [unlinked](https://stytch.com/docs/b2b/api/unlink-retired-member-email))
      * - Must not be updating for another member (i.e. two members cannot attempt to update to the same email at once)
      *
-     * The member will receive an Email Magic Link that expires in 5 minutes. If they do not verify their new email address in
-     * that timeframe, the email
+     * The member will receive an Email Magic Link (or Email OTP Code, if `EMAIL_OTP` is specified as the delivery method)
+     * that expires in 5 minutes. If they do not verify their new email address in that timeframe, the email
      * will be freed up for other members to use.
      *
-     * The Magic Link will redirect to your `login_redirect_url` (or the configured default if one isn't provided), and you
-     * should invoke the [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal
-     * to complete the flow.
+     * If using Email Magic Links, the magic link will redirect to your `login_redirect_url` (or the configured default if one
+     * isn't provided), and you should invoke the
+     * [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal to complete the
+     * flow.
+     *
+     * If using Email OTP Codes, you should invoke the
+     * [Authenticate Email OTP Code](https://stytch.com/docs/b2b/api/authenticate-email-otp) endpoint as normal to complete
+     * the flow. Make sure to pass the new email address to the endpoint.
      */
     public fun startEmailUpdate(
         data: StartEmailUpdateRequest,
@@ -498,13 +508,18 @@ public interface Members {
      * [unlinked](https://stytch.com/docs/b2b/api/unlink-retired-member-email))
      * - Must not be updating for another member (i.e. two members cannot attempt to update to the same email at once)
      *
-     * The member will receive an Email Magic Link that expires in 5 minutes. If they do not verify their new email address in
-     * that timeframe, the email
+     * The member will receive an Email Magic Link (or Email OTP Code, if `EMAIL_OTP` is specified as the delivery method)
+     * that expires in 5 minutes. If they do not verify their new email address in that timeframe, the email
      * will be freed up for other members to use.
      *
-     * The Magic Link will redirect to your `login_redirect_url` (or the configured default if one isn't provided), and you
-     * should invoke the [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal
-     * to complete the flow.
+     * If using Email Magic Links, the magic link will redirect to your `login_redirect_url` (or the configured default if one
+     * isn't provided), and you should invoke the
+     * [Authenticate Magic Link](https://stytch.com/docs/b2b/api/authenticate-magic-link) endpoint as normal to complete the
+     * flow.
+     *
+     * If using Email OTP Codes, you should invoke the
+     * [Authenticate Email OTP Code](https://stytch.com/docs/b2b/api/authenticate-email-otp) endpoint as normal to complete
+     * the flow. Make sure to pass the new email address to the endpoint.
      */
     public fun startEmailUpdateCompletable(
         data: StartEmailUpdateRequest,

stytch/src/main/kotlin/com/stytch/java/b2b/models/organizationsmembers/OrganizationsMembers.kt

@@ -16,6 +16,15 @@ import com.stytch.java.b2b.models.organizations.ResultsMetadata
 import com.stytch.java.b2b.models.organizations.SearchQuery
 import com.stytch.java.common.methodoptions.Authorization
 
+@JsonClass(generateAdapter = false)
+public enum class StartEmailUpdateRequestDeliveryMethod {
+    @Json(name = "EMAIL_MAGIC_LINK")
+    EMAIL_MAGIC_LINK,
+
+    @Json(name = "EMAIL_OTP")
+    EMAIL_OTP,
+}
+
 @JsonClass(generateAdapter = false)
 public enum class StartEmailUpdateRequestLocale {
     @Json(name = "en")
@@ -947,6 +956,12 @@ public data class StartEmailUpdateRequest
          */
         @Json(name = "login_template_id")
         val loginTemplateId: String? = null,
+        /**
+         * The method that should be used to verify a member's new email address. The options are `EMAIL_MAGIC_LINK` or
+         * `EMAIL_OTP`. This field is optional, if no value is provided, `EMAIL_MAGIC_LINK` will be used.
+         */
+        @Json(name = "delivery_method")
+        val deliveryMethod: StartEmailUpdateRequestDeliveryMethod? = null,
     )
 
 /**

stytch/src/main/kotlin/com/stytch/java/common/Version.kt

@@ -1,3 +1,3 @@
 package com.stytch.java.common
 
-internal const val VERSION = "7.31.0"
+internal const val VERSION = "7.32.0"

version.gradle.kts

@@ -1 +1 @@
-version = "7.31.0"
+version = "7.32.0"