@xfloor-memory-sdk
  1. Registration
@xfloor-memory-sdk
  • Get Started
    • Overview
    • Quick Start
    • Authentication and Identification
    • Core Concepts (5-Minute Read)
    • What to Use First (API Map)
  • SDK
    • Overview
    • SDK Installation & Setup
    • Python SDK
    • JavaScript SDK
    • Typescript SDK
    • Java SDK
    • FAQ & Troubleshooting
    • Copy-Paste Debug Checklists
  • Core FloorMemory
    • Query (Primary API)
      POST
    • Create Event (Post Content)
      POST
    • Recent Events
      GET
    • Basic information of a floor
      GET
  • Floor Management
    • Edit floor
    • Make floor Private
    • Make floor public
    • Rename floor
  • Registration
    • Sign Up
      POST
    • Sign In with email ID
      POST
    • Sign In with Mobile number
      POST
    • Validation
      POST
    • Change Password
      POST
    • Reset Password
      POST
    • Change email ID
      POST
    • Change Mobile number
      POST
    • Send Validation code
      POST
    • External User Registration
      POST
  • SDKs
  • Schemas
    • PostAdd
    • QueryResponse
    • Media
    • UserDetails
    • SignUpResponse
    • BlockDetails
    • FloorInfo
    • Threads
    • EventResponse
    • 400ErrorCode
    • Remaining
  1. Registration

Change email ID

POST
/auth-service/change/email
Updates the email ID associated with an existing user account after validating a one-time activation code sent to the new email address.
This operation can only be performed by a logged-in user. When a user initiates an email change, an activation code is sent to the newly provided email ID. The email update takes effect only after the activation code is successfully validated.
If the activation code validation fails, the email ID remains unchanged.

Authentication#

This endpoint requires Bearer Token authentication.
Authorization: Bearer <access_token>

Request Body#

{
  "user_id": "string",
  "new_email_id": "string",
  "activation_code": "string",
  "app_id":"string"
}
Field Description
user_id – Unique identifier of the logged-in user
new_email_id – New email address to be associated with the account
activation_code – One-time activation code sent to the new email ID for verification

Flow Summary#

1.
User is authenticated and logged in
2.
User requests to change email ID
3.
System sends an activation code to the new email address
4.
User submits the activation code via this API
5.
On successful validation, the email ID is updated

Successful Response#

On successful validation:
The activation code is verified
The user’s email ID is updated immediately
A success string is returned confirming the email change

Error Response#

The API returns an error response if:
The activation code is invalid or expired
The activation code does not match the user or email
The new email ID is already in use
Authorization fails or the bearer token is missing or invalid
In all error cases, the existing email ID remains unchanged.

Behavior Notes#

Requires a prior call to /auth-service/send/validation/code with the proper mode.

Security Notes (Recommended)#

Activation codes are single-use and time-bound
Email changes require prior authentication
Rate limiting may be applied to prevent abuse

One-Line Summary#

Changes a user’s email ID after validating an activation code sent to the new email address.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params multipart/form-dataRequired

Responses

🟢200Success
application/json
Body

🟠400BadRequest
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://appfloor.in/auth-service/change/email' \
--header 'Authorization: Bearer <token>' \
--form 'new_email_id=""' \
--form 'activation_code=""'
Response Response Example
200 - Example 1
{
    "profile": {
        "floor_id": "string",
        "floor_count_info": {
            "permitted": "string",
            "remaining": "string"
        },
        "block_count_info": {
            "permitted": "string",
            "remaining": "string"
        },
        "FID": "string",
        "name": "string",
        "email": "string",
        "mobile_number": "string",
        "user_id": "string",
        "avatar": {
            "url": "string",
            "id": "string"
        }
    },
    "pod_info": {
        "floor_id": "string",
        "is_owner": "string",
        "app_id": "string",
        "title": "string",
        "details": "string",
        "floor_uid": "string",
        "blocks": [
            {
                "block_id": "string",
                "type": "string",
                "title": "string"
            }
        ],
        "avatar": {
            "url": "string",
            "type": "string"
        }
    },
    "app_id": "string"
}
Modified at 2026-01-14 10:32:36
Previous
Reset Password
Next
Change Mobile number
Built with