Change the account email

PUT/auth/v1/users/current/emails/change

Starts changing the authenticated account's email address. A verification code is sent to the new address; the change is applied only after the code is confirmed via POST /auth/v1/email/verify. Subject to rate limiting per account.

Authorization

Bearer

Authorization<token>

In: header

Request Body

required

application/json

{
  "$ref": "#/components/schemas/internal_auth.changeEmailBody",
  "$ref-value": {
    "properties": {
      "new_email": {
        "type": "string"
      }
    },
    "required": [
      "new_email"
    ],
    "type": "object"
  }
}

Response Body

200application/json

Verification code sent to the new address

type: unknown

{
  "$ref": "#/components/schemas/authv1.VerificationSentResponse",
  "$ref-value": {
    "properties": {
      "can_resend_at": {
        "type": "string"
      },
      "code_sent": {
        "type": "boolean"
      },
      "message": {
        "type": "string"
      },
      "verification_id": {
        "type": "string"
      }
    },
    "type": "object"
  }
}

curl -X PUT "https://api.rixl.com/auth/v1/users/current/emails/change" \
  -H "Content-Type: application/json" \
  -d '{
    "new_email": "string"
  }'

Verification code sent to the new address

application/json

{
  "$ref": "#/components/schemas/authv1.VerificationSentResponse",
  "$ref-value": {
    "properties": {
      "can_resend_at": {
        "type": "string"
      },
      "code_sent": {
        "type": "boolean"
      },
      "message": {
        "type": "string"
      },
      "verification_id": {
        "type": "string"
      }
    },
    "type": "object"
  }
}