Verify Email
Mark the calling user's email address as verified by presenting the token sent in the verification email. The token travels in the URL query string (?token=...), not in a JSON body — this lets the verification email link work as a plain HTTP GET that any browser can follow without scripting.
Tokens expire after 24 hours. On success the user's email_verified flag flips to true and verification-gated features (UDP tunnels, dedicated IPs, larger plans) immediately become available. The token is consumed (deleted from the database) so it can't be replayed.
Query parameters
token string Req
The token from the verification email URL. Single-use; expires after 24h. Issue a fresh one with /auth/resend-verification.
Response (200 OK)
message string
Confirmation. The user's account state is updated server-side; clients should refresh any cached profile.
Errors
400 Bad Request
Missing
token query parameter, or the token is invalid / already used / expired.500
Database error updating the verification flag. Token may have been consumed — request a fresh one.
Request
curl "https://api.ngris.com/v1/auth/verify-email?token=<verification-token>"
Python
from ngris import Ngris
client = Ngris(api_key="placeholder")
client.auth.verify_email("<verification-token>")
Response — 200 OK
{
"message": "Email verified successfully."
}