/me/change-info/verify-email - Complete a pending email change

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api.my.nethesis.it/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}
Close
POST /me/change-info/verify-email
Bearer auth

Apply the email change parked by POST /me/change-info, once the one-time code mailed to the new address proves the caller controls it. The address is taken from the pending change, never from this request. Five wrong codes drop the pending change; a new one must then be requested. The old address stays in effect until this call succeeds. Rate limited per client IP.

application/json

Body Required

  • code string Required

    The one-time code mailed to the new address by POST /me/change-info

Responses

  • 200 application/json

    Email changed

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attribute Show data attribute object
      • updated_fields array[string]
  • 400 application/json

    Wrong or expired code (validation_error on key code), no pending email change (data.type = no_pending_email_change), or too many wrong codes (same type; the pending change was dropped)

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • type string

        Values are validation_error or no_pending_email_change.

      • errors array[object]
        Hide errors attributes Show errors attributes object
        • key string

          Value is code.

        • message string

          Values are invalid verification code or invalid or expired verification code.

        • value string
  • 409 application/json

    The verified address already belongs to another account

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object
      Hide data attributes Show data attributes object
      • type string
      • key string
  • 401

    Unauthorized - invalid or missing JWT token

  • 429

    Rate limit exceeded

  • 503

    The verification store is unavailable; nothing was applied

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
POST /me/change-info/verify-email 
curl \
 --request POST 'https://my.nethesis.it/backend/api/me/change-info/verify-email' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "code": "482913"
}'
Request examples 
{
  "code": "482913"
}
Response examples (200) 
{
  "code": 200,
  "message": "profile updated successfully",
  "data": {
    "updated_fields": [
      "email"
    ]
  }
}
Response examples (400) 
{
  "code": 400,
  "message": "validation failed",
  "data": {
    "type": "validation_error",
    "errors": [
      {
        "key": "code",
        "message": "invalid verification code",
        "value": "string"
      }
    ]
  }
}
Response examples (409) 
{
  "code": 409,
  "message": "email already in use by another account",
  "data": {
    "type": "already_exists",
    "key": "email"
  }
}
Response examples (500) 
{
  "code": 500,
  "message": "internal server error",
  "data": {}
}