@frontegg/rest-api NPM

Usage

The APIs and states are available by using the using the frontegg rest-api are exposed via promises and interfaces such as the below:

import { someApi } from "@frontegg/rest-api";

await someApi();

Authentication APIs

import { preLogin } from '@frontegg/rest-api';

const redirectUrl = await preLogin({ email: 'john@doe.com' });
if (redirectUrl) {
  // Redirect to SSO
}

Returns if the user needs to be redirected to SSO based on email domain

import { login } from '@frontegg/rest-api';

const loginResponse: {
  accessToken: string;
  refreshToken: string;
  expires: string;
  expiresIn: number;

  mfaRequired: boolean;
  mfaToken?: string; // for multi-factor authentication

  emailVerified?: boolean;
} = await login({ email, password });

Logs in the user using email and password and returns the JWT and refresh token.In case MFA is required the MFA token will be returned

import { loginWithMfa } from '@frontegg/rest-api';

const loginResponse: {
  accessToken: string;
  refreshToken: string;
  expires: string;
  expiresIn: number;

  mfaRequired: boolean;
  mfaToken?: string; // for multi-factor authentication

  emailVerified?: boolean;
} = await loginWithMfa({ mfaToken, value });

Verifies the login using MFA token and value and gets the JWT token and the refresh token back

import { activateAccount } from '@frontegg/rest-api';

await activateAccount({ userId, token, password });

Activates the users' account using the user ID, the token and the users' new password

import { acceptInvitation } from '@frontegg/rest-api';

await acceptInvitation({ userId, token });

Accepts invitation of user to a new tenant and makes the user as active on that tenant

import { refreshToken } from '@frontegg/rest-api';

const loginResponse: {
  accessToken: string;
  refreshToken: string;
  expires: string;
  expiresIn: number;

  mfaRequired: boolean;
  mfaToken?: string; // for multi-factor authentication

  emailVerified?: boolean;
} = await refreshToken();

Refresh the current user authentication

import { logout } from '@frontegg/rest-api';

await logout();

Logs out the user and clears the refresh token

import { logout } from '@frontegg/rest-api';

await logout();

Logs out the user and clears the refresh token

import { resetPassword } from '@frontegg/rest-api';

await logout({
  token,
  userId,
  password
});

Resets password based on token received from the forgot password flow

Allows the user to recover the MFA token

import { recoverMfaToken } from '@frontegg/rest-api';

await recoverMfaToken({
  email,
  recoveryCode
});

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

6 months ago

10 months ago

6 months ago

10 months ago

6 months ago

10 months ago

6 months ago

10 months ago

6 months ago

10 months ago

10 months ago

10 months ago

7 months ago

7 months ago

6 months ago

6 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

7 months ago

8 months ago

8 months ago

8 months ago

8 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

Usage

Authentication APIs

Pre-login

Login

Login with MFA

Activate account

Accept invitation to tenant

Refresh token

Logout

Forgot password

Reset password

Recover MFA token