All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning
- Removed all ThirdPartyEmailPassword and ThirdPartyPasswordless APIs
- This doesn't result in any removed paths as the same paths exists in the individual recipes, only the rid param is different
- Marked as deprecated:
GET /{apiBasePath}/<tenantId>/signup/phoneNumber/exists
GET /{apiBasePath}/<tenantId>/signup/email/exists
- Added:
GET /{apiBasePath}/<tenantId>/passwordless/phoneNumber/exists
GET /{apiBasePath}/<tenantId>/passwordless/email/exists
GET /{apiBasePath}/<tenantId>/emailpassword/email/exists
- All of the above are moved/renamed version of the APIs marked as deprecated above
-
Added:
PUT
/{apiBasePath}/mfa/info` to query information about MFA factorsGET /{apiBasePath}/totp/device/list
to list all TOTP devicesPOST /{apiBasePath}/totp/device
to add a new TOTP devicePOST /{apiBasePath}/totp/device/remove
to remove a TOTP devicePOST /{apiBasePath}/totp/device/verify
to verify a TOTP devicePOST /{apiBasePath}/totp/verify
to verify a TOTP code
-
Updated loginmethods (
{apiBasePath}/loginmethods
) response type to include a list of first factors
- Updates ThirdParty, ThirdPartyEmailPassword, ThirdPartyPasswordless, Passwordless and EmailPassword recipes to support account linking
- Updates
{apiBasePath}/signinup/code
POST - Updates
{apiBasePath}/signinup/code/consume
POST - Updates
{apiBasePath}/signinup
POST - Updates
{apiBasePath}/signin
POST - Updates
{apiBasePath}/signup
POST - Updates
{apiBasePath}/user/password/reset/token
POST - Updates
{apiBasePath}/user/password/reset
POST
- Updates
- The changes to the above endpoints are:
- Added new response statuses
- Unified the type/shape of the user objects across all different responses
- Renamed
createdNewUser
tocreatedNewRecipeUser
- Updated authorisationurl GET response to match implementation (and plans)
- Multitenancy recipe APIs
- adds
{apiBasePath}/loginmethods
GET
- adds
- Updates ThirdParty, ThirdpartyEmailpassword and Thirdpartypasswordless recipes to support multitenancy
- Updates
{apiBasePath}/signinup
POST - Updates
{apiBasePath}/authorisationurl
GET - Updates
{apiBasePath}/callback/apple
POST
- Updates
- Updated authorization and response headers for header based auth
- Added example user endpoint to showcase the
401
and403
responses - Updated description of
/{apiBasePath}/user/email/verify
to mention claims
- Added
{status: "GENERAL_ERROR", message: string}
as a possible output to all APIs, except for session refresh and apple redirect. - Removed FIELD_ERROR status type from social sign in up APIs
- Adds missing required cookies for the signout API
- Fixes
user
object returned in third party apis.
- ThirdPartyPasswordless recipe APIs
- adds
{apiBasePath}/signinup/code
POST - adds
{apiBasePath}/signinup/code/resend
POST - adds
{apiBasePath}/signinup/code/consume
POST - adds
{apiBasePath}/signup/email/exists
GET - adds
{apiBasePath}/signup/phoneNumber/exists
GET - adds
{apiBasePath}/signinup
POST - adds
{apiBasePath}/authorisationurl
GET - adds
{apiBasePath}/callback/apple
GET
- adds
- passwordless recipe APIs
{apiBasePath}/signinup/code
{apiBasePath}/signinup/code/consume
{apiBasePath}/signup/email/exists
{apiBasePath}/signup/phoneNumber/exists
- OpenId Recipe
- adds
/{apiBasePath}/.well-known/openid-configuration
GET
- adds
- Adds
authCodeResponse
tothirdparty
andthirdpartyemailpassword
'ssigninup
POST API to support auth code exchange via PKCE method. - Adds an optional
clientId
insigninup
API tothirdparty
andthirdpartyemailpassword
- Adds apple sign in callback API
- Email OTP Recipe
- adds
{apiBasePath}/signin
POST - adds
{apiBasePath}/signup
POST - adds
{apiBasePath}/signinup/email/exists
GET - adds
{apiBasePath}/signinup/otp
POST
- adds
- All requests that go through session interception will have a custom header
rid
to prevent CSRF attacks (see this). The backend would then need to check for the existence of this header in case CSRF is enabled
- added
{apiBasePath}/session/signout
- adds
{apiBasePath}/signinup
POST - adds
{apiBasePath}/signout
POST - adds
{apiBasePath}/authorisationurl
POST
- moves
{apiBasePath}/user/email/verify/token
to its own recipe (email verification) - moves
{apiBasePath}/user/email/verify
to its own recipe (email verification) - moves
{apiBasePath}/user/email/verify
to its own recipe (email verification)
- adds
{apiBasePath}/user/email/verify/token
POST - adds
{apiBasePath}/user/email/verify
POST - adds
{apiBasePath}/user/email/verify
GET
- adds
/signup/email/exists
API
- All API requests must have an optional
rid
header. This also needs to be exposed inAccess-Control-Allow-Headers
- removes
supertokens-sdk-name
andsupertokens-sdk-version
- Refresh API URL change
adds {apiBasePath}/signin
adds {apiBasePath}/signup
adds {apiBasePath}/user/password/reset/token
adds {apiBasePath}/user/password/reset