This section of the user guide describes how you can programmatically interact with the MetaDefender Storage Security REST API. Below are some common tasks that can be done using the available REST APIs:

  • Authenticate to obtain a JSON Web Token(JWT)
  • Start or stop a process(scan)
  • Add / remove storage units

About this REST API

The exposed endpoint is located by default at http(s)://md-storage-server/api/ (for example, the authentication endpoint is available at http(s)://md-storage-server/api/user/authenticate). All requests are handled by the NGINX web server before being proxied to the backend API Gateway service.

All endpoints perform authentication and authorization checks. For these checks to succeed, a valid token should be presented in the Authorization header in the form of Bearer.

Please note that all issued tokens have a timestamp and signature associated in order to prevent long-term usage without re - authentication.The lifespan of the token is currently set to 60 minutes, meaning you will have to request a new token before it expires in order to avoid error responses.

Server
http://<MDSS_HOST>
Server Variables
http Bearer

As mentioned earlier, all endpoints perform authentication and authorization checks. In order for these checks to succeed, a valid token should be presented in the Authorization header in the form of Bearer .

Suggested application logic

If you plan to integrate MetaDefender Storage Security in your custom application or workflow, please consider the following scenarios for successfully making REST API requests:

Scenario Possible use cases
Short-lived integration You are building or enhancing an application that requires sporadic or on-demand access to MetaDefender Storage Security REST APIs.
The application is not expected to make more than a few REST API calls per hour.
The application does not need to preserve a session.
Long-lived integration You are building or enhancing an application that requires continuous, uninterrupted, or hard to predict access to MetaDefender for Secure Storage REST APIs.
Requests are being triggered based on external factors and your application should maintain connectivity with MetaDefender Storage Security REST API.
Session preserving is necessary and authentication should happen without user-interaction.
Your application will make a significant number of REST API requests and you need increased performance
API Key integration You are building or enhancing an application that requires continuous, uninterrupted, or hard to predict access to MetaDefender for Secure Storage REST APIs.
Requests are being triggered based on external factors and your application should maintain connectivity with MetaDefender Storage Security REST API.
Authentication should happen without user-interaction.
Your application will make a significant number of REST API requests and you need increased performance.

Short-lived integration

  • Obtain a signed accessToken by calling /api/user/authenticate API

  • Use this token to call your desired REST API by providing it in the Authorization header

  • Expire the token by calling /api/user/logout

  • Repeat steps 1-3 the next time your application needs to call a REST API

Long-lived integration

  • Obtain a signed token by calling /api/user/authenticate API

  • Securely save the received accessToken and the refreshToken

  • Use the accessToken to call your desired REST API by providing it in the Authorization header

  • Add an exception handler in case you receive a 401 Unauthorized response because the JWT has expired call /api/user/refreshToken to obtain a new accessToken by providing the saved refreshToken.

    a) the accessToken expires after an hour of creation; the expiry time is represented in UTC format by the accessTokenExpiryTime value.
    b) the refreshToken expires after an hour of creation; the expiry time is represented in UTC format by the refreshTokenExpiryTime value. c) if the refreshToken has expired as well, obtain a signed token by calling /api/user/authenticate API

  • Use the newly issued accessToken to call your desired REST API by providing it in the Authorization header

API Key integration

  • In the MetaDefender Storage Security interface, Navigate to Settings -> Users

  • Find your user entry in the user list, click on the three dots on the right side of the entry, and then click on Generate an API Key

  • Generate the key, copy it, and store it somewhere safe

  • Use the API Key to call your desired REST API by providing it as a header with the Key: "ApiKey" and Value:

General considerations

The access token expiration date cannot be extended. By default, the access token is valid for an hour after calling /api/user/authenticate API to obtain it. The refresh token is also valid for an hour but can be extended by calling /api/user/refreshToken and it is also automatically extended with an hour with each non-GET request.

A refresh token is used to request a new access token when the current one expires without requiring re-authentication using a username and password.

The refresh token is used to forcibly expire any previously issued JWT when the refresh token expires or is removed by calling /api/user/logout.

A 3rd party application that needs persistent connectivity with MetaDefender for Secure Storage should implement a timeout mechanism to ensure that the refresh token is renewed before it expires by calling /api/user/refreshToken whenever the JWT (access token) is expired but before the refresh token expires as well.


Fetch all accounts

Auth
GET /api/account
Copy
Responses
200

Add an account

Auth
Query String
Namestring
Descriptionstring
Credentialsstring
ProtocolType
AutoDiscoveryboolean
GroupIdstring
StorageIdsarray
Request Body
objectobject
CredentialsFilefile
POST /api/account
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
accountobject
idstring
namestring
descriptionstring
credentialsstring
storageIdsarray[string]
Response
Copy

Update an account

Auth
Query String
AccountIdstring
Namestring
Descriptionstring
Credentialsstring
ProtocolType
AutoDiscoveryboolean
GroupIdstring
Request Body
objectobject
CredentialsFilefile
PATCH /api/account
Copy
Responses
200
Response
Copy

Fetch account by ID

Auth
Path Params
accountIdstring
GET /api/account/{accountId}
Copy
Responses
200

Delete an account

Auth
Path Params
accountIdstring
DELETE /api/account/{accountId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
accountIdstring
Response
Copy

Fetch available storage units for an account

Auth
Path Params
accountIdstring
GET /api/account/{accountId}/storages
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entriesarray[object]
bucketNamestring
Response
Copy

Fetch the number of accounts

Auth
GET /api/account/count
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
accountCount
objectobject
countint64
Response
Copy

Audit

List audit information

Fetch audit logs

Auth
Path Params
startIndexstring
countstring
Query String
logTypestring
categoryTypestring
logLevelstring
searchTextstring
GET /api/audit/{startIndex}/{count}
Copy
Responses
200
Response
Copy

Export configuration file

Auth
Query String
exportLicenseboolean
exportSmtpboolean
exportEmailNotificationsboolean
exportRetentionboolean
GET /api/configuration/export
Copy
Responses
200
filefile
Response
Copy

Import configuration file

Auth
Request Body
objectobject
ConfigurationFilefile
POST /api/configuration/import
Copy
Responses
200
Response
Copy

Get enabled modules

Auth
GET /api/configuration/enabledModules
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
enabledModulesarray[integer]
Response
Copy

Connector

connector

Auth
Query String
sharePathstring
clientIdstring
GET /api/connector
Copy
Responses
200
filefile
Response
Copy

Deep Cdr

Manage sanitized files

Revert encrypted file

Auth
Path Params
fileIdstring
POST /api/deepcdr/revert/{fileId}
Copy
Responses
200
filefile
Response
Copy

Retrieve external loggers

Auth
GET /api/externallogger
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError

Enum: 0,1,2,3,0,1,2

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entriesarray[object]
idstring
isEnabledboolean
loggerTypeinteger
  • 0: SyslogUdp
  • 1: Kafka

Enum: 0,1

connectionSettings
objectobject
$typestring
Response
Copy

Update external logger state

Auth
Request Body
objectobject
idstring

minLength: 1

isEnabledboolean
PUT /api/externallogger/status
Copy
Responses
200
filefile
Response
Copy

Update a Syslog server configuration

Auth
Request Body
PUT /api/externallogger/udpSyslog
Copy
Responses
200
filefile
Response
Copy

Add a new Syslog server configuration

Auth
Request Body
POST /api/externallogger/udpSyslog
Copy
Responses
200
filefile
Response
Copy

Update a Kafka server configuration

Auth
Request Body
PUT /api/externallogger/kafka
Copy
Responses
200
filefile
Response
Copy

Add a new Kafka server configuration

Auth
Request Body
POST /api/externallogger/kafka
Copy
Responses
200
filefile
Response
Copy

Delete external logger

Auth
Path Params
idstring
DELETE /api/externallogger/{id}
Copy
Responses
200
filefile
Response
Copy

Scan a file on demand

This request is used to update a scanned file with passwords, in case it is an encrypted archive andit could not be scanned because the passwords to decrypt it were not provided. It can also be used withoutproviding any passwords to simply rescan a specific file from a finished scan.

Auth
Request Body
objectobject
fileIdstring

minLength: 1

scanIdstring

minLength: 1

storageProtocolTypeint32
passwordsarray[string]
PUT /api/file
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Fetch processing results for a file

File processing is done asynchronously and each analysis request is tracked by a file ID. Because processing a file is a potentially time-consuming operation, scheduling a file for processing and retrieving the results needs to be done using two separate API calls.

This request needs to be made multiple times until the analysis is complete. Analysis completion can be tracked using the processingState and the progress values from the response..

Auth
Path Params
fileIdstring
GET /api/file/{fileId}
Copy
Responses
200
Response
Copy

Enumerate processed files

Auth
Path Params
scanIdstring
startIndexstring
countstring
Query String
sorting_orderstring
searchstring
resultinteger

Enum: 0,1,2,3,4

startDatestring
endDatestring
scanWorkflowSnapshotIdstring
GET /api/file/{scanId}/{startIndex}/{count}
Copy
Responses
200
Response
Copy

Fetch all groups

Auth
GET /api/group
Copy
Responses
200

Add a group

Auth
Request Body
objectobject
namestring

minLength: 1

descriptionstring
storageIdsarray[string]
POST /api/group
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
group
objectobject
idstring
namestring
descriptionstring
storageIdsarray[string]
Response
Copy

Update a group

Auth
Request Body
objectobject
namestring
descriptionstring
groupIdstring

minLength: 1

PATCH /api/group
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
updatedGroup
objectobject
namestring
descriptionstring
Response
Copy

Fetch group by ID

Auth
Path Params
groupIdstring
GET /api/group/{groupId}
Copy
Responses
200

Delete a group

Auth
Path Params
groupIdstring
DELETE /api/group/{groupId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
groupIdstring
Response
Copy

Fetch the number of groups

Auth
GET /api/group/count
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
groupCount
objectobject
countint64
Response
Copy

Health Status

API that responds with 200 OK if application is running.

Get health status

Auth
Query String
verboseboolean
GET /api/health
Copy
Responses
200
objectobject
apiStatusstring
Response
Copy

Fetch onboarding configuration

Auth
Query String
newConfigSetupboolean
GET /api/onboarding
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
hasUserConfiguredboolean
hasStorageConfiguredboolean
hasScanInstanceConfiguredboolean
isOnboardingDoneboolean
isEulaAgreedboolean
isCloudTypeboolean
Response
Copy

Finish onboarding

Auth
POST /api/onboarding
Copy
Responses
200
filefile
Response
Copy

Accept Eula

Auth
POST /api/onboarding/eula
Copy
Responses
200
filefile
Response
Copy

Report

Generate reports

Get scans report

Auth
Query String
storageIdstring
namestring
scanTypesFilterarray

Enum: 0,1,2

scanStatesFilterarray

Enum: 0,1,2,3,4

startDatestring
endDatestring
sortDirectionFilter
startIndexinteger
countinteger
GET /api/report
Copy
Responses
200

Get scan by ID

Auth
Path Params
scanIdstring
GET /api/scan/{scanId}
Copy
Responses
200

Get scan by ID with information regarding the previous and next scan

Auth
Path Params
scanIdstring
Query String
scanTypesFilterarray

Enum: 0,1,2

scanStatesFilterarray

Enum: 0,1,2,3,4

GET /api/scan/sequence/{scanId}
Copy
Responses
200

Start a scan

To scan a specific folder using the optional Folder parameter, provide the absolute folder path: For Amazon S3 / S3 Compatible Types, Azure Blob, Azure Files, and Google Cloud: Including the Folder Location integrated in MDSS and excluding the Bucket Name, Container, etc. For Box: With or without the "All Files" folder For Sharepoint and Onedrive: Excluding the Document Library, Site, or Group For SMB amd SFTP: Including the whole Sharepath (address, root folder) For NFS: Including the Mount directory

Auth
Request Body
objectobject
storageIdstring

Deprecated

namestring

minLength: 1

folderstring
storageIdsarray[string]
workflowIdstring

minLength: 1

scanConfigurationIdstring
POST /api/scan/start
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
scanIdstring
scanIdsarray[string]
Response
Copy

Stop a scan

Auth
Path Params
scanIdstring
POST /api/scan/stop/{scanId}
Copy
Responses
200
filefile
Response
Copy

Get next scheduled scan

Auth
Path Params
storageIdstring
GET /api/scan/scheduled/{storageId}
Copy
Responses
200
Response
Copy

Delete scans

Auth
Path Params
storageIdstring
Request Body
arrayarray[string]
DELETE /api/scan/{storageId}
Copy
Responses
200

Get Scan Instances

Auth
Query String
scanPoolIdstring
GET /api/scaninstance
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entriesarray[object]
idstring
scanPoolIdstring
urlstring
apiKeystring
timeoutstring
scanInstanceTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

Response
Copy

Update an existing Scan Instance

Auth
Request Body
objectobject
idstring

minLength: 1

urlstring

pattern: ^((?!(^((https?):\/\/)?127(?:\.[0-9]+){0,2}\.[0-9]+(:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)|(^((https?):\/\/)?\[(?:0*\:)*?:?0*1\](:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)).)*$

apiKeystring
timeoutstring
PUT /api/scaninstance
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Add a new Scan Instance

Auth
Request Body
objectobject
scanPoolIdstring

minLength: 1

urlstring

minLength: 1

pattern: ^((?!(^((https?):\/\/)?127(?:\.[0-9]+){0,2}\.[0-9]+(:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)|(^((https?):\/\/)?\[(?:0*\:)*?:?0*1\](:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)).)*$

apiKeystring
timeoutstring
scanInstanceTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

POST /api/scaninstance
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
scanInstanceIdstring
Response
Copy

Get Scan Instance by ID

Auth
Path Params
idstring
GET /api/scaninstance/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entry
objectobject
idstring
scanPoolIdstring
urlstring
apiKeystring
timeoutstring
scanInstanceTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

Response
Copy

Delete a Scan Instance

Auth
Path Params
idstring
DELETE /api/scaninstance/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Test

Auth
Request Body
objectobject
urlstring

minLength: 1

rulesarray[string]
apiKeystring
userAgentstring
POST /api/scaninstance/Test
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Get Scan Pools

Auth
GET /api/scanpool
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entriesarray[object]
idstring
namestring
scanPoolTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

isDefaultboolean
scanInstancesarray[object]
idstring
scanPoolIdstring
urlstring
apiKeystring
timeoutstring
scanInstanceTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

Response
Copy

Update an existing Scan Pool

Auth
Request Body
objectobject
idstring

minLength: 1

namestring

maxLength: 30

minLength: 3

PUT /api/scanpool
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Add a new Scan Pool

Auth
Request Body
objectobject
namestring

maxLength: 30

minLength: 3

scanPoolTypeinteger
  • 0: MdCore
  • 1: MdCloud

Enum: 0,1

POST /api/scanpool
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
scanPoolIdstring
Response
Copy

Get Scan Pool by ID

Auth
Path Params
idstring
GET /api/scanpool/{id}
Copy
Responses
200
Response
Copy

Delete a Scan Pool

Auth
Path Params
idstring
DELETE /api/scanpool/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Scan Workflow Snapshot

List scan workflow snapshots

Get all scan workflow snapshots by scan ID

Auth
Path Params
scanIdstring
GET /api/scanworkflowsnapshot/getAllFromScan/{scanId}
Copy
Responses
200

Fetch storage security checklist

Auth
Path Params
storageIdstring
GET /api/security-checklist/{storageId}
Copy
Responses
200
Response
Copy

Fetch security checklist details

Auth
Path Params
storageIdstring
GET /api/security-checklist/{storageId}/info
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: FailedToRetrieveSecurityChecklist

Enum: 0,1,2,3,0,1

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
scorenumber
resolvedItemsCountint32
enabledItemsCountint32
isEnabledboolean
Response
Copy

Update security checklist item

Auth
Path Params
storageIdstring
Request Body
objectobject
idstring

minLength: 1

isEnabledboolean
PUT /api/security-checklist/{storageId}/item
Copy
Responses
200
Response
Copy

Verify the security checklist for storage

Auth
Path Params
storageIdstring
PUT /api/security-checklist/{storageId}/verify
Copy
Responses
200

Enable/Disable the security checklist

Auth
Request Body
objectobject
storageIdstring

minLength: 1

isEnabledboolean
PATCH /api/security-checklist
Copy
Responses
200

Enable all security checklist items

Auth
Path Params
storageIdstring
PUT /api/security-checklist/{storageId}/enable-all
Copy
Responses
200

Get notifications configuration

Auth
GET /api/settings/notifications
Copy
Responses
200
Response
Copy

Update notifications configuration

Auth
Request Body
PUT /api/settings/notifications
Copy
Responses
200

Fetch SMTP configuration

Auth
GET /api/settings/smtp
Copy
Responses
200
objectobject
hoststring
portint32
baseUrlstring
senderAddressstring
senderNamestring

maxLength: 320

domainstring
usernamestring
passwordstring
secureSocketOption
integerinteger
  • 0: None
  • 1: Auto
  • 2: SslOnConnect
  • 3: StartTls
  • 4: StartTlsWhenAvailable

Enum: 0,1,2,3,4

ignoreCertWarningsboolean
isSmtpEnabledboolean
Response
Copy

Update SMTP configuration

Auth
Request Body
objectobject
hoststring
portint32
baseUrlstring
senderAddressstring
senderNamestring

maxLength: 320

domainstring
usernamestring
passwordstring
secureSocketOption
integerinteger
  • 0: None
  • 1: Auto
  • 2: SslOnConnect
  • 3: StartTls
  • 4: StartTlsWhenAvailable

Enum: 0,1,2,3,4

ignoreCertWarningsboolean
isSmtpEnabledboolean
PATCH /api/settings/smtp
Copy
Responses
200
Response
Copy

Online license activation

Auth
Request Body
objectobject
keystring

minLength: 1

POST /api/settings/admin/license/activate/online
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Offline license activation

Auth
Request Body
objectobject
LicenseContentfile
POST /api/settings/admin/license/activate/offline
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Get license details

Auth
GET /api/settings/admin/license
Copy
Responses
200
objectobject
apiStatusstring
Response
Copy

Deactivate license

Auth
POST /api/settings/admin/license/deactivate
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Fetch retention configuration

Auth
GET /api/settings/retention
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: NotFound

Enum: 0,1,2,3,0,1

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
retentionAuditDaysint32
reportRetentionConfiguration
objectobject
isEnabledboolean
retentionDaysint32
rtpHistoryRetentionConfiguration
objectobject
isEnabledboolean
retentionDaysint32
Response
Copy

Update retention configuration

Auth
Request Body
objectobject
retentionAuditDaysint32

maximum: 50000

minimum: 1

reportRetentionobject
isEnabledboolean
retentionDaysint32

maximum: 50000

minimum: 1

rtpHistoryRetentionobject
isEnabledboolean
retentionDaysint32

maximum: 50000

minimum: 1

PUT /api/settings/retention
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Sso

Sso Authentication and Sso configuration update

Get Sso Configuration

Auth
GET /api/sso/config
Copy
Responses
200
Response
Copy

Update Sso Configuration

Auth
Request Body
objectobject
clientIdstring

maxLength: 255

clientSecretstring

maxLength: 255

authoritystring

maxLength: 255

baseUrlstring

maxLength: 255

identityProviderCertificateobject
contentstring
identityProviderIssuerstring

maxLength: 255

identityProviderLoginUrlstring

maxLength: 255

identityProviderLogoutUrlstring

maxLength: 255

isEnabledboolean
ssoTypeint32
ssoProviderint32
administratorRoleNamestring

maxLength: 63

readonlyRoleNamestring

maxLength: 63

PATCH /api/sso
Copy
Responses
200
Response
Copy

Fetch all storage units

Auth
GET /api/storage/all
Copy
Responses
200

Fetch storage by ID

Auth
Path Params
storageIdstring
GET /api/storage/{storageId}
Copy
Responses
200

Delete a storage

Auth
Path Params
storageIdstring
DELETE /api/storage/{storageId}
Copy
Responses
200
filefile
Response
Copy

Update a storage

Note! The following are templates for what is expected in the Credentials, CredentialsFile and Source fields. Please provide the correct values for your storage integration instead of null/false

Alibaba Cloud storage units:
Credentials: "{"Endpoint":null,"AccessKeyId":null,"AccessKeySecret":null,"UseRamRole":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

Amazon S3 / S3 Compatible storage units:
Credentials: "{"ServiceUrl":null,"AccessKeyId":null,"SecretAccessKey":null,"RegionEndpoint":null,"AssumeRoleArn":null,"UseIamRole":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

Azure Blob storage units:
Credentials: "{"TenantId":null,"ClientId":null,"ClientSecret":null,"StorageAccount":null}"
Source: "{"Container":null}"

Azure Files storage units:
Credentials: "{"AccountName":null,"AccountKey":null,"ShareName":null}"
Source: "{"FolderLocation":null}"

Box storage units:
CredentialsFile: upload the credentials file
Source: "{"FolderLocation":null}"

Dell Isilon / SMB Compatible storage units:
Credentials: "{"User":null,"Password":null,"Server":null}"
Source: "{"SharePath":null}"

Google Cloud storage units:
CredentialsFile: upload the credentials file
Credentials: "{"UseAdc":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

OneDrive storage units:
Credentials: "{"TenantId":null,"ClientId":null,"ClientSecret":null}"
Source: "{"Group":null}"

Auth
Path Params
storageIdstring
Request Body
objectobject
Namestring
StorageVendorTypestring
StorageProtocolTypestring
CredentialsFilefile
Credentialsstring
Sourcestring
GroupIdstring
AccountIdstring
WorkflowIdstring
PATCH /api/storage/{storageId}
Copy
Responses
200

Fetch storage users

Auth
Path Params
storageIdstring
Query String
filterstring
GET /api/storage/{storageId}/users
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
entriesarray[object]
idstring
fullNamestring
Response
Copy

Add a storage

Note! The following are templates for what is expected in the Credentials, CredentialsFile and Source fields. Please provide the correct values for your storage integration instead of null/false

Alibaba Cloud storage units:
Credentials: "{"Endpoint":null,"AccessKeyId":null,"AccessKeySecret":null,"UseRamRole":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

Amazon S3 / S3 Compatible storage units:
Credentials: "{"ServiceUrl":null,"AccessKeyId":null,"SecretAccessKey":null,"RegionEndpoint":null,"AssumeRoleArn":null,"UseIamRole":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

Azure Blob storage units:
Credentials: "{"TenantId":null,"ClientId":null,"ClientSecret":null,"StorageAccount":null}"
Source: "{"Container":null}"

Azure Files storage units:
Credentials: "{"AccountName":null,"AccountKey":null,"ShareName":null}"
Source: "{"FolderLocation":null}"

Box storage units:
CredentialsFile: upload the credentials file
Source: "{"FolderLocation":null}"

Dell Isilon / SMB Compatible storage units:
Credentials: "{"User":null,"Password":null,"Server":null}"
Source: "{"SharePath":null}"

Google Cloud storage units:
CredentialsFile: upload the credentials file
Credentials: "{"UseAdc":false}"
Source: "{"BucketName":null,"FolderLocation":null}"

OneDrive storage units:
Credentials: "{"TenantId":null,"ClientId":null,"ClientSecret":null}"
Source: "{"Group":null}"

Auth
Request Body
objectobject
Namestring
StorageVendorTypestring
StorageProtocolTypestring
CredentialsFilefile
Credentialsstring
Sourcestring
GroupIdstring
AccountIdstring
WorkflowIdstring
POST /api/storage
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Fetch all storage units by filters (storage type or status)

Auth
Path Params
startIndexstring
countstring
Query String
sortingOrderstring
searchstring
storageTypeinteger
storageStatusinteger
GET /api/storage/enumerate/{startIndex}/{count}
Copy
Responses
200

Update scan configuration

Auth
Path Params
storageIdstring
Request Body
PATCH /api/storage/{storageId}/scan_config
Responses
200
filefile
Response
Copy

Add a scan schedule

Auth
Path Params
storageIdstring
Request Body
PUT /api/storage/{storageId}/scan_schedule
Copy
Responses
200
filefile
Response
Copy

Update a scan schedule

Auth
Path Params
storageIdstring
Request Body
PUT /api/storage/scan_schedule/update/{storageId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Fetch scan schedules

Auth
Path Params
storageIdstring
sortDirectioninteger

Enum: 0,1

startIndexinteger
countinteger
Query String
namestring
userstring
typestring
GET /api/storage/scan_schedules/{storageId}/{sortDirection}/{startIndex}/{count}
Copy
Responses
200
Response
Copy

Delete scan schedules

Auth
Request Body
arrayarray[string]
DELETE /api/storage/scan_schedule
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: FailedInvalidListOfIds

Enum: 0,1,2,3,0,1

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
areAllDeletedboolean
Response
Copy

Retrieve storage user name

Auth
Path Params
storageIdstring
userIdstring
GET /api/storage/{storageId}/{userId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
userNamestring
Response
Copy

Fetch active users

Auth
Headers
searchTermstring
Path Params
startIndexstring
countstring
GET /api/user/active/{startIndex}/{count}
Copy
Responses
200
objectobject
entriesarray[object]
idstring
userNamestring
fullNamestring
emailstring
roleinteger
  • 0: None
  • 1: ReadOnlyAdministrator
  • 2: Administrator
  • 4: SsoAdministrator
  • 5: SsoReadOnlyAdministrator
  • 6: TenantAdministrator

Enum: 0,1,2,4,5,6

totalCountint64
Response
Copy

Register a user

Auth
Request Body
objectobject
fullNamestring

minLength: 1

userNamestring

minLength: 1

passwordstring

minLength: 1

emailstring

minLength: 1

POST /api/user/register
Copy
Responses
200
filefile
Response
Copy

Create a user

Auth
Request Body
objectobject
fullNamestring

minLength: 1

userNamestring

minLength: 1

passwordstring

minLength: 1

emailstring

minLength: 1

roleinteger
  • 0: None
  • 1: ReadOnlyAdministrator
  • 2: Administrator
  • 4: SsoAdministrator
  • 5: SsoReadOnlyAdministrator
  • 6: TenantAdministrator

Enum: 0,1,2,4,5,6

POST /api/user/create
Copy
Responses
200
filefile
Response
Copy

Authenticate with a username and password

Authenticate with a username and password to obtain a JWT token,Most of the APIs require authentication in the form of providing a JWT token. Call this API in order to receive a token but please note that it's only valid for an hour so it should be periodically refreshed.

Auth
Request Body
objectobject
userNamestring

minLength: 1

passwordstring

minLength: 1

POST /api/user/authenticate
Copy
Responses
200
Response
Copy

Refresh user token

Auth
Request Body
objectobject
accessTokenstring

minLength: 1

refreshTokenstring

minLength: 1

POST /api/user/refreshToken
Copy
Responses
200
filefile
Response
Copy

Logout

Auth
POST /api/user/logout
Copy
Responses
200
filefile
Response
Copy

Update user role

Auth
Request Body
objectobject
userIdstring

minLength: 1

roleinteger
  • 0: None
  • 1: ReadOnlyAdministrator
  • 2: Administrator
  • 4: SsoAdministrator
  • 5: SsoReadOnlyAdministrator
  • 6: TenantAdministrator

Enum: 0,1,2,4,5,6

PUT /api/user/role
Copy
Responses
200
Response
Copy

Fetch users

Auth
GET /api/user/requests
Copy
Responses
200
objectobject
entriesarray[object]
idstring
userNamestring
fullNamestring
emailstring
roleinteger
  • 0: None
  • 1: ReadOnlyAdministrator
  • 2: Administrator
  • 4: SsoAdministrator
  • 5: SsoReadOnlyAdministrator
  • 6: TenantAdministrator

Enum: 0,1,2,4,5,6

totalCountint64
Response
Copy

Delete a user

Auth
Path Params
userIdstring
DELETE /api/user/{userId}
Copy
Responses
200
Response
Copy

Update a user

Auth
Request Body
objectobject
userIdstring
roleinteger
  • 0: None
  • 1: ReadOnlyAdministrator
  • 2: Administrator
  • 4: SsoAdministrator
  • 5: SsoReadOnlyAdministrator
  • 6: TenantAdministrator

Enum: 0,1,2,4,5,6

userNamestring
fullNamestring
currentPasswordstring
newPasswordstring
emailstring
PUT /api/user
Copy
Responses
200
Response
Copy

Request password reset

Auth
Request Body
objectobject
userInputstring

minLength: 1

POST /api/user/password/reset
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: FailedSmtpNotEnabled

Enum: 0,1,2,3,0,1

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Reset user password

Auth
Request Body
objectobject
newPasswordstring

minLength: 12

newPasswordConfirmationstring

minLength: 12

secureTokenstring
POST /api/user/password
Copy
Responses
200
Response
Copy

Object event trigger of real time processing

This endpoint takes the parameters and tries to find the file in the specified storage and applies the scan configuration for the specified file

Auth
Request Body
objectobject
metadatastring

minLength: 1

storageClientIdstring

minLength: 1

POST /api/webhook/realtime
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Failed
  • 2: NotFound

Enum: 0,1,2,3,0,1,2

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
correlationIdstring
400
404
Response
Copy

Object event trigger of real time processing by storage client ID

This endpoint takes the parameter and tries to find the file in the specified storage and applies the scan configuration for the specified file

Auth
Path Params
storageClientIdstring
Request Body
No request body
POST /api/webhook/realtime/{storageClientId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Failed
  • 2: NotFound

Enum: 0,1,2,3,0,1,2

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
correlationIdstring
400
404
Response
Copy

Get Scan Configurations

Auth
GET /api/workflow
Copy
Responses
200

Add a new Scan Configuration

Auth
Request Body
objectobject
scanPoolIdstring

minLength: 1

rulesarray[string]
namestring

maxLength: 30

minLength: 3

userAgentstring
failOverScanPoolIdstring
filtersobject
minimumSizeint64
maximumSizeint64
minimumDateTimedate-time
maximumDateTimedate-time
POST /api/workflow
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
workflowIdstring
Response
Copy

Update an existing Scan Configuration

Auth
Request Body
objectobject
idstring

minLength: 1

scanPoolIdstring
rulesarray[string]
namestring

maxLength: 30

minLength: 3

userAgentstring
failOverScanPoolIdstring
failOverDisabledboolean
filters
objectobject
minimumSizeint64
maximumSizeint64
minimumDateTimedate-time
maximumDateTimedate-time
PATCH /api/workflow
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Get Scan Configuration by ID

Auth
Path Params
idstring
GET /api/workflow/{id}
Copy
Responses
200

Delete a Scan Configuration

Auth
Path Params
idstring
DELETE /api/workflow/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Set a Scan Configuration as default

Auth
Path Params
idstring
POST /api/workflow/setDefault/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Deprecated, soon to be removedDeprecated

Fetch MetaDefender Core Pools

Auth
GET /api/corepool
Copy
Responses
200
Response
Copy

Deprecated, soon to be removedDeprecated

Update an existing MetaDefender Core Pool

Auth
Request Body
objectobject

Deprecated

idstring

minLength: 1

namestring

maxLength: 30

minLength: 3

PUT /api/corepool
Copy
Responses
200
filefile
Response
Copy

Deprecated, soon to be removedDeprecated

Add a new MetaDefender Core Pool

Auth
Request Body
objectobject

Deprecated

namestring

maxLength: 30

minLength: 3

POST /api/corepool
Copy
Responses
200
filefile
Response
Copy

Deprecated, soon to be removedDeprecated

Get MetaDefender Core Pool by ID

Auth
Path Params
corePoolIdstring
GET /api/corepool/{corePoolId}
Copy
Responses
200
Response
Copy

Deprecated, soon to be removedDeprecated

Delete MetaDefender Core Pool

Auth
Path Params
idstring
DELETE /api/corepool/{id}
Copy
Responses
200
filefile
Response
Copy

Deprecated, soon to be removedDeprecated

Fetch MetaDefender Core servers

Auth
Query String
corePoolIdstring
GET /api/metadefendercore
Copy
Responses
200
objectobject

Deprecated

entriesarray[object]
idstring
urlstring
ipstring
apiKeystring
timeoutstring
userAgentstring
workflowRulestring
displayNamestring
Response
Copy

Deprecated, soon to be removedDeprecated

Update MetaDefender Core server

Auth
Request Body
objectobject

Deprecated

idstring
urlstring

minLength: 1

pattern: ^((?!(^((https?):\/\/)?127(?:\.[0-9]+){0,2}\.[0-9]+(:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)|(^((https?):\/\/)?\[(?:0*\:)*?:?0*1\](:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)).)*$

apiKeystring
timeoutstring
userAgentstring
workflowRulestring
corePoolIdstring
PUT /api/metadefendercore
Copy
Responses
200
filefile
Response
Copy

Deprecated, soon to be removedDeprecated

Add a new MetaDefender Core Server

Auth
Request Body
objectobject

Deprecated

idstring
urlstring

minLength: 1

pattern: ^((?!(^((https?):\/\/)?127(?:\.[0-9]+){0,2}\.[0-9]+(:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)|(^((https?):\/\/)?\[(?:0*\:)*?:?0*1\](:(6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]|[1-5][0-9]{4}|[1-9][0-9]{0,3})?)?$)).)*$

apiKeystring
timeoutstring
userAgentstring
workflowRulestring
corePoolIdstring
POST /api/metadefendercore
Copy
Responses
200
filefile
Response
Copy

Deprecated, soon to be removedDeprecated

Get MetaDefender Core server by ID

Auth
Path Params
metaDefenderIdstring
GET /api/metadefendercore/{metaDefenderId}
Copy
Responses
200
objectobject

Deprecated

idstring
urlstring
ipstring
apiKeystring
timeoutstring
userAgentstring
workflowRulestring
displayNamestring
Response
Copy

Deprecated, soon to be removedDeprecated

Delete MetaDefender Core server

Auth
Path Params
metaDefenderIdstring
DELETE /api/metadefendercore/{metaDefenderId}
Copy
Responses
200
filefile
Response
Copy

(Deprecated - use /workflow) Get Scan ConfigurationsDeprecated

Auth
GET /api/scanconfiguration
Copy
Responses
200

(Deprecated - use /workflow) Add a new Scan ConfigurationDeprecated

Auth
Request Body
objectobject
scanPoolIdstring

minLength: 1

rulesarray[string]
namestring

maxLength: 30

minLength: 3

userAgentstring
failOverScanPoolIdstring
POST /api/scanconfiguration
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
scanConfigurationIdstring
Response
Copy

(Deprecated - use /workflow) Update an existing Scan ConfigurationDeprecated

Auth
Request Body
objectobject
idstring

minLength: 1

scanPoolIdstring
rulesarray[string]
namestring

maxLength: 30

minLength: 3

userAgentstring
failOverScanPoolIdstring
failOverDisabledboolean
PATCH /api/scanconfiguration
Copy
Responses
200
objectobject

Deprecated

resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

(Deprecated - use /workflow) Get Scan Configuration by IDDeprecated

Auth
Path Params
idstring
GET /api/scanconfiguration/{id}
Copy
Responses
200

(Deprecated - use /workflow) Delete a Scan ConfigurationDeprecated

Auth
Path Params
idstring
DELETE /api/scanconfiguration/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

(Deprecated - use /workflow) Set a Scan Configuration as defaultDeprecated

Auth
Path Params
idstring
POST /api/scanconfiguration/setDefault/{id}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated) Get an active scan by scan ID and file ID

Auth
Path Params
scanIdstring
activeFileIdstring
GET /api/scan/active/{scanId}/{activeFileId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated) Get Real-Time scan

Auth
Path Params
storageIdstring
GET /api/scan/realtime/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated) Fetch last completed scan

Auth
Path Params
storageIdstring
GET /api/scan/last_completed/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an Amazon S3 storage

Auth
Request Body
POST /api/storage/amazons3
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an Amazon S3 storage

Auth
Path Params
storageIdstring
Request Body
PATCH /api/storage/amazons3/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an One Drive storage

Auth
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
tenantIdstring

maxLength: 36

minLength: 36

clientIdstring

maxLength: 36

minLength: 36

clientSecretstring

maxLength: 50

minLength: 1

groupstring
POST /api/storage/onedrive
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an One Drive storage

Auth
Path Params
storageIdstring
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
tenantIdstring

maxLength: 36

minLength: 36

clientIdstring

maxLength: 36

minLength: 36

clientSecretstring

maxLength: 50

minLength: 1

groupstring
PATCH /api/storage/onedrive/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add a Box storage

Auth
Request Body
objectobject
Credentialsfile
UserNamestring
FolderPathstring
GroupNamestring
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
POST /api/storage/box
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update a Box storage

Auth
Path Params
storageIdstring
Request Body
objectobject
Credentialsfile
UserNamestring
FolderPathstring
GroupNamestring
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
PATCH /api/storage/box/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add Dell Isilon/SMB Compatibile

Auth
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
storageVendorTypeinteger
  • 0: AmazonS3
  • 1: OneDrive
  • 2: Box
  • 3: DellIsilon
  • 4: AzureFiles
  • 5: SmbCompatible
  • 6: S3Compatible
  • 7: AzureBlob
  • 8: AlibabaCloud
  • 9: GoogleCloud
  • 10: Sftp
  • 11: SharePoint
  • 12: Nfs
  • 13: Wasabi
  • 14: OracleCloud
  • 15: NetAppOntap
  • 16: Cubbit
  • 17: Mft
  • 18: SharepointOnPrem

Enum: 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18

userstring

minLength: 1

passwordstring

minLength: 1

sharePathstring

minLength: 1

POST /api/storage/smb
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update a Dell Isilon/SMB Compatibile

Auth
Path Params
storageIdstring
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
storageVendorTypeinteger
  • 0: AmazonS3
  • 1: OneDrive
  • 2: Box
  • 3: DellIsilon
  • 4: AzureFiles
  • 5: SmbCompatible
  • 6: S3Compatible
  • 7: AzureBlob
  • 8: AlibabaCloud
  • 9: GoogleCloud
  • 10: Sftp
  • 11: SharePoint
  • 12: Nfs
  • 13: Wasabi
  • 14: OracleCloud
  • 15: NetAppOntap
  • 16: Cubbit
  • 17: Mft
  • 18: SharepointOnPrem

Enum: 0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18

userstring

minLength: 1

passwordstring

minLength: 1

sharePathstring

minLength: 1

PATCH /api/storage/smb/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an Azure Blob storage

Auth
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
tenantIdstring

maxLength: 36

minLength: 36

storageAccountstring

maxLength: 24

minLength: 3

clientIdstring

maxLength: 36

minLength: 36

clientSecretstring

maxLength: 50

minLength: 1

containerstring

maxLength: 63

minLength: 0

cloudTypestring

maxLength: 63

minLength: 0

POST /api/storage/azureblob
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an Azure Blob storage

Auth
Path Params
storageIdstring
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
tenantIdstring

maxLength: 36

minLength: 36

storageAccountstring

maxLength: 24

minLength: 3

clientIdstring

maxLength: 36

minLength: 36

clientSecretstring

maxLength: 50

minLength: 1

containerstring

maxLength: 63

minLength: 0

cloudTypestring

maxLength: 63

minLength: 0

PATCH /api/storage/azureblob/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an Alibaba Cloud storage

Auth
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
endpointstring

minLength: 1

accessKeyIdstring
accessKeySecretstring
bucketNamestring

minLength: 1

folderLocationstring
useRamRoleboolean
POST /api/storage/alibabacloud
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an Alibaba Cloud storage

Auth
Path Params
storageIdstring
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
endpointstring

minLength: 1

accessKeyIdstring
accessKeySecretstring
bucketNamestring

minLength: 1

folderLocationstring
useRamRoleboolean
PATCH /api/storage/alibabacloud/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add a Google Cloud storage

Auth
Request Body
objectobject
Credentialsfile
BucketNamestring
FolderLocationstring
UseAdcboolean
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
POST /api/storage/googlecloud
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update a Google Cloud storage

Auth
Path Params
storageIdstring
Request Body
objectobject
Credentialsfile
BucketNamestring
FolderLocationstring
UseAdcboolean
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
PATCH /api/storage/googlecloud/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an Azure Files storage

Auth
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
accountNamestring

minLength: 1

accountKeystring

minLength: 1

shareNamestring

minLength: 1

folderLocationstring
POST /api/storage/azurefiles
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an Azure Files storage

Auth
Path Params
storageIdstring
Request Body
objectobject
namestring

maxLength: 60

minLength: 1

groupIdstring
accountIdstring
workflowIdstring
accountNamestring

minLength: 1

accountKeystring

minLength: 1

shareNamestring

minLength: 1

folderLocationstring
PATCH /api/storage/azurefiles/{storageId}
Copy
Responses
200

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage) Add an Mft storage

Auth
Request Body
ServiceUrlstring
ApiKeystring
ScanUsersstring
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
POST /api/storage/mft
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: Error
  • 2: InternalError
  • 3: NotFound

Enum: 0,1,2,3

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
storageIdstring
Response
Copy

Deprecated, soon to be removedDeprecated

(Deprecated - use /storage/{storageId}) Update an Mft storage

Auth
Path Params
storageIdstring
Request Body
ServiceUrlstring
ApiKeystring
ScanUsersstring
Namestring
GroupIdstring
AccountIdstring
WorkflowIdstring
PATCH /api/storage/mft/{storageId}
Copy
Responses
200

Delete scan schedulesDeprecated

Auth
Path Params
storageIdstring
Request Body
arrayarray[string]
DELETE /api/storage/scan_schedule/{storageId}
Copy
Responses
200
objectobject
resultinteger
  • 0: Success
  • 1: FailedInvalidListOfIds

Enum: 0,1,2,3,0,1

responseKeystring
responseMessagestring
responseMessageParamsobject
*string
success
RestResponseRestResponse
error
RestResponseRestResponse
areAllDeletedboolean
Response
Copy