lightsparkdev · DhruvPareek · May 8, 2026
diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
diff --git a/openapi.yaml b/openapi.yaml
diff --git a/openapi/components/schemas/errors/Error409.yaml b/openapi/components/schemas/errors/Error409.yaml
@@ -16,9 +16,11 @@ properties:
       |------------|-------------|
       | TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL | Transaction is not pending platform approval |
       | UMA_ADDRESS_EXISTS | UMA address already exists |
+      | EMAIL_OTP_EMAIL_ALREADY_EXISTS | Email address is already associated with an EMAIL_OTP credential |
     enum:
       - TRANSACTION_NOT_PENDING_PLATFORM_APPROVAL
       - UMA_ADDRESS_EXISTS
+      - EMAIL_OTP_EMAIL_ALREADY_EXISTS
   message:
     type: string
     description: Error message

diff --git a/openapi/components/schemas/internal_accounts/InternalAccountEmailUpdateRequest.yaml b/openapi/components/schemas/internal_accounts/InternalAccountEmailUpdateRequest.yaml
@@ -0,0 +1,16 @@
+title: Internal Account Email Update Request
+description: >-
+  Request body for `PATCH /internal-accounts/{id}/email`. The `email`
+  is required on both steps of the signed-retry flow. On step 1 Grid
+  binds it into `payloadToSign`; on step 2 the client echoes the same
+  `email` back and Grid updates the email address used for the
+  internal account's `EMAIL_OTP` credential.
+type: object
+required:
+  - email
+properties:
+  email:
+    type: string
+    format: email
+    description: New email address to associate with the internal account's `EMAIL_OTP` credential.
+    example: new.email@example.com
diff --git a/openapi/components/schemas/internal_accounts/InternalAccountEmailUpdateResponse.yaml b/openapi/components/schemas/internal_accounts/InternalAccountEmailUpdateResponse.yaml
@@ -0,0 +1,21 @@
+title: Internal Account Email Update Response
+type: object
+required:
+  - id
+  - email
+  - updatedAt
+properties:
+  id:
+    type: string
+    description: The id of the internal account whose email address was updated.
+    example: InternalAccount:019542f5-b3e7-1d02-0000-000000000002
+  email:
+    type: string
+    format: email
+    description: Updated email address associated with the internal account's `EMAIL_OTP` credential.
+    example: new.email@example.com
+  updatedAt:
+    type: string
+    format: date-time
+    description: Timestamp when the email address was updated.
+    example: '2026-04-08T15:35:02Z'
diff --git a/openapi/openapi.yaml b/openapi/openapi.yaml