Users

Cancel a pending email change (abort link)

Public endpoint. No authentication required. Called automatically when the account owner clicks the cancel link in the notice email sent to their current address after a change request was submitted. The link embeds a single-use token that expires 25 hours after the original request. The response is always a plain message and never reveals account-specific details. If the token is invalid, expired, or already used, a generic response is returned without confirming account existence.

AuthPublic
GroupUsers
Rate limitSee Rate Limits
GET/api/users/email-change/cancel

SDK setup

Create a client instance. No authentication is required for this endpoint.

import { Configuration, UsersApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
});

const users = new UsersApi(configuration);

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const { data: result } = await users.cancelEmailChange();

Playground

live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

No Request Yet

Send a request to see the full inspector

Authentication

Public - No Auth Required

Query Parameters

NameTypeRequiredDescription
tokenstringYesThe single-use cancel token embedded in the notice email link.

Responses

200Always 200 for any token lookup outcome. The `message` field indicates what happened: - `"Your email change has been cancelled. No change was made to your account."` - request was pending and is now cancelled. - `"This email change request has already been cancelled."` - the token is valid but the request was already in cancelled status (idempotent). - `"The email change has already been confirmed and cannot be cancelled."` - the email swap completed before the cancel arrived. - `"This cancellation link is not valid or has already been used."` - token not found in the system. - `"This cancellation link has expired. The change request also expired and no change was made."` - 25-hour TTL has passed.
json
{
  "message": "Stylish Keyboard designed to make you stand out with lively looks"
}
400Token query parameter missing from the request.
json
{
  "error": "program back up"
}

Errors

CodeMeaning
400Token query parameter missing from the request.
Edit this page on GitHub
Chat with us