跳到主要内容

updateEmailActivationSettings

EmailActivationSettingsWrapper updateEmailActivationSettings(EmailActivationSettingsRequestDto)

PUT /api/2.0/settings/emailactivation

Update the email activation settings

Updates the current user's own preference for whether the email confirmation prompt is displayed on their account. Requires an authenticated session; every role may change its own setting, and the change never affects any other user. This is a mutating, idempotent call. It returns the settings exactly as submitted, without validating them against the account's actual email confirmation state, so show can be set to true even after the address is already confirmed.

Parameters​

NameInTypeDescriptionNotes
EmailActivationSettingsRequestDtobodyEmailActivationSettingsRequestDto[optional]

Responses​

Status codeDescriptionTypeResponse headers
200Email activation settings exactly as submittedEmailActivationSettingsWrapperX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
401UnauthorizedErrorApiResponse-
429Too Many Requests.ErrorApiResponseRetry-After
500Internal Server Error.ErrorApiResponse-
400Bad Request.ErrorApiResponse-
502Bad Gateway. Returned by the reverse proxy, response body may be HTML and not JSON.--
503Service Unavailable. Returned by the reverse proxy, response body may be HTML and not JSON.--

Return type​

EmailActivationSettingsWrapper

Authorization​

Basic, OAuth2 (scopes: read, write), ApiKeyBearer, asc_auth_key, Bearer, OpenId

HTTP request headers​

  • Content-Type: application/json
  • Accept: application/json