Update User Email

post/api/v1/admin/user/{id}/email

Update the email of a user.

Path Parameters

  • idstringRequired
    The user ID
    Min length: >= 1 characters

Request Body

email string
The new email to replace the existing email
Min length: >= 1 characters
verifiedOne of
Whether the email is verified
ticket string
Ticket link for tracking email change
Min length: >= 1 characters

200 Response

agreements object required
The agreements the user has accepted
patriotAct number required
termsOfUse number required
patriotActAcceptanceDate string <date-time>
termsOfUseAcceptanceDate string <date-time>
allowedCoins array[string] required
The coins the user is allowed to use
bitgoEmployee boolean required
Whether the user is a BitGo employee
currency object required
The user's preferred currency
bitcoinUnit string required
currency string required
disableReset2FA boolean required
Whether the user has disabled 2FA reset
organizations array[object] required
The organizations the user is a member of
permissions array[string] required
Allowed value: admin
role string required
Allowed values: serviceUser admin member customer
Example: admin
id string
name string
featureFlags array[string] required
Any feature flags the user has enabled
forceResetPassword boolean required
Whether the user has forced a password reset
identity object required
The user's identity information
kyc object
verified boolean
Whether the user is verified
otpDevices array[object] required
The user's devices that can be used for OTP authentication
createDate string <date-time>required
id string required
backupPhone string
label string
lastValidatedDate string <date-time>
phone string
registeredKey object
type string
Allowed values: authy totp u2f webauthn yubikey
verified boolean
scopes array[string]
Allowed value: wallet_hot
extensions dictionary<string, boolean>
prfSalt string
isPasskey boolean
phone object required
The user's phone number
phone
string or null
required
Example: 408-718-6885
verified boolean required
Example: true
timezone string required
The user's timezone
apps
country string
The country of the user
Example: USA
ecdhKeychain
string or null
The user's ECDH keychain
isActive boolean
Whether the user is active
isFrozen boolean
Whether the user is frozen
freezeReason string
The reason the user is frozen if they are frozen
Example: Frozen due to suspicious activity
freeze object
Freeze object that will hold the start time and expiration time of a user's freeze. By default the freeze is infinite, and this field will eventually override the isFrozen boolean field
time string <date-time>
expires string <date-time>
lastLogin string <date-time>
The last login time of the user
locale string
The user's locale
pgpKey string
The user's PGP key
rateLimits
referrer object
The referrer of the user
campaign
string or null
source
string or null
signupDomain string
The signup domain of the user
state string
The state of the user
Example: New York
sourceVerificationRequired boolean
Whether source verification is required for the user
sourceVerificationRequiredForReadOnlyAccess boolean
Whether source verification is required for read-only access
recoveryCodeSet object
The recovery code set for the user
id string required
The ID of the recovery code set
allCodesUsed boolean required
Whether all recovery codes have been used
createTime string
passwordUpdatedAt string <date-time>
id string required
The unique identifier for the user
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
username string <email>required
The username of the user
Example: user@email.com
name object required
The name of the user
first string required
Example: Jane
full string required
Example: Jane Doe
last string required
Example: Doe
enterprises array[object] required
The enterprise(s) the user is a member of
permissions array[string] required
This type represents the permissions that can be assigned to a user when adding them to an enterprise 1. 'admin': Add/remove users, Create wallets, Manage enterprise policies, Add Bank Accounts, Receive invitations to wallets 2. 'auditor': View audit logs across the enterprise, Receive invitations to wallets
Allowed values: admin auditor
id string
beneficialOwner boolean
primaryContact string
kycState string
Allowed values: unverified approved rejected pending qrscanned inreview flagged flagged_retry_allowed
bitgoOrg string
name string
email object required
The email address of the user
email string <email>required
Example: user@email.com
verified boolean required
Example: true

201 Response

pendingApprovalId string required
ID of the created pending approval
Min length: >= 1 characters
status string required
Status of the pending approval
Allowed values: pending approved rejected cancelled
message string required
Human-readable message describing the action
Min length: >= 1 characters
description string required
Description of the admin action that requires approval
Min length: >= 1 characters
resourceType string required
Type of resource being modified by the admin action
Min length: >= 1 characters
approvers number required
Number of approvers assigned to review this action

400 Response

One of
name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id