OAuth

Verify an email sign-in link or code

Accepts exactly ONE of two bodies: {"token": "..."} (the link's fragment token) or {"email", "code"} (the six-digit code). Every failure case — unknown, expired, wrong code, already consumed, locked out after 5 wrong attempts, or malformed — returns the identical 401 body, so a caller cannot distinguish them. There is no GET route for this endpoint — a link scanner or prefetcher that merely opens the emailed link cannot burn the challenge.

On success returns redirect_to, the same shape /oauth/github/callback produces: either the dashboard's /callback?code=... or, if the original start call's return_to is still valid against the OAuth-bridge finalize prefix, that URL with ?code=... appended.

post/oauth/email/verify

Request

  • Base URL: https://api.uptimemonitoring.com
  • URL: https://api.uptimemonitoring.com/oauth/email/verify
  • Auth: none required

Request body

tokenstring

The link's fragment token. Mutually exclusive with email/code.

emailstring email
codestring

Six-digit code. Requires email; mutually exclusive with token.

Response

Sign-in succeeded.

redirect_tostring uri

Changes

No recorded changes to this operation across all 1 revision of this API.