@fusionauth/typescript-client
Version:
A typescript implementation of the FusionAuth client.
1,008 lines • 296 kB
JavaScript
"use strict";
/*
* Copyright (c) 2019-2026, FusionAuth, All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
* either express or implied. See the License for the specific
* language governing permissions and limitations under the License.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.WebhookEventResult = exports.WebhookAttemptResult = exports.WebAuthnWorkflow = exports.VerificationStrategy = exports.UserVerificationRequirement = exports.UserState = exports.UserActionPhase = exports.UnverifiedBehavior = exports.UnknownScopePolicy = exports.TransactionType = exports.TokenType = exports.ThemeType = exports.UniqueUsernameStrategy = exports.SystemTrustedProxyConfigurationPolicy = exports.SteamAPIMode = exports.Sort = exports.SendSetPasswordIdentityType = exports.SecureGeneratorType = exports.SAMLv2DestinationAssertionPolicy = exports.ResidentKeyRequirement = exports.RefreshTokenUsagePolicy = exports.RefreshTokenExpirationPolicy = exports.ReactorFeatureStatus = exports.PublicKeyCredentialType = exports.ProofKeyForCodeExchangePolicy = exports.PasswordlessStrategy = exports.BreachMatchMode = exports.BreachAction = exports.ObjectState = exports.Oauth2AuthorizedURLValidationPolicy = exports.OAuthScopeHandlingPolicy = exports.OAuthScopeConsentMode = exports.OAuthErrorType = exports.OAuthErrorReason = exports.OAuthApplicationRelationship = exports.MultiFactorLoginPolicy = exports.MultiFactorAction = exports.MessengerType = exports.MessageType = exports.LogoutBehavior = exports.LambdaType = exports.LambdaEngineType = exports.LDAPSecurityMethod = exports.KeyUse = exports.KeyType = exports.KeyAlgorithm = exports.IdentityVerifiedReason = exports.IdentityProviderType = exports.ClientAuthenticationMethod = exports.IdentityProviderLoginMethod = exports.IdentityProviderLinkingStrategy = exports.IPAccessControlEntryAction = exports.HTTPMethod = exports.GrantType = exports.FormType = exports.FormStepType = exports.FormFieldAdminPolicy = exports.FormDataType = exports.FormControl = exports.FamilyRole = exports.ExpiryUnit = exports.ExistingUserStrategy = exports.EventType = exports.EventLogType = exports.EmailSecurityType = exports.DeviceType = exports.CoseKeyType = exports.CoseEllipticCurve = exports.CoseAlgorithmIdentifier = exports.ContentStatus = exports.ConsentStatus = exports.ConnectorType = exports.ClientAuthenticationPolicy = exports.ChangePasswordReason = exports.CaptchaMethod = exports.CanonicalizationMethod = exports.BreachedPasswordStatus = exports.TOTPAlgorithm = exports.AuthenticatorAttachmentPreference = exports.AuthenticatorAttachment = exports.AuthenticationThreats = exports.AttestationType = exports.AttestationConveyancePreference = exports.ApplicationMultiFactorTrustPolicy = exports.XMLSignatureLocation = exports.SAMLLogoutBehavior = exports.RegistrationType = exports.LoginIdType = exports.Algorithm = exports.FusionAuthClient = void 0;
const DefaultRESTClientBuilder_1 = require("./DefaultRESTClientBuilder");
const url_1 = require("url");
class FusionAuthClient {
constructor(apiKey, host, tenantId) {
this.apiKey = apiKey;
this.host = host;
this.tenantId = tenantId;
this.clientBuilder = new DefaultRESTClientBuilder_1.default();
}
/**
* Sets the tenant id, that will be included in the X-FusionAuth-TenantId header.
*
* @param {string | null} tenantId The value of the X-FusionAuth-TenantId header.
* @returns {FusionAuthClient}
*/
setTenantId(tenantId) {
this.tenantId = tenantId;
return this;
}
/**
* Sets whether and how cookies will be sent with each request.
*
* @param value The value that indicates whether and how cookies will be sent.
* @returns {FusionAuthClient}
*/
setRequestCredentials(value) {
this.credentials = value;
return this;
}
/**
* Takes an action on a user. The user being actioned is called the "actionee" and the user taking the action is called the
* "actioner". Both user ids are required in the request object.
*
* @param {ActionRequest} request The action request that includes all the information about the action being taken including
* the Id of the action, any options and the duration (if applicable).
* @returns {Promise<ClientResponse<ActionResponse>>}
*/
actionUser(request) {
return this.start()
.withUri('/api/user/action')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Activates the FusionAuth Reactor using a license Id and optionally a license text (for air-gapped deployments)
*
* @param {ReactorRequest} request An optional request that contains the license text to activate Reactor (useful for air-gap deployments of FusionAuth).
* @returns {Promise<ClientResponse<void>>}
*/
activateReactor(request) {
return this.start()
.withUri('/api/reactor')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Adds a user to an existing family. The family Id must be specified.
*
* @param {UUID} familyId The Id of the family.
* @param {FamilyRequest} request The request object that contains all the information used to determine which user to add to the family.
* @returns {Promise<ClientResponse<FamilyResponse>>}
*/
addUserToFamily(familyId, request) {
return this.start()
.withUri('/api/user/family')
.withUriSegment(familyId)
.withJSONBody(request)
.withMethod("PUT")
.go();
}
/**
* Approve a device grant.
*
* @param {string} client_id (Optional) The unique client identifier. The client Id is the Id of the FusionAuth Application in which you are attempting to authenticate.
* @param {string} client_secret (Optional) The client secret. This value will be required if client authentication is enabled.
* @param {string} token The access token used to identify the user.
* @param {string} user_code The end-user verification code.
* @returns {Promise<ClientResponse<DeviceApprovalResponse>>}
*/
approveDevice(client_id, client_secret, token, user_code) {
let body = new url_1.URLSearchParams();
body.append('client_id', client_id);
body.append('client_secret', client_secret);
body.append('token', token);
body.append('user_code', user_code);
return this.start()
.withUri('/oauth2/device/approve')
.withFormData(body)
.withMethod("POST")
.go();
}
/**
* Approve a device grant.
*
* @param {DeviceApprovalRequest} request The request object containing the device approval information and optional tenantId.
* @returns {Promise<ClientResponse<DeviceApprovalResponse>>}
*/
approveDeviceWithRequest(request) {
let body = new url_1.URLSearchParams();
if (request.client_id !== null && request.client_id !== undefined) {
body.append('client_id', request.client_id);
}
if (request.client_secret !== null && request.client_secret !== undefined) {
body.append('client_secret', request.client_secret);
}
if (request.tenantId !== null && request.tenantId !== undefined) {
body.append('tenantId', request.tenantId.toString());
}
if (request.token !== null && request.token !== undefined) {
body.append('token', request.token);
}
if (request.user_code !== null && request.user_code !== undefined) {
body.append('user_code', request.user_code);
}
return this.start()
.withUri('/oauth2/device/approve')
.withFormData(body)
.withMethod("POST")
.go();
}
/**
* Cancels the user action.
*
* @param {UUID} actionId The action Id of the action to cancel.
* @param {ActionRequest} request The action request that contains the information about the cancellation.
* @returns {Promise<ClientResponse<ActionResponse>>}
*/
cancelAction(actionId, request) {
return this.start()
.withUri('/api/user/action')
.withUriSegment(actionId)
.withJSONBody(request)
.withMethod("DELETE")
.go();
}
/**
* Changes a user's password using the change password Id. This usually occurs after an email has been sent to the user
* and they clicked on a link to reset their password.
*
* As of version 1.32.2, prefer sending the changePasswordId in the request body. To do this, omit the first parameter, and set
* the value in the request body.
*
* @param {string} changePasswordId The change password Id used to find the user. This value is generated by FusionAuth once the change password workflow has been initiated.
* @param {ChangePasswordRequest} request The change password request that contains all the information used to change the password.
* @returns {Promise<ClientResponse<ChangePasswordResponse>>}
*/
changePassword(changePasswordId, request) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withUriSegment(changePasswordId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Changes a user's password using their access token (JWT) instead of the changePasswordId
* A common use case for this method will be if you want to allow the user to change their own password.
*
* Remember to send refreshToken in the request body if you want to get a new refresh token when login using the returned oneTimePassword.
*
* @param {string} encodedJWT The encoded JWT (access token).
* @param {ChangePasswordRequest} request The change password request that contains all the information used to change the password.
* @returns {Promise<ClientResponse<ChangePasswordResponse>>}
*
* @deprecated This method has been renamed to changePasswordUsingJWT, use that method instead.
*/
changePasswordByJWT(encodedJWT, request) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withAuthorization('Bearer ' + encodedJWT)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Changes a user's password using their identity (loginId and password). Using a loginId instead of the changePasswordId
* bypasses the email verification and allows a password to be changed directly without first calling the #forgotPassword
* method.
*
* @param {ChangePasswordRequest} request The change password request that contains all the information used to change the password.
* @returns {Promise<ClientResponse<void>>}
*/
changePasswordByIdentity(request) {
return this.start()
.withUri('/api/user/change-password')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Changes a user's password using their access token (JWT) instead of the changePasswordId
* A common use case for this method will be if you want to allow the user to change their own password.
*
* Remember to send refreshToken in the request body if you want to get a new refresh token when login using the returned oneTimePassword.
*
* @param {string} encodedJWT The encoded JWT (access token).
* @param {ChangePasswordRequest} request The change password request that contains all the information used to change the password.
* @returns {Promise<ClientResponse<ChangePasswordResponse>>}
*/
changePasswordUsingJWT(encodedJWT, request) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withAuthorization('Bearer ' + encodedJWT)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} changePasswordId The change password Id used to find the user. This value is generated by FusionAuth once the change password workflow has been initiated.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingId(changePasswordId) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withUriSegment(changePasswordId)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} changePasswordId The change password Id used to find the user. This value is generated by FusionAuth once the change password workflow has been initiated.
* @param {string} ipAddress (Optional) IP address of the user changing their password. This is used for MFA risk assessment.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingIdAndIPAddress(changePasswordId, ipAddress) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withUriSegment(changePasswordId)
.withParameter('ipAddress', ipAddress)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} encodedJWT The encoded JWT (access token).
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingJWT(encodedJWT) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withAuthorization('Bearer ' + encodedJWT)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Token Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Token by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} encodedJWT The encoded JWT (access token).
* @param {string} ipAddress (Optional) IP address of the user changing their password. This is used for MFA risk assessment.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingJWTAndIPAddress(encodedJWT, ipAddress) {
return this.startAnonymous()
.withUri('/api/user/change-password')
.withAuthorization('Bearer ' + encodedJWT)
.withParameter('ipAddress', ipAddress)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} loginId The loginId (email or username) of the User that you intend to change the password for.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingLoginId(loginId) {
return this.start()
.withUri('/api/user/change-password')
.withParameter('loginId', loginId)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} loginId The loginId (email or username) of the User that you intend to change the password for.
* @param {string} ipAddress (Optional) IP address of the user changing their password. This is used for MFA risk assessment.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingLoginIdAndIPAddress(loginId, ipAddress) {
return this.start()
.withUri('/api/user/change-password')
.withParameter('loginId', loginId)
.withParameter('ipAddress', ipAddress)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} loginId The loginId of the User that you intend to change the password for.
* @param {Array<String>} loginIdTypes The identity types that FusionAuth will compare the loginId to.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingLoginIdAndLoginIdTypes(loginId, loginIdTypes) {
return this.start()
.withUri('/api/user/change-password')
.withParameter('loginId', loginId)
.withParameter('loginIdTypes', loginIdTypes)
.withMethod("GET")
.go();
}
/**
* Check to see if the user must obtain a Trust Request Id in order to complete a change password request.
* When a user has enabled Two-Factor authentication, before you are allowed to use the Change Password API to change
* your password, you must obtain a Trust Request Id by completing a Two-Factor Step-Up authentication.
*
* An HTTP status code of 400 with a general error code of [TrustTokenRequired] indicates that a Trust Token is required to make a POST request to this API.
*
* @param {string} loginId The loginId of the User that you intend to change the password for.
* @param {Array<String>} loginIdTypes The identity types that FusionAuth will compare the loginId to.
* @param {string} ipAddress (Optional) IP address of the user changing their password. This is used for MFA risk assessment.
* @returns {Promise<ClientResponse<void>>}
*/
checkChangePasswordUsingLoginIdAndLoginIdTypesAndIPAddress(loginId, loginIdTypes, ipAddress) {
return this.start()
.withUri('/api/user/change-password')
.withParameter('loginId', loginId)
.withParameter('loginIdTypes', loginIdTypes)
.withParameter('ipAddress', ipAddress)
.withMethod("GET")
.go();
}
/**
* Make a Client Credentials grant request to obtain an access token.
*
* @param {string} client_id (Optional) The client identifier. The client Id is the Id of the FusionAuth Entity in which you are attempting to authenticate.
* This parameter is optional when Basic Authorization is used to authenticate this request.
* @param {string} client_secret (Optional) The client secret used to authenticate this request.
* This parameter is optional when Basic Authorization is used to authenticate this request.
* @param {string} scope (Optional) This parameter is used to indicate which target entity you are requesting access. To request access to an entity, use the format target-entity:<target-entity-id>:<roles>. Roles are an optional comma separated list.
* @returns {Promise<ClientResponse<AccessToken>>}
*/
clientCredentialsGrant(client_id, client_secret, scope) {
let body = new url_1.URLSearchParams();
body.append('client_id', client_id);
body.append('client_secret', client_secret);
body.append('grant_type', 'client_credentials');
body.append('scope', scope);
return this.startAnonymous()
.withUri('/oauth2/token')
.withFormData(body)
.withMethod("POST")
.go();
}
/**
* Make a Client Credentials grant request to obtain an access token.
*
* @param {ClientCredentialsGrantRequest} request The client credentials grant request containing client authentication, scope and optional tenantId.
* @returns {Promise<ClientResponse<AccessToken>>}
*/
clientCredentialsGrantWithRequest(request) {
let body = new url_1.URLSearchParams();
if (request.client_id !== null && request.client_id !== undefined) {
body.append('client_id', request.client_id);
}
if (request.client_secret !== null && request.client_secret !== undefined) {
body.append('client_secret', request.client_secret);
}
if (request.grant_type !== null && request.grant_type !== undefined) {
body.append('grant_type', request.grant_type);
}
if (request.scope !== null && request.scope !== undefined) {
body.append('scope', request.scope);
}
if (request.tenantId !== null && request.tenantId !== undefined) {
body.append('tenantId', request.tenantId);
}
return this.startAnonymous()
.withUri('/oauth2/token')
.withFormData(body)
.withMethod("POST")
.go();
}
/**
* Adds a comment to the user's account.
*
* @param {UserCommentRequest} request The request object that contains all the information used to create the user comment.
* @returns {Promise<ClientResponse<UserCommentResponse>>}
*/
commentOnUser(request) {
return this.start()
.withUri('/api/user/comment')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Completes verification of an identity using verification codes from the Verify Start API.
*
* @param {VerifyCompleteRequest} request The identity verify complete request that contains all the information used to verify the identity.
* @returns {Promise<ClientResponse<VerifyCompleteResponse>>}
*/
completeVerifyIdentity(request) {
return this.start()
.withUri('/api/identity/verify/complete')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Complete a WebAuthn authentication ceremony by validating the signature against the previously generated challenge without logging the user in
*
* @param {WebAuthnLoginRequest} request An object containing data necessary for completing the authentication ceremony
* @returns {Promise<ClientResponse<WebAuthnAssertResponse>>}
*/
completeWebAuthnAssertion(request) {
return this.startAnonymous()
.withUri('/api/webauthn/assert')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Complete a WebAuthn authentication ceremony by validating the signature against the previously generated challenge and then login the user in
*
* @param {WebAuthnLoginRequest} request An object containing data necessary for completing the authentication ceremony
* @returns {Promise<ClientResponse<LoginResponse>>}
*/
completeWebAuthnLogin(request) {
return this.startAnonymous()
.withUri('/api/webauthn/login')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Complete a WebAuthn registration ceremony by validating the client request and saving the new credential
*
* @param {WebAuthnRegisterCompleteRequest} request An object containing data necessary for completing the registration ceremony
* @returns {Promise<ClientResponse<WebAuthnRegisterCompleteResponse>>}
*/
completeWebAuthnRegistration(request) {
return this.start()
.withUri('/api/webauthn/register/complete')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an API key. You can optionally specify a unique Id for the key, if not provided one will be generated.
* an API key can only be created with equal or lesser authority. An API key cannot create another API key unless it is granted
* to that API key.
*
* If an API key is locked to a tenant, it can only create API Keys for that same tenant.
*
* @param {UUID} keyId (Optional) The unique Id of the API key. If not provided a secure random Id will be generated.
* @param {APIKeyRequest} request The request object that contains all the information needed to create the APIKey.
* @returns {Promise<ClientResponse<APIKeyResponse>>}
*/
createAPIKey(keyId, request) {
return this.start()
.withUri('/api/api-key')
.withUriSegment(keyId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an application. You can optionally specify an Id for the application, if not provided one will be generated.
*
* @param {UUID} applicationId (Optional) The Id to use for the application. If not provided a secure random UUID will be generated.
* @param {ApplicationRequest} request The request object that contains all the information used to create the application.
* @returns {Promise<ClientResponse<ApplicationResponse>>}
*/
createApplication(applicationId, request) {
return this.start()
.withUri('/api/application')
.withUriSegment(applicationId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a new role for an application. You must specify the Id of the application you are creating the role for.
* You can optionally specify an Id for the role inside the ApplicationRole object itself, if not provided one will be generated.
*
* @param {UUID} applicationId The Id of the application to create the role on.
* @param {UUID} roleId (Optional) The Id of the role. If not provided a secure random UUID will be generated.
* @param {ApplicationRequest} request The request object that contains all the information used to create the application role.
* @returns {Promise<ClientResponse<ApplicationResponse>>}
*/
createApplicationRole(applicationId, roleId, request) {
return this.start()
.withUri('/api/application')
.withUriSegment(applicationId)
.withUriSegment("role")
.withUriSegment(roleId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an audit log with the message and user name (usually an email). Audit logs should be written anytime you
* make changes to the FusionAuth database. When using the FusionAuth App web interface, any changes are automatically
* written to the audit log. However, if you are accessing the API, you must write the audit logs yourself.
*
* @param {AuditLogRequest} request The request object that contains all the information used to create the audit log entry.
* @returns {Promise<ClientResponse<AuditLogResponse>>}
*/
createAuditLog(request) {
return this.start()
.withUri('/api/system/audit-log')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a connector. You can optionally specify an Id for the connector, if not provided one will be generated.
*
* @param {UUID} connectorId (Optional) The Id for the connector. If not provided a secure random UUID will be generated.
* @param {ConnectorRequest} request The request object that contains all the information used to create the connector.
* @returns {Promise<ClientResponse<ConnectorResponse>>}
*/
createConnector(connectorId, request) {
return this.start()
.withUri('/api/connector')
.withUriSegment(connectorId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a user consent type. You can optionally specify an Id for the consent type, if not provided one will be generated.
*
* @param {UUID} consentId (Optional) The Id for the consent. If not provided a secure random UUID will be generated.
* @param {ConsentRequest} request The request object that contains all the information used to create the consent.
* @returns {Promise<ClientResponse<ConsentResponse>>}
*/
createConsent(consentId, request) {
return this.start()
.withUri('/api/consent')
.withUriSegment(consentId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an email template. You can optionally specify an Id for the template, if not provided one will be generated.
*
* @param {UUID} emailTemplateId (Optional) The Id for the template. If not provided a secure random UUID will be generated.
* @param {EmailTemplateRequest} request The request object that contains all the information used to create the email template.
* @returns {Promise<ClientResponse<EmailTemplateResponse>>}
*/
createEmailTemplate(emailTemplateId, request) {
return this.start()
.withUri('/api/email/template')
.withUriSegment(emailTemplateId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an Entity. You can optionally specify an Id for the Entity. If not provided one will be generated.
*
* @param {UUID} entityId (Optional) The Id for the Entity. If not provided a secure random UUID will be generated.
* @param {EntityRequest} request The request object that contains all the information used to create the Entity.
* @returns {Promise<ClientResponse<EntityResponse>>}
*/
createEntity(entityId, request) {
return this.start()
.withUri('/api/entity')
.withUriSegment(entityId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a Entity Type. You can optionally specify an Id for the Entity Type, if not provided one will be generated.
*
* @param {UUID} entityTypeId (Optional) The Id for the Entity Type. If not provided a secure random UUID will be generated.
* @param {EntityTypeRequest} request The request object that contains all the information used to create the Entity Type.
* @returns {Promise<ClientResponse<EntityTypeResponse>>}
*/
createEntityType(entityTypeId, request) {
return this.start()
.withUri('/api/entity/type')
.withUriSegment(entityTypeId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a new permission for an entity type. You must specify the Id of the entity type you are creating the permission for.
* You can optionally specify an Id for the permission inside the EntityTypePermission object itself, if not provided one will be generated.
*
* @param {UUID} entityTypeId The Id of the entity type to create the permission on.
* @param {UUID} permissionId (Optional) The Id of the permission. If not provided a secure random UUID will be generated.
* @param {EntityTypeRequest} request The request object that contains all the information used to create the permission.
* @returns {Promise<ClientResponse<EntityTypeResponse>>}
*/
createEntityTypePermission(entityTypeId, permissionId, request) {
return this.start()
.withUri('/api/entity/type')
.withUriSegment(entityTypeId)
.withUriSegment("permission")
.withUriSegment(permissionId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a family with the user Id in the request as the owner and sole member of the family. You can optionally specify an Id for the
* family, if not provided one will be generated.
*
* @param {UUID} familyId (Optional) The Id for the family. If not provided a secure random UUID will be generated.
* @param {FamilyRequest} request The request object that contains all the information used to create the family.
* @returns {Promise<ClientResponse<FamilyResponse>>}
*/
createFamily(familyId, request) {
return this.start()
.withUri('/api/user/family')
.withUriSegment(familyId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a form. You can optionally specify an Id for the form, if not provided one will be generated.
*
* @param {UUID} formId (Optional) The Id for the form. If not provided a secure random UUID will be generated.
* @param {FormRequest} request The request object that contains all the information used to create the form.
* @returns {Promise<ClientResponse<FormResponse>>}
*/
createForm(formId, request) {
return this.start()
.withUri('/api/form')
.withUriSegment(formId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a form field. You can optionally specify an Id for the form, if not provided one will be generated.
*
* @param {UUID} fieldId (Optional) The Id for the form field. If not provided a secure random UUID will be generated.
* @param {FormFieldRequest} request The request object that contains all the information used to create the form field.
* @returns {Promise<ClientResponse<FormFieldResponse>>}
*/
createFormField(fieldId, request) {
return this.start()
.withUri('/api/form/field')
.withUriSegment(fieldId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a group. You can optionally specify an Id for the group, if not provided one will be generated.
*
* @param {UUID} groupId (Optional) The Id for the group. If not provided a secure random UUID will be generated.
* @param {GroupRequest} request The request object that contains all the information used to create the group.
* @returns {Promise<ClientResponse<GroupResponse>>}
*/
createGroup(groupId, request) {
return this.start()
.withUri('/api/group')
.withUriSegment(groupId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a member in a group.
*
* @param {MemberRequest} request The request object that contains all the information used to create the group member(s).
* @returns {Promise<ClientResponse<MemberResponse>>}
*/
createGroupMembers(request) {
return this.start()
.withUri('/api/group/member')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an IP Access Control List. You can optionally specify an Id on this create request, if one is not provided one will be generated.
*
* @param {UUID} accessControlListId (Optional) The Id for the IP Access Control List. If not provided a secure random UUID will be generated.
* @param {IPAccessControlListRequest} request The request object that contains all the information used to create the IP Access Control List.
* @returns {Promise<ClientResponse<IPAccessControlListResponse>>}
*/
createIPAccessControlList(accessControlListId, request) {
return this.start()
.withUri('/api/ip-acl')
.withUriSegment(accessControlListId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an identity provider. You can optionally specify an Id for the identity provider, if not provided one will be generated.
*
* @param {UUID} identityProviderId (Optional) The Id of the identity provider. If not provided a secure random UUID will be generated.
* @param {IdentityProviderRequest} request The request object that contains all the information used to create the identity provider.
* @returns {Promise<ClientResponse<IdentityProviderResponse>>}
*/
createIdentityProvider(identityProviderId, request) {
return this.start()
.withUri('/api/identity-provider')
.withUriSegment(identityProviderId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a Lambda. You can optionally specify an Id for the lambda, if not provided one will be generated.
*
* @param {UUID} lambdaId (Optional) The Id for the lambda. If not provided a secure random UUID will be generated.
* @param {LambdaRequest} request The request object that contains all the information used to create the lambda.
* @returns {Promise<ClientResponse<LambdaResponse>>}
*/
createLambda(lambdaId, request) {
return this.start()
.withUri('/api/lambda')
.withUriSegment(lambdaId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates an message template. You can optionally specify an Id for the template, if not provided one will be generated.
*
* @param {UUID} messageTemplateId (Optional) The Id for the template. If not provided a secure random UUID will be generated.
* @param {MessageTemplateRequest} request The request object that contains all the information used to create the message template.
* @returns {Promise<ClientResponse<MessageTemplateResponse>>}
*/
createMessageTemplate(messageTemplateId, request) {
return this.start()
.withUri('/api/message/template')
.withUriSegment(messageTemplateId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a messenger. You can optionally specify an Id for the messenger, if not provided one will be generated.
*
* @param {UUID} messengerId (Optional) The Id for the messenger. If not provided a secure random UUID will be generated.
* @param {MessengerRequest} request The request object that contains all the information used to create the messenger.
* @returns {Promise<ClientResponse<MessengerResponse>>}
*/
createMessenger(messengerId, request) {
return this.start()
.withUri('/api/messenger')
.withUriSegment(messengerId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a new custom OAuth scope for an application. You must specify the Id of the application you are creating the scope for.
* You can optionally specify an Id for the OAuth scope on the URL, if not provided one will be generated.
*
* @param {UUID} applicationId The Id of the application to create the OAuth scope on.
* @param {UUID} scopeId (Optional) The Id of the OAuth scope. If not provided a secure random UUID will be generated.
* @param {ApplicationOAuthScopeRequest} request The request object that contains all the information used to create the OAuth OAuth scope.
* @returns {Promise<ClientResponse<ApplicationOAuthScopeResponse>>}
*/
createOAuthScope(applicationId, scopeId, request) {
return this.start()
.withUri('/api/application')
.withUriSegment(applicationId)
.withUriSegment("scope")
.withUriSegment(scopeId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a tenant. You can optionally specify an Id for the tenant, if not provided one will be generated.
*
* @param {UUID} tenantId (Optional) The Id for the tenant. If not provided a secure random UUID will be generated.
* @param {TenantRequest} request The request object that contains all the information used to create the tenant.
* @returns {Promise<ClientResponse<TenantResponse>>}
*/
createTenant(tenantId, request) {
return this.start()
.withUri('/api/tenant')
.withUriSegment(tenantId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a tenant manager identity provider type configuration for the given identity provider type.
*
* @param {IdentityProviderType} type The type of the identity provider.
* @param {TenantManagerIdentityProviderTypeConfigurationRequest} request The request object that contains all the information used to create the tenant manager identity provider type configuration.
* @returns {Promise<ClientResponse<TenantManagerIdentityProviderTypeConfigurationResponse>>}
*/
createTenantManagerIdentityProviderTypeConfiguration(type, request) {
return this.start()
.withUri('/api/tenant-manager/identity-provider')
.withUriSegment(type)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a Theme. You can optionally specify an Id for the theme, if not provided one will be generated.
*
* @param {UUID} themeId (Optional) The Id for the theme. If not provided a secure random UUID will be generated.
* @param {ThemeRequest} request The request object that contains all the information used to create the theme.
* @returns {Promise<ClientResponse<ThemeResponse>>}
*/
createTheme(themeId, request) {
return this.start()
.withUri('/api/theme')
.withUriSegment(themeId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a user. You can optionally specify an Id for the user, if not provided one will be generated.
*
* @param {UUID} userId (Optional) The Id for the user. If not provided a secure random UUID will be generated.
* @param {UserRequest} request The request object that contains all the information used to create the user.
* @returns {Promise<ClientResponse<UserResponse>>}
*/
createUser(userId, request) {
return this.start()
.withUri('/api/user')
.withUriSegment(userId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a user action. This action cannot be taken on a user until this call successfully returns. Anytime after
* that the user action can be applied to any user.
*
* @param {UUID} userActionId (Optional) The Id for the user action. If not provided a secure random UUID will be generated.
* @param {UserActionRequest} request The request object that contains all the information used to create the user action.
* @returns {Promise<ClientResponse<UserActionResponse>>}
*/
createUserAction(userActionId, request) {
return this.start()
.withUri('/api/user-action')
.withUriSegment(userActionId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a user reason. This user action reason cannot be used when actioning a user until this call completes
* successfully. Anytime after that the user action reason can be used.
*
* @param {UUID} userActionReasonId (Optional) The Id for the user action reason. If not provided a secure random UUID will be generated.
* @param {UserActionReasonRequest} request The request object that contains all the information used to create the user action reason.
* @returns {Promise<ClientResponse<UserActionReasonResponse>>}
*/
createUserActionReason(userActionReasonId, request) {
return this.start()
.withUri('/api/user-action-reason')
.withUriSegment(userActionReasonId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a single User consent.
*
* @param {UUID} userConsentId (Optional) The Id for the User consent. If not provided a secure random UUID will be generated.
* @param {UserConsentRequest} request The request that contains the user consent information.
* @returns {Promise<ClientResponse<UserConsentResponse>>}
*/
createUserConsent(userConsentId, request) {
return this.start()
.withUri('/api/user/consent')
.withUriSegment(userConsentId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Link an external user from a 3rd party identity provider to a FusionAuth user.
*
* @param {IdentityProviderLinkRequest} request The request object that contains all the information used to link the FusionAuth user.
* @returns {Promise<ClientResponse<IdentityProviderLinkResponse>>}
*/
createUserLink(request) {
return this.start()
.withUri('/api/identity-provider/link')
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Creates a webhook. You can optionally specify an Id for the webhook, if not provided one will be generated.
*
* @param {UUID} webhookId (Optional) The Id for the webhook. If not provided a secure random UUID will be generated.
* @param {WebhookRequest} request The request object that contains all the information used to create the webhook.
* @returns {Promise<ClientResponse<WebhookResponse>>}
*/
createWebhook(webhookId, request) {
return this.start()
.withUri('/api/webhook')
.withUriSegment(webhookId)
.withJSONBody(request)
.withMethod("POST")
.go();
}
/**
* Deactivates the application with the given Id.
*
* @param {UUID} applicationId The Id of the application to deactivate.
* @returns {Promise<ClientResponse<void>>}
*/
deactivateApplication(applicationId) {
return this.start()
.withUri('/api/application')
.withUriSegment(applicationId)
.withMethod("DELETE")
.go();
}
/**
* Deactivates the FusionAuth Reactor.
*
* @returns {Promise<ClientResponse<void>>}
*/
deactivateReactor() {
return this.start()
.withUri('/api/reactor')
.withMethod("DELETE")
.go();
}
/**
* Deactivates the user with the given Id.
*
* @param {UUID} userId The Id of the user to deactivate.
* @returns {Promise<ClientResponse<void>>}
*/
deactivateUser(userId) {
return this.start()
.withUri('/api/user')
.withUriSegment(userId)
.withMethod("DELETE")
.go();
}
/**
* Deactivates the user action with the given Id.
*
* @param {UUID} userActionId The Id of the user action to deactivate.
* @returns {Promise<ClientResponse<void>>}
*/
deactivateUserAction(userActionId) {
return this.start()
.withUri('/api/user-action')
.withUriSegment(userActionId)
.withMethod("DELETE")
.go();
}
/**
* Deact