v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Set OTP delivery preference for handle login

Set your preferred OTP delivery channel when logging in via handle.

Valid values:

  • "email": Prefer email OTP
  • "sms": Prefer SMS OTP
  • null: Clear preference (show all options)

When set, the preferred channel appears first in the available methods during handle login. This helps streamline the login flow.

Note: You must have a verified identity of the preferred type. Setting a preference for a type you don't have will have no effect.

Authentication: Authorization: Bearer <CLIENT_JWT>

patch/v1/account/otp-preference

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Request body

preferencestring nullable

OTP delivery preference: 'email', 'sms', or null to clear. When set, this channel appears first in available methods during login.

Response

Successful Response

preferencestring nullable

Current OTP preference ('email', 'sms', or null if not set)