# Email

Email address management for user accounts. Provides secure email change workflow with verification codes, password confirmation, and notification system. All email changes require authentication and are logged for security.

## Confirm and complete email change

 - [POST /api/v1/accounts/email/change/confirm](https://docs.wellesley.social/openapi/email/paths/~1api~1v1~1accounts~1email~1change~1confirm/post.md): Completes the email change process by verifying the confirmation code. Updates the account's email address upon successful verification. Sends confirmation to the new email address. Invalidates all existing tokens except the current session for security. The change is logged in the audit trail.

## Request email address change

 - [POST /api/v1/accounts/email/change/request](https://docs.wellesley.social/openapi/email/paths/~1api~1v1~1accounts~1email~1change~1request/post.md): Initiates email change process for the authenticated account. Requires current password verification for security. Sends notification to current email and verification code to new email. The new email must not already be registered. Includes IP address and geolocation in notification for security awareness.

## Resend email verification code

 - [PUT /api/v1/accounts/email/change/resend-code](https://docs.wellesley.social/openapi/email/paths/~1api~1v1~1accounts~1email~1change~1resend-code/put.md): Resends the verification code to the new email address for a pending email change. Use when the initial code was not received or has expired. Rate limited to prevent abuse. Requires an active email change request.