Errors

The Files.com JavaScript SDK will return errors by raising exceptions. There are many exception classes defined in the Files SDK that correspond to specific errors.

The raised exceptions come from two categories:

SDK Exceptions - errors that originate within the SDK
API Exceptions - errors that occur due to the response from the Files.com API. These errors are grouped into common error types.

There are several types of exceptions within each category. Exception classes indicate different types of errors and are named in a fashion that describe the general premise of the originating error. More details can be found in the exception object message using the message attribute.

Use standard Javascript exception handling to detect and deal with errors. It is generally recommended to catch specific errors first, then catch the general FilesError exception as a catch-all.

Example Error Handling

import Session from 'files.com/lib/models/Session';
import * as FilesErrors from 'files.com/lib/Errors';

try {
  const session = await Session.create({ username: 'USERNAME', password: 'BADPASSWORD' });
} catch (err) {
  if (err instanceof FilesErrors.NotAuthenticatedError) {
    console.error(`Authentication Error Occurred (${err.constructor.name}): ${err.error}`);
  } else if (err instanceof FilesErrors.FilesError) {
    console.error(`Unknown Error Occurred (${err.constructor.name}): ${err.error}`);
  } else {
    throw err;
  }
}

Error Types

SDK Errors

SDK errors are general errors that occur within the SDK code. These errors generate exceptions. Each of these exception classes inherit from a standard FilesError base class.

Example SDK Exception Class Inheritance Structure

import * as FilesErrors from 'files.com/lib/Errors'

FilesErrors.ConfigurationError ->
FilesErrors.FilesError ->
Error

SDK Exception Classes

Exception Class Name	Description
`ConfigurationError`	Invalid SDK configuration parameters
`EmptyPropertyError`	Missing a required property
`InvalidParameterError`	A passed in parameter is invalid
`MissingParameterError`	A method parameter is missing
`NotImplementedError`	The called method has not be implemented by the SDK

API Errors

API errors are errors returned by the Files.com API. Each exception class inherits from an error group base class. The error group base class indicates a particular type of error.

Example API Exception Class Inheritance Structure

import * as FilesErrors from 'files.com/lib/Errors'

FilesErrors.NotAuthorized_FolderAdminPermissionRequiredError ->
FilesErrors.NotAuthorizedError ->
FilesErrors.FilesApiError  ->
FilesErrors.FilesError  ->
Error

API Exception Classes

Exception Class Name	Error Group
`BadRequest_AgentUpgradeRequiredError`	`BadRequestError`
`BadRequest_AttachmentTooLargeError`	`BadRequestError`
`BadRequest_CannotDownloadDirectoryError`	`BadRequestError`
`BadRequest_CantMoveWithMultipleLocationsError`	`BadRequestError`
`BadRequest_DatetimeParseError`	`BadRequestError`
`BadRequest_DestinationSameError`	`BadRequestError`
`BadRequest_DestinationSiteMismatchError`	`BadRequestError`
`BadRequest_DoesNotSupportSortingError`	`BadRequestError`
`BadRequest_FolderMustNotBeAFileError`	`BadRequestError`
`BadRequest_FoldersNotAllowedError`	`BadRequestError`
`BadRequest_InternalGeneralErrorError`	`BadRequestError`
`BadRequest_InvalidBodyError`	`BadRequestError`
`BadRequest_InvalidCursorError`	`BadRequestError`
`BadRequest_InvalidCursorTypeForSortError`	`BadRequestError`
`BadRequest_InvalidEtagsError`	`BadRequestError`
`BadRequest_InvalidFilterAliasCombinationError`	`BadRequestError`
`BadRequest_InvalidFilterFieldError`	`BadRequestError`
`BadRequest_InvalidFilterParamError`	`BadRequestError`
`BadRequest_InvalidFilterParamFormatError`	`BadRequestError`
`BadRequest_InvalidFilterParamValueError`	`BadRequestError`
`BadRequest_InvalidInputEncodingError`	`BadRequestError`
`BadRequest_InvalidInterfaceError`	`BadRequestError`
`BadRequest_InvalidOauthProviderError`	`BadRequestError`
`BadRequest_InvalidPathError`	`BadRequestError`
`BadRequest_InvalidReturnToUrlError`	`BadRequestError`
`BadRequest_InvalidSearchQueryError`	`BadRequestError`
`BadRequest_InvalidSortFieldError`	`BadRequestError`
`BadRequest_InvalidSortFilterCombinationError`	`BadRequestError`
`BadRequest_InvalidUploadOffsetError`	`BadRequestError`
`BadRequest_InvalidUploadPartGapError`	`BadRequestError`
`BadRequest_InvalidUploadPartSizeError`	`BadRequestError`
`BadRequest_InvalidWorkspaceIdHeaderError`	`BadRequestError`
`BadRequest_MethodNotAllowedError`	`BadRequestError`
`BadRequest_MultipleSortParamsNotAllowedError`	`BadRequestError`
`BadRequest_NoValidInputParamsError`	`BadRequestError`
`BadRequest_OffsetUploadNotAllowedWithMalwareScanningError`	`BadRequestError`
`BadRequest_PartNumberTooLargeError`	`BadRequestError`
`BadRequest_PathCannotHaveTrailingWhitespaceError`	`BadRequestError`
`BadRequest_ReauthenticationNeededFieldsError`	`BadRequestError`
`BadRequest_RequestBodyTooLargeError`	`BadRequestError`
`BadRequest_RequestParamsContainInvalidCharacterError`	`BadRequestError`
`BadRequest_RequestParamsInvalidError`	`BadRequestError`
`BadRequest_RequestParamsRequiredError`	`BadRequestError`
`BadRequest_SearchAllOnChildPathError`	`BadRequestError`
`BadRequest_UnrecognizedSortIndexError`	`BadRequestError`
`BadRequest_UnsupportedCurrencyError`	`BadRequestError`
`BadRequest_UnsupportedHttpResponseFormatError`	`BadRequestError`
`BadRequest_UnsupportedMediaTypeError`	`BadRequestError`
`BadRequest_UserIdInvalidError`	`BadRequestError`
`BadRequest_UserIdOnUserEndpointError`	`BadRequestError`
`BadRequest_UserRequiredError`	`BadRequestError`
`NotAuthenticated_AdditionalAuthenticationRequiredError`	`NotAuthenticatedError`
`NotAuthenticated_ApiKeySessionsNotSupportedError`	`NotAuthenticatedError`
`NotAuthenticated_AuthenticationRequiredError`	`NotAuthenticatedError`
`NotAuthenticated_BundleRegistrationCodeFailedError`	`NotAuthenticatedError`
`NotAuthenticated_FilesAgentTokenFailedError`	`NotAuthenticatedError`
`NotAuthenticated_InboxRegistrationCodeFailedError`	`NotAuthenticatedError`
`NotAuthenticated_InvalidCredentialsError`	`NotAuthenticatedError`
`NotAuthenticated_InvalidOauthError`	`NotAuthenticatedError`
`NotAuthenticated_InvalidOrExpiredCodeError`	`NotAuthenticatedError`
`NotAuthenticated_InvalidSessionError`	`NotAuthenticatedError`
`NotAuthenticated_InvalidUsernameOrPasswordError`	`NotAuthenticatedError`
`NotAuthenticated_LockedOutError`	`NotAuthenticatedError`
`NotAuthenticated_LockoutRegionMismatchError`	`NotAuthenticatedError`
`NotAuthenticated_OneTimePasswordIncorrectError`	`NotAuthenticatedError`
`NotAuthenticated_TwoFactorAuthenticationErrorError`	`NotAuthenticatedError`
`NotAuthenticated_TwoFactorAuthenticationSetupExpiredError`	`NotAuthenticatedError`
`NotAuthorized_ApiKeyIsDisabledError`	`NotAuthorizedError`
`NotAuthorized_ApiKeyIsPathRestrictedError`	`NotAuthorizedError`
`NotAuthorized_ApiKeyOnlyForDesktopAppError`	`NotAuthorizedError`
`NotAuthorized_ApiKeyOnlyForMobileAppError`	`NotAuthorizedError`
`NotAuthorized_ApiKeyOnlyForOfficeIntegrationError`	`NotAuthorizedError`
`NotAuthorized_BillingInformationHiddenError`	`NotAuthorizedError`
`NotAuthorized_BillingPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_BundleMaximumUsesReachedError`	`NotAuthorizedError`
`NotAuthorized_BundlePermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_CannotLoginWhileUsingKeyError`	`NotAuthorizedError`
`NotAuthorized_CantActForOtherUserError`	`NotAuthorizedError`
`NotAuthorized_ContactAdminForPasswordChangeHelpError`	`NotAuthorizedError`
`NotAuthorized_FilesAgentFailedAuthorizationError`	`NotAuthorizedError`
`NotAuthorized_FolderAdminOrBillingPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_FolderAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_FullPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_HistoryPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_InAppAiAssistantUnavailableError`	`NotAuthorizedError`
`NotAuthorized_InsufficientPermissionForParamsError`	`NotAuthorizedError`
`NotAuthorized_InsufficientPermissionForSiteError`	`NotAuthorizedError`
`NotAuthorized_MoverAccessDeniedError`	`NotAuthorizedError`
`NotAuthorized_MoverPackageRequiredError`	`NotAuthorizedError`
`NotAuthorized_MustAuthenticateWithApiKeyError`	`NotAuthorizedError`
`NotAuthorized_NeedAdminPermissionForInboxError`	`NotAuthorizedError`
`NotAuthorized_NonAdminsMustQueryByFolderOrPathError`	`NotAuthorizedError`
`NotAuthorized_NotAllowedToCreateBundleError`	`NotAuthorizedError`
`NotAuthorized_NotEnqueuableSyncError`	`NotAuthorizedError`
`NotAuthorized_PasswordChangeNotRequiredError`	`NotAuthorizedError`
`NotAuthorized_PasswordChangeRequiredError`	`NotAuthorizedError`
`NotAuthorized_PaymentMethodErrorError`	`NotAuthorizedError`
`NotAuthorized_PreviewOnlyPermissionCannotDownloadError`	`NotAuthorizedError`
`NotAuthorized_ReadOnlySessionError`	`NotAuthorizedError`
`NotAuthorized_ReadPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_ReauthenticationFailedError`	`NotAuthorizedError`
`NotAuthorized_ReauthenticationFailedFinalError`	`NotAuthorizedError`
`NotAuthorized_ReauthenticationNeededActionError`	`NotAuthorizedError`
`NotAuthorized_RecaptchaFailedError`	`NotAuthorizedError`
`NotAuthorized_RemoteDesktopDebugLoggingDisabledError`	`NotAuthorizedError`
`NotAuthorized_RootFolderBehaviorSiteAdminRequiredError`	`NotAuthorizedError`
`NotAuthorized_RootFolderBehaviorSkipSiteAdminRequiredError`	`NotAuthorizedError`
`NotAuthorized_SelfManagedRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminOrPartnerAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminOrWorkspaceAdminOrFolderAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminOrWorkspaceAdminOrPartnerAdminOrFolderAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminOrWorkspaceAdminOrPartnerAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminOrWorkspaceAdminPermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteAdminRequiredError`	`NotAuthorizedError`
`NotAuthorized_SiteFilesAreImmutableError`	`NotAuthorizedError`
`NotAuthorized_TwoFactorAuthenticationRequiredError`	`NotAuthorizedError`
`NotAuthorized_UserIdWithoutSiteAdminError`	`NotAuthorizedError`
`NotAuthorized_WriteAndBundlePermissionRequiredError`	`NotAuthorizedError`
`NotAuthorized_WritePermissionRequiredError`	`NotAuthorizedError`
`NotFound_ApiKeyNotFoundError`	`NotFoundError`
`NotFound_BundlePathNotFoundError`	`NotFoundError`
`NotFound_BundleRegistrationNotFoundError`	`NotFoundError`
`NotFound_CodeNotFoundError`	`NotFoundError`
`NotFound_FileNotFoundError`	`NotFoundError`
`NotFound_FileUploadNotFoundError`	`NotFoundError`
`NotFound_GroupNotFoundError`	`NotFoundError`
`NotFound_InboxNotFoundError`	`NotFoundError`
`NotFound_NestedNotFoundError`	`NotFoundError`
`NotFound_PlanNotFoundError`	`NotFoundError`
`NotFound_SiteNotFoundError`	`NotFoundError`
`NotFound_UserNotFoundError`	`NotFoundError`
`ProcessingFailure_AgentPushUpdateBlockedError`	`ProcessingFailureError`
`ProcessingFailure_AgentUnavailableError`	`ProcessingFailureError`
`ProcessingFailure_AiTaskCannotBeRunManuallyError`	`ProcessingFailureError`
`ProcessingFailure_AlreadyCompletedError`	`ProcessingFailureError`
`ProcessingFailure_AutomationCannotBeRunManuallyError`	`ProcessingFailureError`
`ProcessingFailure_BehaviorNotAllowedOnRemoteServerError`	`ProcessingFailureError`
`ProcessingFailure_BufferedUploadDisabledForThisDestinationError`	`ProcessingFailureError`
`ProcessingFailure_BundleOnlyAllowsPreviewsError`	`ProcessingFailureError`
`ProcessingFailure_BundleOperationRequiresSubfolderError`	`ProcessingFailureError`
`ProcessingFailure_ConfigurationLockedPathError`	`ProcessingFailureError`
`ProcessingFailure_CouldNotCreateParentError`	`ProcessingFailureError`
`ProcessingFailure_DestinationExistsError`	`ProcessingFailureError`
`ProcessingFailure_DestinationFolderLimitedError`	`ProcessingFailureError`
`ProcessingFailure_DestinationParentConflictError`	`ProcessingFailureError`
`ProcessingFailure_DestinationParentDoesNotExistError`	`ProcessingFailureError`
`ProcessingFailure_ExceededRuntimeLimitError`	`ProcessingFailureError`
`ProcessingFailure_ExpectationAlreadyHasOpenWindowError`	`ProcessingFailureError`
`ProcessingFailure_ExpectationNotManualTriggerError`	`ProcessingFailureError`
`ProcessingFailure_ExpiredPrivateKeyError`	`ProcessingFailureError`
`ProcessingFailure_ExpiredPublicKeyError`	`ProcessingFailureError`
`ProcessingFailure_ExportFailureError`	`ProcessingFailureError`
`ProcessingFailure_ExportNotReadyError`	`ProcessingFailureError`
`ProcessingFailure_FailedToChangePasswordError`	`ProcessingFailureError`
`ProcessingFailure_FileLockedError`	`ProcessingFailureError`
`ProcessingFailure_FileNotUploadedError`	`ProcessingFailureError`
`ProcessingFailure_FilePendingProcessingError`	`ProcessingFailureError`
`ProcessingFailure_FileProcessingErrorError`	`ProcessingFailureError`
`ProcessingFailure_FileTooBigToDecryptError`	`ProcessingFailureError`
`ProcessingFailure_FileTooBigToEncryptError`	`ProcessingFailureError`
`ProcessingFailure_FileUploadedToWrongRegionError`	`ProcessingFailureError`
`ProcessingFailure_FilenameTooLongError`	`ProcessingFailureError`
`ProcessingFailure_FolderLockedError`	`ProcessingFailureError`
`ProcessingFailure_FolderNotEmptyError`	`ProcessingFailureError`
`ProcessingFailure_HistoryUnavailableError`	`ProcessingFailureError`
`ProcessingFailure_InvalidBundleCodeError`	`ProcessingFailureError`
`ProcessingFailure_InvalidFileTypeError`	`ProcessingFailureError`
`ProcessingFailure_InvalidFilenameError`	`ProcessingFailureError`
`ProcessingFailure_InvalidPriorityColorError`	`ProcessingFailureError`
`ProcessingFailure_InvalidRangeError`	`ProcessingFailureError`
`ProcessingFailure_InvalidSiteError`	`ProcessingFailureError`
`ProcessingFailure_InvalidZipFileError`	`ProcessingFailureError`
`ProcessingFailure_MetadataNotSupportedOnRemotesError`	`ProcessingFailureError`
`ProcessingFailure_ModelSaveErrorError`	`ProcessingFailureError`
`ProcessingFailure_MultipleProcessingErrorsError`	`ProcessingFailureError`
`ProcessingFailure_PathTooLongError`	`ProcessingFailureError`
`ProcessingFailure_RecipientAlreadySharedError`	`ProcessingFailureError`
`ProcessingFailure_RemoteServerErrorError`	`ProcessingFailureError`
`ProcessingFailure_ResourceBelongsToParentSiteError`	`ProcessingFailureError`
`ProcessingFailure_ResourceLockedError`	`ProcessingFailureError`
`ProcessingFailure_SubfolderLockedError`	`ProcessingFailureError`
`ProcessingFailure_SyncInProgressError`	`ProcessingFailureError`
`ProcessingFailure_TwoFactorAuthenticationCodeAlreadySentError`	`ProcessingFailureError`
`ProcessingFailure_TwoFactorAuthenticationCountryBlacklistedError`	`ProcessingFailureError`
`ProcessingFailure_TwoFactorAuthenticationGeneralErrorError`	`ProcessingFailureError`
`ProcessingFailure_TwoFactorAuthenticationMethodUnsupportedErrorError`	`ProcessingFailureError`
`ProcessingFailure_TwoFactorAuthenticationUnsubscribedRecipientError`	`ProcessingFailureError`
`ProcessingFailure_UpdatesNotAllowedForRemotesError`	`ProcessingFailureError`
`RateLimited_DuplicateShareRecipientError`	`RateLimitedError`
`RateLimited_ReauthenticationRateLimitedError`	`RateLimitedError`
`RateLimited_TooManyConcurrentLoginsError`	`RateLimitedError`
`RateLimited_TooManyConcurrentRequestsError`	`RateLimitedError`
`RateLimited_TooManyLoginAttemptsError`	`RateLimitedError`
`RateLimited_TooManyRequestsError`	`RateLimitedError`
`RateLimited_TooManySharesError`	`RateLimitedError`
`ServiceUnavailable_AutomationsUnavailableError`	`ServiceUnavailableError`
`ServiceUnavailable_MigrationInProgressError`	`ServiceUnavailableError`
`ServiceUnavailable_SiteDisabledError`	`ServiceUnavailableError`
`ServiceUnavailable_UploadsUnavailableError`	`ServiceUnavailableError`
`SiteConfiguration_AccountAlreadyExistsError`	`SiteConfigurationError`
`SiteConfiguration_AccountOverdueError`	`SiteConfigurationError`
`SiteConfiguration_NoAccountForSiteError`	`SiteConfigurationError`
`SiteConfiguration_SiteWasRemovedError`	`SiteConfigurationError`
`SiteConfiguration_TrialExpiredError`	`SiteConfigurationError`
`SiteConfiguration_TrialLockedError`	`SiteConfigurationError`
`SiteConfiguration_UserRequestsEnabledRequiredError`	`SiteConfigurationError`