Class Auth

A collection of authentication related API endpoints

These endpoints allow for various functionality related to authentication. Also contains the Grants API and collection of provider API endpoints.

Hierarchy

Resource
- Auth

Index

Constructors

constructor

new Auth(apiClient): Auth
Parameters
- apiClient: default
  
  The configured Nylas API client
Returns Auth
Overrides Resource.constructor
- Defined in src/resources/auth.ts:34

Properties

apiClient

apiClient: default

grants

grants: Grants

Access the Grants API

Methods

`Protected` _create

_create<T>(params): Promise<NylasResponse<T>>
Type Parameters
- T
Parameters
- params: PayloadParams<T>
Returns Promise<NylasResponse<T>>
Inherited from Resource._create
- Defined in src/resources/resource.ts:169

`Protected` _destroy

_destroy<T>(__namedParameters): Promise<T>
Type Parameters
- T
Parameters
- __namedParameters: DestroyParams
Returns Promise<T>
Inherited from Resource._destroy
- Defined in src/resources/resource.ts:183

`Protected` _find

_find<T>(__namedParameters): Promise<NylasResponse<T>>
Type Parameters
- T
Parameters
- __namedParameters: FindParams<T>
Returns Promise<NylasResponse<T>>
Inherited from Resource._find
- Defined in src/resources/resource.ts:143

`Protected` _list

_list<T>(listParams): AsyncListResponse<T>
Type Parameters
- T extends NylasListResponse<ListResponseInnerType<T>, T>
Parameters
- listParams: ListParams<T>
Returns AsyncListResponse<T>
Inherited from Resource._list
- Defined in src/resources/resource.ts:123

`Protected` _update

_update<T>(params): Promise<NylasResponse<T>>
Type Parameters
- T
Parameters
- params: PayloadParams<T>
Returns Promise<NylasResponse<T>>
Inherited from Resource._update
- Defined in src/resources/resource.ts:173

`Protected` _updatePatch

_updatePatch<T>(params): Promise<NylasResponse<T>>
Type Parameters
- T
Parameters
- params: PayloadParams<T>
Returns Promise<NylasResponse<T>>
Inherited from Resource._updatePatch
- Defined in src/resources/resource.ts:177

detectProvider

detectProvider(params): Promise<ProviderDetectResponse>
Detect provider from email address
Parameters
- params: ProviderDetectParams
  
  The parameters to include in the request
Returns Promise<ProviderDetectResponse>
The detected provider, if found
- Defined in src/resources/auth.ts:142

exchangeCodeForToken

exchangeCodeForToken(request): Promise<CodeExchangeResponse>
Exchange an authorization code for an access token
Parameters
- request: CodeExchangeRequest
  
  The request parameters for the code exchange
Returns Promise<CodeExchangeResponse>
Information about the Nylas application
- Defined in src/resources/auth.ts:54

refreshAccessToken

refreshAccessToken(request): Promise<CodeExchangeResponse>
Refresh an access token
Parameters
- request: TokenExchangeRequest
  
  The refresh token request
Returns Promise<CodeExchangeResponse>
The response containing the new access token
- Defined in src/resources/auth.ts:76

revoke

revoke(token): Promise<boolean>
Revoke a token (and the grant attached to the token)
Parameters
- token: string
  
  The token to revoke
Returns Promise<boolean>
True if the token was revoked successfully
- Defined in src/resources/auth.ts:125

urlForAdminConsent

urlForAdminConsent(config): string
Build the URL for admin consent authentication for Microsoft
Parameters
- config: URLForAdminConsentConfig
  
  The configuration for building the URL
Returns string
The URL for admin consent authentication
- Defined in src/resources/auth.ts:112

urlForOAuth2

urlForOAuth2(config): string
Build the URL for authenticating users to your application with OAuth 2.0
Parameters
- config: URLForAuthenticationConfig
  
  The configuration for building the URL
Returns string
The URL for hosted authentication
- Defined in src/resources/auth.ts:45

urlForOAuth2PKCE

urlForOAuth2PKCE(config): PKCEAuthURL
Build the URL for authenticating users to your application with OAuth 2.0 and PKCE IMPORTANT: YOU WILL NEED TO STORE THE 'secret' returned to use it inside the CodeExchange flow
Parameters
- config: URLForAuthenticationConfig
  
  The configuration for building the URL
Returns PKCEAuthURL
The URL for hosted authentication
- Defined in src/resources/auth.ts:95

Class Auth

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

apiClient: default

Returns Auth

Properties

apiClient

grants

Methods

Protected _create

Type Parameters

T

Parameters

params: PayloadParams<T>

Returns Promise<NylasResponse<T>>

Protected _destroy

Type Parameters

T

Parameters

__namedParameters: DestroyParams

Returns Promise<T>

Protected _find

Type Parameters

T

Parameters

__namedParameters: FindParams<T>

Returns Promise<NylasResponse<T>>

Protected _list

Type Parameters

T extends NylasListResponse<ListResponseInnerType<T>, T>

Parameters

listParams: ListParams<T>

Returns AsyncListResponse<T>

Protected _update

Type Parameters

T

Parameters

params: PayloadParams<T>

Returns Promise<NylasResponse<T>>

Protected _updatePatch

Type Parameters

T

Parameters

params: PayloadParams<T>

Returns Promise<NylasResponse<T>>

detectProvider

Parameters

params: ProviderDetectParams

Returns Promise<ProviderDetectResponse>

exchangeCodeForToken

Parameters

request: CodeExchangeRequest

Returns Promise<CodeExchangeResponse>

refreshAccessToken

Parameters

request: TokenExchangeRequest

Returns Promise<CodeExchangeResponse>

revoke

Parameters

token: string

Returns Promise<boolean>

urlForAdminConsent

Parameters

config: URLForAdminConsentConfig

Returns string

urlForOAuth2

Parameters

config: URLForAuthenticationConfig

Returns string

urlForOAuth2PKCE

Parameters

config: URLForAuthenticationConfig

Returns PKCEAuthURL

Settings

`Protected` _create

`Protected` _destroy

`Protected` _find

`Protected` _list

`Protected` _update

`Protected` _updatePatch