MetaDefender Software Supply Chain API 3.0.0 3.0.0

/api/v1/audit

List audit events

Auth

Query String

Start	string	pattern: `^[0-9]*$`
Count	string	pattern: `^[0-9]*$`
LogType	string	Enum: `FileDiscovered`,`FileScanned`,`FileDiscoveryFailed`,`ProcessStarted`,`ProcessCompleted`,`ProcessCancelled`,`ProcessFailed`,`ServiceAdded`,`ServiceUpdated`,`ServiceRemoved`,`LoggedIn`,`LoggedOut`,`UserCreated`,`UserRegistered`,`UserRoleUpdated`,`UserUpdated`,`UserRemoved`,`ScanInstanceAdd`,`ScanInstanceUpdate`,`ScanInstanceDelete`,`ScanInstanceImport`,`ScanPoolAdd`,`ScanPoolUpdate`,`ScanPoolDelete`,`ScanPoolImport`,`OnlineLicenseActivated`,`OfflineLicenseActivated`,`LicenseDeactivated`,`ConfigurationImported`,`ConfigurationExported`,`Notifications`,`Smtp`,`ExternalLoggerAdd`,`ExternalLoggerUpdate`,`ExternalLoggerDelete`,`DataRetention`,`ApiKeyAdd`,`ApiKeyUpdate`,`ApiKeyDelete`,`ScanConfigurationAdd`,`ScanConfigurationUpdate`,`ScanConfigurationDelete`,`ScanConfigurationSetDefault`,`ScanConfigurationImport`,`ScanAdd`,`ScanUpdate`,`ScanDelete`,`Other`
CategoryType	string	Enum: `Processes`,`Remediations`,`ServiceUnits`,`Authentication`,`Settings`,`Users`,`Notifications`,`Other`
LogLevel	string	Enum: `Debug`,`Info`,`Warn`,`Error`
SearchText	string

GET /api/v1/audit

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/audit' \ --header 'Authorization: Bearer {token}' \ --data Start={Start} \ --data Count={Count} \ --data LogType={LogType} \ --data CategoryType={CategoryType} \ --data LogLevel={LogLevel} \ --data SearchText={SearchText}
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Entries	array[object]	Because it belongs to a response, if RetrieveLogs breaks, we won't have Entries and TotalCount.
Id	string
Level	string	Enum: `Debug`,`Info`,`Warn`,`Error`
Properties	object
LogType	string	Enum: `FileDiscovered`,`FileScanned`,`FileDiscoveryFailed`,`ProcessStarted`,`ProcessCompleted`,`ProcessCancelled`,`ProcessFailed`,`ServiceAdded`,`ServiceUpdated`,`ServiceRemoved`,`LoggedIn`,`LoggedOut`,`UserCreated`,`UserRegistered`,`UserRoleUpdated`,`UserUpdated`,`UserRemoved`,`ScanInstanceAdd`,`ScanInstanceUpdate`,`ScanInstanceDelete`,`ScanInstanceImport`,`ScanPoolAdd`,`ScanPoolUpdate`,`ScanPoolDelete`,`ScanPoolImport`,`OnlineLicenseActivated`,`OfflineLicenseActivated`,`LicenseDeactivated`,`ConfigurationImported`,`ConfigurationExported`,`Notifications`,`Smtp`,`ExternalLoggerAdd`,`ExternalLoggerUpdate`,`ExternalLoggerDelete`,`DataRetention`,`ApiKeyAdd`,`ApiKeyUpdate`,`ApiKeyDelete`,`ScanConfigurationAdd`,`ScanConfigurationUpdate`,`ScanConfigurationDelete`,`ScanConfigurationSetDefault`,`ScanConfigurationImport`,`ScanAdd`,`ScanUpdate`,`ScanDelete`,`Other`
Category	string	Enum: `Processes`,`Remediations`,`ServiceUnits`,`Authentication`,`Settings`,`Users`,`Notifications`,`Other`
EventTimestamp	date-time
UserId	string
UserName	string
RenderedMessage	string
TotalCount	int64

Expand

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Entries": [  {   "Id": "{string}",   "Level": "{string}",   "Properties": {    "LogType": "{string}",    "Category": "{string}",    "EventTimestamp": "{date-time}",    "UserId": "{string}",    "UserName": "{string}"   },   "RenderedMessage": "{string}"  } ], "TotalCount": "{int64}"}
Copy

Export

Export scan results

/api/v1/export/cyclonedx/{repoId}

/api/v1/export/pdf/all-scans

/api/v1/export/pdf/overview/{scanId}

/api/v1/export/pdf/sbom/{scanId}

Export a CycloneDX report for repository

Auth

Path Params

repoId string

Query String

Reference string

GET /api/v1/export/cyclonedx/{repoId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/export/cyclonedx/%7BrepoId%7D' \ --header 'Authorization: Bearer {token}' \ --data Reference={Reference}
Copy

Responses

200

Success

file file

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "schema": "{file}"}
Copy

Export a PDF report for all scans

Auth

Query String

ProductAddress	string
Type	array	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
TimeFrame	string	Enum: `OneDay`,`TwoDays`,`ThreeDays`
Vulnerabilities	array	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
LicenseRisks	array
Status	array	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
TriggerEvent	array
Workflow	string
Connection	string
Secrets	boolean
Threats	boolean
Search	string
ConnectionType	string	Enum: `Unknown`,`SourceCode`,`Container`,`Binary`

GET /api/v1/export/pdf/all-scans

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/export/pdf/all-scans' \ --header 'Authorization: Bearer {token}' \ --data ProductAddress={ProductAddress} \ --data Type={Type} \ --data TimeFrame={TimeFrame} \ --data Vulnerabilities={Vulnerabilities} \ --data LicenseRisks={LicenseRisks} \ --data Status={Status} \ --data TriggerEvent={TriggerEvent} \ --data Workflow={Workflow} \ --data Connection={Connection} \ --data Secrets={Secrets} \ --data Threats={Threats} \ --data Search={Search} \ --data ConnectionType={ConnectionType}
Copy

Responses

200

Success

file file

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "schema": "{file}"}
Copy

Export a PDF Overview report for repository

Auth

Path Params

scanId string

Query String

ProductAddress string

GET /api/v1/export/pdf/overview/{scanId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/export/pdf/overview/%7BscanId%7D' \ --header 'Authorization: Bearer {token}' \ --data ProductAddress={ProductAddress}
Copy

Responses

200

Success

file file

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "schema": "{file}"}
Copy

Export a PDF SBOM report for repository

Auth

Path Params

scanId string

Query String

ProductAddress string

GET /api/v1/export/pdf/sbom/{scanId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/export/pdf/sbom/%7BscanId%7D' \ --header 'Authorization: Bearer {token}' \ --data ProductAddress={ProductAddress}
Copy

Responses

200

Success

file file

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "schema": "{file}"}
Copy

External Logger

Manage your External Loggers

/api/v1/externallogger

/api/v1/externallogger

/api/v1/externallogger/{id}

/api/v1/externallogger/{id}

Get all configured External Loggers

Auth

GET /api/v1/externallogger

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/externallogger' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Add a new External Logger

Auth

Request Body

object	object
ConnectionSettings	object
ServerAddress	string
Port	int32
Facility	string	Enum: `KernelMessages`,`UserLevelMessages`,`MailSystem`,`SystemDaemons`,`SecurityOrAuthorizationMessages1`,`InternalMessages`,`LinePrinterSubsystem`,`NetworkNewsSubsystem`,`UUCPSubsystem`,`ClockDaemon1`,`SecurityOrAuthorizationMessages2`,`FTPDaemon`,`NTPSubsystem`,`LogAudit`,`LogAlert`,`ClockDaemon2`,`LocalUse0`,`LocalUse1`,`LocalUse2`,`LocalUse3`,`LocalUse4`,`LocalUse5`,`LocalUse6`,`LocalUse7`
Format	string	Enum: `RFC5424`

POST /api/v1/externallogger

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/externallogger' \ --header 'Authorization: Bearer {token}' \ --data '{  "ConnectionSettings": {    "ServerAddress": "{string}",    "Port": "{int32}",    "Facility": "{string}",    "Format": "{string}"  }}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Update an existing External Logger

Auth

Path Params

id string

Request Body

object	object
ConnectionSettings	object
ServerAddress	string
Port	int32
Facility	string	Enum: `KernelMessages`,`UserLevelMessages`,`MailSystem`,`SystemDaemons`,`SecurityOrAuthorizationMessages1`,`InternalMessages`,`LinePrinterSubsystem`,`NetworkNewsSubsystem`,`UUCPSubsystem`,`ClockDaemon1`,`SecurityOrAuthorizationMessages2`,`FTPDaemon`,`NTPSubsystem`,`LogAudit`,`LogAlert`,`ClockDaemon2`,`LocalUse0`,`LocalUse1`,`LocalUse2`,`LocalUse3`,`LocalUse4`,`LocalUse5`,`LocalUse6`,`LocalUse7`
Format	string	Enum: `RFC5424`

PUT /api/v1/externallogger/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/externallogger/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "ConnectionSettings": {    "ServerAddress": "{string}",    "Port": "{int32}",    "Facility": "{string}",    "Format": "{string}"  }}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Delete an External Logger

Auth

Path Params

id string

DELETE /api/v1/externallogger/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/externallogger/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Global Label Keys

Global label keys management

/api/v1/global-label-keys

/api/v1/global-label-keys

/api/v1/global-label-keys/{id}

/api/v1/global-label-keys/{id}

Returns all global label keys

Auth

GET /api/v1/global-label-keys

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/global-label-keys' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
GlobalKeys	array[object]
Id	string
Name	string
Description	string
ValueType	string
Options	array[string]
Created	date-time
Updated	date-time
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "GlobalKeys": [  {   "Id": "{string}",   "Name": "{string}",   "Description": "{string}",   "ValueType": "{string}",   "Options": [    "{array[string]...}"   ],   "Created": "{date-time}",   "Updated": "{date-time}",   "TenantId": "{string}",   "CreatedAt": "{date-time}",   "LastUpdated": "{date-time}"  } ]}
Copy

Adds a new global label key

Auth

Request Body

object	object
Name	string
Description	string
ValueType	string
Options	array[string]

POST /api/v1/global-label-keys

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/global-label-keys' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Description": "{string}",  "ValueType": "{string}",  "Options": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
GlobalKey	object
Id	string
Name	string
Description	string
ValueType	string
Options	array[string]
Created	date-time
Updated	date-time
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "GlobalKey": {  "Id": "{string}",  "Name": "{string}",  "Description": "{string}",  "ValueType": "{string}",  "Options": [   "{array[string]...}"  ],  "Created": "{date-time}",  "Updated": "{date-time}",  "TenantId": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}" }}
Copy

Updates an existing global label key

Auth

Path Params

id string

Request Body

object	object
Name	string
Description	string
ValueType	string
Options	array[string]

PUT /api/v1/global-label-keys/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/global-label-keys/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Description": "{string}",  "ValueType": "{string}",  "Options": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
GlobalKey	object
Id	string
Name	string
Description	string
ValueType	string
Options	array[string]
Created	date-time
Updated	date-time
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "GlobalKey": {  "Id": "{string}",  "Name": "{string}",  "Description": "{string}",  "ValueType": "{string}",  "Options": [   "{array[string]...}"  ],  "Created": "{date-time}",  "Updated": "{date-time}",  "TenantId": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}" }}
Copy

Deletes a global label key

Auth

Path Params

id string

DELETE /api/v1/global-label-keys/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/global-label-keys/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Packages

Package management

/api/v1/packages

/api/v1/packages/versions

/api/v1/packages/{id}

/api/v1/packages/{id}/cves

/api/v1/packages/{id}/labels

/api/v1/packages/{id}/labels

/api/v1/packages/{id}/labels/{key}

/api/v1/packages/{id}/labels/{key}

/api/v1/packages/search/labels

Retrieves a list of packages based on search criteria

Auth

Query String

Name	string
Ecosystem	string
Version	string
Vulnerabilities	array
LicenseRisks	array
Connection	string
Repository	string
Reference	string
ScanId	string
StepSha256	string
Search	string

GET /api/v1/packages

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages' \ --header 'Authorization: Bearer {token}' \ --data Name={Name} \ --data Ecosystem={Ecosystem} \ --data Version={Version} \ --data Vulnerabilities={Vulnerabilities} \ --data LicenseRisks={LicenseRisks} \ --data Connection={Connection} \ --data Repository={Repository} \ --data Reference={Reference} \ --data ScanId={ScanId} \ --data StepSha256={StepSha256} \ --data Search={Search}
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Packages	array[object]
Id	string
Name	string
Version	string
Ecosystem	string
Archive	boolean
Executable	boolean
Uid	string
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Repositories	array[object]
Connection	string
Repository	string
RepositoryId	string
Reference	string
Scanned	date-time
ScanIds	array[string]
StepSha256s	array[string]
Hashes	array[object]
Sha256	string
FileName	string
Vulnerabilities	array[object]
Id	string
FixedVersions	array[string]
Severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
Source	string
Cwes	array[string]
Dependencies	array[object]
Ecosystem	string
Group	string
PackageName	string
PackageVersion	string
Vulnerabilities	array[object]
Id	string
Severity	string
Source	string
FixedVersions	array[string]
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
SupplierName	string
ReleaseDate	date-time
Labels	array[object]
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time
Latest	object
Version	string
ReleaseDate	string
CreatedAt	date-time
LastUpdated	date-time

Expand

Response

xxxxxxxxxx
 
{
 "ResponseKey": "{string}", "ResponseMessage": "{string}", "Packages": [...]
}
Copy

Retrieves all versions of a specific package by its name and ecosystem

Auth

Query String

ecosystem	string
packageName	string

GET /api/v1/packages/versions

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages/versions' \ --header 'Authorization: Bearer {token}' \ --data ecosystem={ecosystem} \ --data packageName={packageName}
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
PackageName	string
Ecosystem	string
Versions	array[object]
Version	string
Vulnerabilities	array[object]
Id	string
FixedVersions	array[string]
Severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
Source	string
Cwes	array[string]
SupplierName	string
ReleaseDate	date-time
Dependencies	array[object]
Ecosystem	string
Group	string
PackageName	string
PackageVersion	string
Vulnerabilities	array[object]
Id	string
Severity	string
Source	string
FixedVersions	array[string]
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]

Expand

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "PackageName": "{string}", "Ecosystem": "{string}", "Versions": [  {   "Version": "{string}",   "Vulnerabilities": [    {     "Id": "{string}",     "FixedVersions": [      "{array[string]...}"     ],     "Severity": "{string}",     "Source": "{string}",     "Cwes": [      "{array[string]...}"     ]    }   ],   "SupplierName": "{string}",   "ReleaseDate": "{date-time}",   "Dependencies": [    {     "Ecosystem": "{string}",     "Group": "{string}",     "PackageName": "{string}",     "PackageVersion": "{string}",     "Vulnerabilities": [      {       "Id": "{string}",       "Severity": "{string}",       "Source": "{string}",       "FixedVersions": [        "{array[string]...}"       ],       "Cwes": [        "{array[string]...}"       ],       "Type": "{string}"      }     ],     "VulnerabilityCounts": {      "Critical": "{int32}",      "High": "{int32}",      "Medium": "{int32}",      "Low": "{int32}",      "Unknown": "{int32}"     }    }   ],   "Licenses": {    "Allowed": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ],    "Blocked": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ]   }  } ]}
Copy

Expand

Retrieves a package by its unique identifier

Auth

Path Params

id string

GET /api/v1/packages/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Package	object
Id	string
Name	string
Version	string
Ecosystem	string
Archive	boolean
Executable	boolean
Uid	string
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Repositories	array[object]
Connection	string
Repository	string
RepositoryId	string
Reference	string
Scanned	date-time
ScanIds	array[string]
StepSha256s	array[string]
Hashes	array[object]
Sha256	string
FileName	string
Vulnerabilities	array[object]
Id	string
FixedVersions	array[string]
Severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
Source	string
Cwes	array[string]
Dependencies	array[object]
Ecosystem	string
Group	string
PackageName	string
PackageVersion	string
Vulnerabilities	array[object]
Id	string
Severity	string
Source	string
FixedVersions	array[string]
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
SupplierName	string
ReleaseDate	date-time
Labels	array[object]
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time
Latest	object
Version	string
ReleaseDate	string
CreatedAt	date-time
LastUpdated	date-time

Expand

Response

xxxxxxxxxx
 
{
 "ResponseKey": "{string}", "ResponseMessage": "{string}", "Package": {...}
}
Copy

Retrieves CVEs associated with a specific package

Auth

Path Params

id string

GET /api/v1/packages/{id}/cves

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D/cves' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Cves	array[object]
Id	string
FixedVersions	array[string]
Severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
Source	string
Cwes	array[string]

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Cves": [  {   "Id": "{string}",   "FixedVersions": [    "{array[string]...}"   ],   "Severity": "{string}",   "Source": "{string}",   "Cwes": [    "{array[string]...}"   ]  } ]}
Copy

Retrieves all labels for a specific package

Auth

Path Params

id string

GET /api/v1/packages/{id}/labels

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D/labels' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Labels	array[object]
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Labels": [  {   "Key": "{string}",   "Value": "{string}",   "ValueType": "{string}",   "Created": "{date-time}",   "Updated": "{date-time}"  } ]}
Copy

Adds a label to a package

Auth

Path Params

id string

Request Body

object	object
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time

POST /api/v1/packages/{id}/labels

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D/labels' \ --header 'Authorization: Bearer {token}' \ --data '{  "Key": "{string}",  "Value": "{string}",  "ValueType": "{string}",  "Created": "{date-time}",  "Updated": "{date-time}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Label	object
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Label": {  "Key": "{string}",  "Value": "{string}",  "ValueType": "{string}",  "Created": "{date-time}",  "Updated": "{date-time}" }}
Copy

Updates an existing label in a package

Auth

Path Params

id	string
key	string

Request Body

object	object
value	string
valueType	string

PUT /api/v1/packages/{id}/labels/{key}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D/labels/%7Bkey%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "value": "{string}",  "valueType": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Deletes a label from a package

Auth

Path Params

id	string
key	string

DELETE /api/v1/packages/{id}/labels/{key}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/packages/%7Bid%7D/labels/%7Bkey%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Searches for packages by label key and optionally value

Auth

Query String

key	string
value	string

GET /api/v1/packages/search/labels

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/packages/search/labels' \ --header 'Authorization: Bearer {token}' \ --data key={key} \ --data value={value}
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Packages	array[object]
Id	string
Name	string
Version	string
Ecosystem	string
Archive	boolean
Executable	boolean
Uid	string
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Repositories	array[object]
Connection	string
Repository	string
RepositoryId	string
Reference	string
Scanned	date-time
ScanIds	array[string]
StepSha256s	array[string]
Hashes	array[object]
Sha256	string
FileName	string
Vulnerabilities	array[object]
Id	string
FixedVersions	array[string]
Severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
Source	string
Cwes	array[string]
Dependencies	array[object]
Ecosystem	string
Group	string
PackageName	string
PackageVersion	string
Vulnerabilities	array[object]
Id	string
Severity	string
Source	string
FixedVersions	array[string]
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
SupplierName	string
ReleaseDate	date-time
Labels	array[object]
Key	string
Value	string
ValueType	string
Created	date-time
Updated	date-time
Latest	object
Version	string
ReleaseDate	string
CreatedAt	date-time
LastUpdated	date-time

Expand

Response

xxxxxxxxxx
 
{
 "ResponseKey": "{string}", "ResponseMessage": "{string}", "Packages": [...]
}
Copy

Projects

Manage projects

/api/v1/projects/{id}

/api/v1/projects/{id}

/api/v1/projects/{id}

/api/v1/projects/{id}/workflows/attach

/api/v1/projects/{id}/workflows/detach

/api/v1/projects/{id}/storages/attach

/api/v1/projects/{id}/storages/detach

List Projects

Auth

GET /api/v1/projects

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/projects' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

Response

xxxxxxxxxx
 
[ {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }]
Copy

Create Project

Auth

Request Body

object	object
Name	string	maxLength: 50 minLength: 1
WorkflowIds	array[string]
StorageIds	array[string]

POST /api/v1/projects

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/projects' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "WorkflowIds": [    "{array[string]...}"  ],  "StorageIds": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Get Project By Id

Auth

Path Params

id string

GET /api/v1/projects/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "Id": "{string}", "Name": "{string}", "WorkflowIds": [  "{array[string]...}" ], "StorageIds": [  "{array[string]...}" ]}
Copy

Update Project

Auth

Path Params

id string

Request Body

object	object
Name	string	maxLength: 50

PUT /api/v1/projects/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Delete Project

Auth

Path Params

id string

DELETE /api/v1/projects/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Attach workflows to project

Auth

Path Params

id string

Request Body

object	object
Ids	array[string]

POST /api/v1/projects/{id}/workflows/attach

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D/workflows/attach' \ --header 'Authorization: Bearer {token}' \ --data '{  "Ids": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Detach workflows from project

Auth

Path Params

id string

Request Body

object	object
Ids	array[string]

POST /api/v1/projects/{id}/workflows/detach

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D/workflows/detach' \ --header 'Authorization: Bearer {token}' \ --data '{  "Ids": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Attach storages to project

Auth

Path Params

id string

Request Body

object	object
Ids	array[string]

POST /api/v1/projects/{id}/storages/attach

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D/storages/attach' \ --header 'Authorization: Bearer {token}' \ --data '{  "Ids": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Detach storages from project

Auth

Path Params

id string

Request Body

object	object
Ids	array[string]

POST /api/v1/projects/{id}/storages/detach

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/projects/%7Bid%7D/storages/detach' \ --header 'Authorization: Bearer {token}' \ --data '{  "Ids": [    "{array[string]...}"  ]}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Project	object
Id	string
Name	string
WorkflowIds	array[string]
StorageIds	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Project": {  "Id": "{string}",  "Name": "{string}",  "WorkflowIds": [   "{array[string]...}"  ],  "StorageIds": [   "{array[string]...}"  ] }}
Copy

Real Time

Manage real-time protection

/api/v1/realtime/{storageId}/enable

PATCH

/api/v1/realtime/{storageId}/disable

PATCH

/api/v1/realtime/{storageId}/{repositoryId}/disable

/api/v1/realtime

/api/v1/realtime/{storageId}

/api/v1/realtime/{storageId}

/api/v1/realtime/{storageId}/{repositoryId}

Enable real-time protection for multiple repositories

Auth

Path Params

storageId string

Request Body

object	object
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Connection	string
WorkflowId	string

POST /api/v1/realtime/{storageId}/enable

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D/enable' \ --header 'Authorization: Bearer {token}' \ --data '{  "Repositories": [    {      "RepositoryId": "{string}",      "RepositoryName": "{string}"    }  ],  "Connection": "{string}",  "WorkflowId": "{string}"}'
Copy

Responses

207

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

409

Conflict

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Disable real-time protection for storage

Auth

Path Params

storageId string

PATCH /api/v1/realtime/{storageId}/disable

xxxxxxxxxx
 
curl --request PATCH \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D/disable' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Disable real-time protection for repository

Auth

Path Params

storageId	string
repositoryId	string

PATCH /api/v1/realtime/{storageId}/{repositoryId}/disable

xxxxxxxxxx
 
curl --request PATCH \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D/%7BrepositoryId%7D/disable' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

List storages with real-time protection enabled

Auth

GET /api/v1/realtime

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/realtime' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Storages	array[object]
Id	string
Name	string
StorageType	object
Name	string
CategoryType	string	Enum: `Local`,`Cloud`,`Object`
ProtocolType	string	Enum: `Smb`,`GraphSdk`,`BoxSdk`,`AwsSdk`,`AzureBlobSdk`,`AlibabaCloudSdk`,`GoogleCloudSdk`,`AzureFilesSdk`,`Sftp`,`Nfs`,`Mft`,`SharepointOnPrem`,`Ftp`,`GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
VendorType	string	Enum: `AmazonS3`,`OneDrive`,`Box`,`DellIsilon`,`AzureFiles`,`SmbCompatible`,`S3Compatible`,`AzureBlob`,`AlibabaCloud`,`GoogleCloud`,`Sftp`,`SharePoint`,`Nfs`,`Wasabi`,`OracleCloud`,`NetAppOntap`,`Cubbit`,`Mft`,`SharepointOnPrem`,`Ftp`,`GitHub`,`DockerHub`,`Bitbucket`,`AmazonEcr`,`Quay`,`JFrogContainer`,`JFrogBinary`,`AzureAcr`,`GitLabSource`,`GitLabContainer`,`Svn`
StorageStatus	object
Message	string
StatusType	string	Enum: `NotTested`,`Testing`,`Operational`,`Error`

Response

xxxxxxxxxx
 
{ "Storages": [  {   "Id": "{string}",   "Name": "{string}",   "StorageType": {    "Name": "{string}",    "CategoryType": "{string}",    "ProtocolType": "{string}",    "VendorType": "{string}"   },   "StorageStatus": {    "Message": "{string}",    "StatusType": "{string}"   }  } ]}
Copy

List ongoing real-time scans for storage

Auth

Path Params

storageId string

GET /api/v1/realtime/{storageId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
StorageId	string
RealTimeScans	array[object]
ScanId	string
RepositoryId	string
RepositoryName	string
ScanningState	string	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
WorkflowId	string
ScanInformation	object
TotalFiles	int32
Malware	int32
Secret	int32
BlockedFiles	int32
VulnerabilityIssues	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
Licenses	object
BlockedLicensesCount	int32
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Package	object
TotalPackages	int32
VulnerablePackages	int32

Expand

Response

xxxxxxxxxx
 
{ "StorageId": "{string}", "RealTimeScans": [  {   "ScanId": "{string}",   "RepositoryId": "{string}",   "RepositoryName": "{string}",   "ScanningState": "{string}",   "WorkflowId": "{string}"  } ], "ScanInformation": {  "TotalFiles": "{int32}",  "Malware": "{int32}",  "Secret": "{int32}",  "BlockedFiles": "{int32}",  "VulnerabilityIssues": {   "Critical": "{int32}",   "High": "{int32}",   "Medium": "{int32}",   "Low": "{int32}",   "Unknown": "{int32}"  },  "Licenses": {   "BlockedLicensesCount": "{int32}",   "Allowed": [    {     "Id": "{string}",     "Url": "{string}",     "Category": "{string}",     "UsageRestriction": {      "Permissions": [       "{array[string]...}"      ],      "Conditions": [       "{array[string]...}"      ],      "Limitations": [       "{array[string]...}"      ]     }    }   ],   "Blocked": [    {     "Id": "{string}",     "Url": "{string}",     "Category": "{string}",     "UsageRestriction": {      "Permissions": [       "{array[string]...}"      ],      "Conditions": [       "{array[string]...}"      ],      "Limitations": [       "{array[string]...}"      ]     }    }   ]  },  "Package": {   "TotalPackages": "{int32}",   "VulnerablePackages": "{int32}"  } }}
Copy

Expand

Delete real-time scan data for storage

Auth

Path Params

storageId string

Query String

forceDelete boolean

DELETE /api/v1/realtime/{storageId}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D' \ --header 'Authorization: Bearer {token}' \ --data forceDelete={forceDelete}
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Delete real-time scan data for repository

Auth

Path Params

storageId	string
repositoryId	string

Query String

forceDelete boolean

DELETE /api/v1/realtime/{storageId}/{repositoryId}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/realtime/%7BstorageId%7D/%7BrepositoryId%7D' \ --header 'Authorization: Bearer {token}' \ --data forceDelete={forceDelete}
Copy

Responses

200

Success

No response body

Response

xxxxxxxxxx
 
No response
Copy

Scan Configurations

List, add, update and delete Scan Configurations

/api/v1/scan-configurations/{id}

/api/v1/scan-configurations/{id}

/api/v1/scan-configurations/{id}

/api/v1/scan-configurations/scan-pools/{id}

/api/v1/scan-configurations

/api/v1/scan-configurations

Get Scan Configuration by ID

Auth

Path Params

id string

GET /api/v1/scan-configurations/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Workflow	object
Id	string
ScanPoolId	string
Rules	array[string]
Type	string	Enum: `Default`,`Basic`
Name	string
ScanPool	object
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number
UserAgent	string
Filters	object
Id	string
MinimumSize	int64
MaximumSize	int64
MinimumDateTime	date-time
MaximumDateTime	date-time

Expand

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Workflow": {  "Id": "{string}",  "ScanPoolId": "{string}",  "Rules": [   "{array[string]...}"  ],  "Type": "{string}",  "Name": "{string}",  "ScanPool": {   "Id": "{string}",   "Name": "{string}",   "ScanPoolType": "{string}",   "IsDefault": "{boolean}",   "ScanInstances": [    {     "Id": "{string}",     "ScanPoolId": "{string}",     "Url": "{string}",     "ApiKey": "{string}",     "Timeout": {      "Ticks": "{int64}",      "Days": "{int32}",      "Hours": "{int32}",      "Milliseconds": "{int32}",      "Microseconds": "{int32}",      "Nanoseconds": "{int32}",      "Minutes": "{int32}",      "Seconds": "{int32}",      "TotalDays": "{number}",      "TotalHours": "{number}",      "TotalMilliseconds": "{number}",      "TotalMicroseconds": "{number}",      "TotalNanoseconds": "{number}",      "TotalMinutes": "{number}",      "TotalSeconds": "{number}"     }    }   ]  },  "UserAgent": "{string}",  "Filters": {   "Id": "{string}",   "MinimumSize": "{int64}",   "MaximumSize": "{int64}",   "MinimumDateTime": "{date-time}",   "MaximumDateTime": "{date-time}"  } }}
Copy

Expand

Update an existing Scan Configuration

Auth

Path Params

id string

Request Body

object	object
Name	string	maxLength: 50 minLength: 3
ScanPoolId	string
Rules	array[string]
UserAgent	string

PUT /api/v1/scan-configurations/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "ScanPoolId": "{string}",  "Rules": [    "{array[string]...}"  ],  "UserAgent": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Delete a Scan Configuration

Auth

Path Params

id string

DELETE /api/v1/scan-configurations/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Get all Scan Configurations by ScanPool ID

Auth

Path Params

id string

GET /api/v1/scan-configurations/scan-pools/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations/scan-pools/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Workflows	array[object]	Because it belongs to a response, if GetMultipleScanConfiguration breaks, we won't have ScanConfigurations.
Id	string
ScanPoolId	string
Rules	array[string]
Type	string	Enum: `Default`,`Basic`
Name	string
ScanPool	object
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number
UserAgent	string
Filters	object
Id	string
MinimumSize	int64
MaximumSize	int64
MinimumDateTime	date-time
MaximumDateTime	date-time

Expand

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Workflows": [  {   "Id": "{string}",   "ScanPoolId": "{string}",   "Rules": [    "{array[string]...}"   ],   "Type": "{string}",   "Name": "{string}",   "ScanPool": {    "Id": "{string}",    "Name": "{string}",    "ScanPoolType": "{string}",    "IsDefault": "{boolean}",    "ScanInstances": [     {      "Id": "{string}",      "ScanPoolId": "{string}",      "Url": "{string}",      "ApiKey": "{string}",      "Timeout": {       "Ticks": "{int64}",       "Days": "{int32}",       "Hours": "{int32}",       "Milliseconds": "{int32}",       "Microseconds": "{int32}",       "Nanoseconds": "{int32}",       "Minutes": "{int32}",       "Seconds": "{int32}",       "TotalDays": "{number}",       "TotalHours": "{number}",       "TotalMilliseconds": "{number}",       "TotalMicroseconds": "{number}",       "TotalNanoseconds": "{number}",       "TotalMinutes": "{number}",       "TotalSeconds": "{number}"      }     }    ]   },   "UserAgent": "{string}",   "Filters": {    "Id": "{string}",    "MinimumSize": "{int64}",    "MaximumSize": "{int64}",    "MinimumDateTime": "{date-time}",    "MaximumDateTime": "{date-time}"   }  } ]}
Copy

Expand

Get Scan Configurations

Auth

GET /api/v1/scan-configurations

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Workflows	array[object]	Because it belongs to a response, if GetMultipleScanConfiguration breaks, we won't have ScanConfigurations.
Id	string
ScanPoolId	string
Rules	array[string]
Type	string	Enum: `Default`,`Basic`
Name	string
ScanPool	object
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number
UserAgent	string
Filters	object
Id	string
MinimumSize	int64
MaximumSize	int64
MinimumDateTime	date-time
MaximumDateTime	date-time

Expand

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Workflows": [  {   "Id": "{string}",   "ScanPoolId": "{string}",   "Rules": [    "{array[string]...}"   ],   "Type": "{string}",   "Name": "{string}",   "ScanPool": {    "Id": "{string}",    "Name": "{string}",    "ScanPoolType": "{string}",    "IsDefault": "{boolean}",    "ScanInstances": [     {      "Id": "{string}",      "ScanPoolId": "{string}",      "Url": "{string}",      "ApiKey": "{string}",      "Timeout": {       "Ticks": "{int64}",       "Days": "{int32}",       "Hours": "{int32}",       "Milliseconds": "{int32}",       "Microseconds": "{int32}",       "Nanoseconds": "{int32}",       "Minutes": "{int32}",       "Seconds": "{int32}",       "TotalDays": "{number}",       "TotalHours": "{number}",       "TotalMilliseconds": "{number}",       "TotalMicroseconds": "{number}",       "TotalNanoseconds": "{number}",       "TotalMinutes": "{number}",       "TotalSeconds": "{number}"      }     }    ]   },   "UserAgent": "{string}",   "Filters": {    "Id": "{string}",    "MinimumSize": "{int64}",    "MaximumSize": "{int64}",    "MinimumDateTime": "{date-time}",    "MaximumDateTime": "{date-time}"   }  } ]}
Copy

Expand

Add Scan Configurations

Auth

Request Body

object	object
Name	string	maxLength: 50 minLength: 3
ScanPoolId	string
Rules	array[string]
UserAgent	string

POST /api/v1/scan-configurations

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/scan-configurations' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "ScanPoolId": "{string}",  "Rules": [    "{array[string]...}"  ],  "UserAgent": "{string}"}'
Copy

Responses

200

Success

object	object
Id	string
ScanPoolId	string
Rules	array[string]
Type	string	Enum: `Default`,`Basic`
Name	string
ScanPool	object
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number
UserAgent	string
Filters	object
Id	string
MinimumSize	int64
MaximumSize	int64
MinimumDateTime	date-time
MaximumDateTime	date-time

Expand

400

Bad Request

502

Server Error

Response

xxxxxxxxxx
 
{ "Id": "{string}", "ScanPoolId": "{string}", "Rules": [  "{array[string]...}" ], "Type": "{string}", "Name": "{string}", "ScanPool": {  "Id": "{string}",  "Name": "{string}",  "ScanPoolType": "{string}",  "IsDefault": "{boolean}",  "ScanInstances": [   {    "Id": "{string}",    "ScanPoolId": "{string}",    "Url": "{string}",    "ApiKey": "{string}",    "Timeout": {     "Ticks": "{int64}",     "Days": "{int32}",     "Hours": "{int32}",     "Milliseconds": "{int32}",     "Microseconds": "{int32}",     "Nanoseconds": "{int32}",     "Minutes": "{int32}",     "Seconds": "{int32}",     "TotalDays": "{number}",     "TotalHours": "{number}",     "TotalMilliseconds": "{number}",     "TotalMicroseconds": "{number}",     "TotalNanoseconds": "{number}",     "TotalMinutes": "{number}",     "TotalSeconds": "{number}"    }   }  ] }, "UserAgent": "{string}", "Filters": {  "Id": "{string}",  "MinimumSize": "{int64}",  "MaximumSize": "{int64}",  "MinimumDateTime": "{date-time}",  "MaximumDateTime": "{date-time}" }}
Copy

Scan Instances

Manage your scan instances

/api/v1/scan-instances

/api/v1/scan-instances/{id}

/api/v1/scan-instances/{id}

/api/v1/scan-instances/{id}

Add a new scan instance

Auth

Request Body

object	object
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
ScanInstanceType	string	Enum: `MdCore`,`MdCloud`

POST /api/v1/scan-instances

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/scan-instances' \ --header 'Authorization: Bearer {token}' \ --data '{  "ScanPoolId": "{string}",  "Url": "{string}",  "ApiKey": "{string}",  "Timeout": {    "Ticks": "{int64}"  },  "ScanInstanceType": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
ScanInstanceId	string	Because it belongs to a response, if AddScanInstance breaks, we won't have ScanInstanceId.

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "ScanInstanceId": "{string}"}
Copy

Get a scan instance by ID

Auth

Path Params

id string

GET /api/v1/scan-instances/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-instances/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
ScanInstance	object
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number

Expand

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "ScanInstance": {  "Id": "{string}",  "ScanPoolId": "{string}",  "Url": "{string}",  "ApiKey": "{string}",  "Timeout": {   "Ticks": "{int64}",   "Days": "{int32}",   "Hours": "{int32}",   "Milliseconds": "{int32}",   "Microseconds": "{int32}",   "Nanoseconds": "{int32}",   "Minutes": "{int32}",   "Seconds": "{int32}",   "TotalDays": "{number}",   "TotalHours": "{number}",   "TotalMilliseconds": "{number}",   "TotalMicroseconds": "{number}",   "TotalNanoseconds": "{number}",   "TotalMinutes": "{number}",   "TotalSeconds": "{number}"  } }}
Copy

Update a scan instance

Auth

Path Params

id string

Request Body

object	object
Url	string
ApiKey	string
Timeout	object
Ticks	int64

PUT /api/v1/scan-instances/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/scan-instances/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Url": "{string}",  "ApiKey": "{string}",  "Timeout": {    "Ticks": "{int64}"  }}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Delete scan instance

Auth

Path Params

id string

DELETE /api/v1/scan-instances/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/scan-instances/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Scan Pools

Manage your scan pools

/api/v1/scan-pools/{id}

/api/v1/scan-pools/{id}

/api/v1/scan-pools/{id}

/api/v1/scan-pools/{id}/rules

Get Scan Pools

Auth

GET /api/v1/scan-pools

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-pools' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
ScanPools	array[object]
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number

Expand

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "ScanPools": [  {   "Id": "{string}",   "Name": "{string}",   "ScanPoolType": "{string}",   "IsDefault": "{boolean}",   "ScanInstances": [    {     "Id": "{string}",     "ScanPoolId": "{string}",     "Url": "{string}",     "ApiKey": "{string}",     "Timeout": {      "Ticks": "{int64}",      "Days": "{int32}",      "Hours": "{int32}",      "Milliseconds": "{int32}",      "Microseconds": "{int32}",      "Nanoseconds": "{int32}",      "Minutes": "{int32}",      "Seconds": "{int32}",      "TotalDays": "{number}",      "TotalHours": "{number}",      "TotalMilliseconds": "{number}",      "TotalMicroseconds": "{number}",      "TotalNanoseconds": "{number}",      "TotalMinutes": "{number}",      "TotalSeconds": "{number}"     }    }   ]  } ]}
Copy

Add a new Scan Pool

Auth

Request Body

object	object
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`

POST /api/v1/scan-pools

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/scan-pools' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "ScanPoolType": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
ScanPoolId	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "ScanPoolId": "{string}"}
Copy

Get Scan Pool by ID

Auth

Path Params

id string

GET /api/v1/scan-pools/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-pools/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
ScanPool	object
Id	string
Name	string
ScanPoolType	string	Enum: `MdCore`,`MdCloud`
IsDefault	boolean
ScanInstances	array[object]
Id	string
ScanPoolId	string
Url	string
ApiKey	string
Timeout	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number

Expand

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "ScanPool": {  "Id": "{string}",  "Name": "{string}",  "ScanPoolType": "{string}",  "IsDefault": "{boolean}",  "ScanInstances": [   {    "Id": "{string}",    "ScanPoolId": "{string}",    "Url": "{string}",    "ApiKey": "{string}",    "Timeout": {     "Ticks": "{int64}",     "Days": "{int32}",     "Hours": "{int32}",     "Milliseconds": "{int32}",     "Microseconds": "{int32}",     "Nanoseconds": "{int32}",     "Minutes": "{int32}",     "Seconds": "{int32}",     "TotalDays": "{number}",     "TotalHours": "{number}",     "TotalMilliseconds": "{number}",     "TotalMicroseconds": "{number}",     "TotalNanoseconds": "{number}",     "TotalMinutes": "{number}",     "TotalSeconds": "{number}"    }   }  ] }}
Copy

Update an existing Scan Pool. It's type can't be changed, it is not supported yet.

Auth

Path Params

id string

Request Body

object	object
Name	string

PUT /api/v1/scan-pools/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/scan-pools/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Delete a Scan Pool

Auth

Path Params

id string

DELETE /api/v1/scan-pools/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/scan-pools/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

rules

Auth

Path Params

id string

GET /api/v1/scan-pools/{id}/rules

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scan-pools/%7Bid%7D/rules' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
name	string
user_agents	array[string]

400

Bad Request

Response

xxxxxxxxxx
 
[ {  "name": "{string}",  "user_agents": [   "{array[string]...}"  ] }]
Copy

Scans

Manage your scans

/api/v1/scans/{serviceId}/latest

/api/v1/scans/{id}/overview

/api/v1/scans/{serviceId}/{repositoryId}

/api/v1/scans/schedules

/api/v1/scans/{scanId}/files

/api/v1/scans/{scanResultId}/core-result

/api/v1/scans/{scanResultId}/archive

Enumerate scan results

Auth

Query String

Type	array	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
TimeFrame	string	Enum: `OneDay`,`TwoDays`,`ThreeDays`
Vulnerabilities	array	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
LicenseRisks	array
Status	array	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
TriggerEvent	array
Workflow	string
Connection	string
Secrets	boolean
Threats	boolean
Search	string
ConnectionType	string	Enum: `Unknown`,`SourceCode`,`Container`,`Binary`

GET /api/v1/scans

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans' \ --header 'Authorization: Bearer {token}' \ --data Type={Type} \ --data TimeFrame={TimeFrame} \ --data Vulnerabilities={Vulnerabilities} \ --data LicenseRisks={LicenseRisks} \ --data Status={Status} \ --data TriggerEvent={TriggerEvent} \ --data Workflow={Workflow} \ --data Connection={Connection} \ --data Secrets={Secrets} \ --data Threats={Threats} \ --data Search={Search} \ --data ConnectionType={ConnectionType}
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Add or start a scan

Auth

Request Body

object	object
StorageId	string
StorageName	string
ScanType	string	Enum: `Instant`,`Scheduled`,`RealTime`
WorkflowId	string
RepositoryId	string
RepositoryName	string
ProtocolType	string	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
RepositoryReferences	array[string]
Organization	string
Connection	string
PackageType	string
RepositoryType	string

POST /api/v1/scans

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/scans' \ --header 'Authorization: Bearer {token}' \ --data '{  "StorageId": "{string}",  "StorageName": "{string}",  "ScanType": "{string}",  "WorkflowId": "{string}",  "RepositoryId": "{string}",  "RepositoryName": "{string}",  "ProtocolType": "{string}",  "RepositoryReferences": [    "{array[string]...}"  ],  "Organization": "{string}",  "Connection": "{string}",  "PackageType": "{string}",  "RepositoryType": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
ScanIds	array[string]
ReferencesUsedForScanning	array[string]
ProtocolType	string	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
RepositoryId	string
RepositoryName	string
ServiceId	string
StorageName	string
WorkflowId	string
WorkflowName	string
TriggerEvent	string
TriggerBy	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "ScanIds": [  "{array[string]...}" ], "ReferencesUsedForScanning": [  "{array[string]...}" ], "ProtocolType": "{string}", "RepositoryId": "{string}", "RepositoryName": "{string}", "ServiceId": "{string}", "StorageName": "{string}", "WorkflowId": "{string}", "WorkflowName": "{string}", "TriggerEvent": "{string}", "TriggerBy": "{string}"}
Copy

Delete multiple scans by their scan IDs

Auth

DELETE /api/v1/scans

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/scans' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

No response body

400

Bad Request

500

Server Error

Response

xxxxxxxxxx
 
No response
Copy

Get scan results by scan ID

Auth

Path Params

id string

GET /api/v1/scans/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ServiceId	string
RepositoryId	string
RepositoryName	string
RepositoryType	string
ReferenceUsedForScanning	string
ScanId	string
ProtocolType	string	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
Connection	string
PackageType	string
Organization	string
StartTime	date-time
StopTime	date-time
Duration	object
Ticks	int64
Days	int32
Hours	int32
Milliseconds	int32
Microseconds	int32
Nanoseconds	int32
Minutes	int32
Seconds	int32
TotalDays	number
TotalHours	number
TotalMilliseconds	number
TotalMicroseconds	number
TotalNanoseconds	number
TotalMinutes	number
TotalSeconds	number
VulnerabilityIssues	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
ScanStatus	string	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
DiscoveryStatus	string	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
Errors	array[string]
BlockedLicensesCount	int32
InfectedFiles	int32
FilesWithSecrets	int32

Expand

404

Not Found

Response

xxxxxxxxxx
 
{ "ServiceId": "{string}", "RepositoryId": "{string}", "RepositoryName": "{string}", "RepositoryType": "{string}", "ReferenceUsedForScanning": "{string}", "ScanId": "{string}", "ProtocolType": "{string}", "Connection": "{string}", "PackageType": "{string}", "Organization": "{string}", "StartTime": "{date-time}", "StopTime": "{date-time}", "Duration": {  "Ticks": "{int64}",  "Days": "{int32}",  "Hours": "{int32}",  "Milliseconds": "{int32}",  "Microseconds": "{int32}",  "Nanoseconds": "{int32}",  "Minutes": "{int32}",  "Seconds": "{int32}",  "TotalDays": "{number}",  "TotalHours": "{number}",  "TotalMilliseconds": "{number}",  "TotalMicroseconds": "{number}",  "TotalNanoseconds": "{number}",  "TotalMinutes": "{number}",  "TotalSeconds": "{number}" }, "VulnerabilityIssues": {  "critical": "{int32}",  "high": "{int32}",  "medium": "{int32}",  "low": "{int32}",  "unknown": "{int32}" }, "ScanStatus": "{string}", "DiscoveryStatus": "{string}", "Errors": [  "{array[string]...}" ], "BlockedLicensesCount": "{int32}", "InfectedFiles": "{int32}", "FilesWithSecrets": "{int32}"}
Copy

Stop a scan

Auth

Path Params

id string

POST /api/v1/scans/{id}

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/scans/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
StatusCode	int32

Response

xxxxxxxxxx
 
{ "StatusCode": "{int32}"}
Copy

Enumerate all latest scan results

Auth

Query String

Type	array	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
TimeFrame	string	Enum: `OneDay`,`TwoDays`,`ThreeDays`
Vulnerabilities	array	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
LicenseRisks	array
Status	array	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
TriggerEvent	array
Workflow	string
Connection	string
Secrets	boolean
Threats	boolean
Search	string
ConnectionType	string	Enum: `Unknown`,`SourceCode`,`Container`,`Binary`

GET /api/v1/scans/latest

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/latest' \ --header 'Authorization: Bearer {token}' \ --data Type={Type} \ --data TimeFrame={TimeFrame} \ --data Vulnerabilities={Vulnerabilities} \ --data LicenseRisks={LicenseRisks} \ --data Status={Status} \ --data TriggerEvent={TriggerEvent} \ --data Workflow={Workflow} \ --data Connection={Connection} \ --data Secrets={Secrets} \ --data Threats={Threats} \ --data Search={Search} \ --data ConnectionType={ConnectionType}
Copy

Responses

200

Success

array	array[object]
ScanId	string
Repository	object
ConnectionId	string
ConnectionName	string
RepositoryId	string
RepositoryName	string
RepositoryReference	string
RepositoryMetadata	string
ScanInformation	object
Malware	boolean
Secret	boolean
VulnerabilityIssues	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
Licenses	object
BlockedLicensesCount	int32
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Workflow	object
WorkflowId	string
WorkflowName	string
WorkflowType	string
WorkflowIsDeleted	boolean
Remediations	array[object]
IsEnabled	boolean
Type	string
Package	object
TotalPackages	int32
VulnerablePackages	int32
ScannedOn	date-time
StopTime	date-time
TriggerEvent	string
Errors	array[string]
ScanStatus	object
ScanningState	string
UploadProgress	int32
ScanProgress	int32

Expand

404

Not Found

Response

xxxxxxxxxx
 
[ {  "ScanId": "{string}",  "Repository": {   "ConnectionId": "{string}",   "ConnectionName": "{string}",   "RepositoryId": "{string}",   "RepositoryName": "{string}",   "RepositoryReference": "{string}",   "RepositoryMetadata": "{string}"  },  "ScanInformation": {   "Malware": "{boolean}",   "Secret": "{boolean}",   "VulnerabilityIssues": {    "critical": "{int32}",    "high": "{int32}",    "medium": "{int32}",    "low": "{int32}",    "unknown": "{int32}"   },   "Licenses": {    "BlockedLicensesCount": "{int32}",    "Allowed": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ],    "Blocked": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ]   },   "Workflow": {    "WorkflowId": "{string}",    "WorkflowName": "{string}",    "WorkflowType": "{string}",    "WorkflowIsDeleted": "{boolean}",    "Remediations": [     {      "IsEnabled": "{boolean}",      "Type": "{string}"     }    ]   },   "Package": {    "TotalPackages": "{int32}",    "VulnerablePackages": "{int32}"   },   "ScannedOn": "{date-time}",   "StopTime": "{date-time}",   "TriggerEvent": "{string}",   "Errors": [    "{array[string]...}"   ]  },  "ScanStatus": {   "ScanningState": "{string}",   "UploadProgress": "{int32}",   "ScanProgress": "{int32}"  } }]
Copy

Expand

Enumerate all latest scan results by service ID

Auth

Path Params

serviceId string

Query String

Type	array	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`
TimeFrame	string	Enum: `OneDay`,`TwoDays`,`ThreeDays`
Vulnerabilities	array	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
LicenseRisks	array
Status	array	Enum: `NotStarted`,`Running`,`Cancelled`,`Failed`,`Completed`
TriggerEvent	array
Workflow	string
Connection	string
Secrets	boolean
Threats	boolean
Search	string
ConnectionType	string	Enum: `Unknown`,`SourceCode`,`Container`,`Binary`

GET /api/v1/scans/{serviceId}/latest

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7BserviceId%7D/latest' \ --header 'Authorization: Bearer {token}' \ --data Type={Type} \ --data TimeFrame={TimeFrame} \ --data Vulnerabilities={Vulnerabilities} \ --data LicenseRisks={LicenseRisks} \ --data Status={Status} \ --data TriggerEvent={TriggerEvent} \ --data Workflow={Workflow} \ --data Connection={Connection} \ --data Secrets={Secrets} \ --data Threats={Threats} \ --data Search={Search} \ --data ConnectionType={ConnectionType}
Copy

Responses

200

Success

object	object
ScanId	string
Repository	object
ConnectionId	string
ConnectionName	string
RepositoryId	string
RepositoryName	string
RepositoryReference	string
RepositoryMetadata	string
ScanInformation	object
Malware	boolean
Secret	boolean
VulnerabilityIssues	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
Licenses	object
BlockedLicensesCount	int32
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Workflow	object
WorkflowId	string
WorkflowName	string
WorkflowType	string
WorkflowIsDeleted	boolean
Remediations	array[object]
IsEnabled	boolean
Type	string
Package	object
TotalPackages	int32
VulnerablePackages	int32
ScannedOn	date-time
StopTime	date-time
TriggerEvent	string
Errors	array[string]
ScanStatus	object
ScanningState	string
UploadProgress	int32
ScanProgress	int32

Expand

Response

xxxxxxxxxx
 
{ "ScanId": "{string}", "Repository": {  "ConnectionId": "{string}",  "ConnectionName": "{string}",  "RepositoryId": "{string}",  "RepositoryName": "{string}",  "RepositoryReference": "{string}",  "RepositoryMetadata": "{string}" }, "ScanInformation": {  "Malware": "{boolean}",  "Secret": "{boolean}",  "VulnerabilityIssues": {   "critical": "{int32}",   "high": "{int32}",   "medium": "{int32}",   "low": "{int32}",   "unknown": "{int32}"  },  "Licenses": {   "BlockedLicensesCount": "{int32}",   "Allowed": [    {     "Id": "{string}",     "Url": "{string}",     "Category": "{string}",     "UsageRestriction": {      "Permissions": [       "{array[string]...}"      ],      "Conditions": [       "{array[string]...}"      ],      "Limitations": [       "{array[string]...}"      ]     }    }   ],   "Blocked": [    {     "Id": "{string}",     "Url": "{string}",     "Category": "{string}",     "UsageRestriction": {      "Permissions": [       "{array[string]...}"      ],      "Conditions": [       "{array[string]...}"      ],      "Limitations": [       "{array[string]...}"      ]     }    }   ]  },  "Workflow": {   "WorkflowId": "{string}",   "WorkflowName": "{string}",   "WorkflowType": "{string}",   "WorkflowIsDeleted": "{boolean}",   "Remediations": [    {     "IsEnabled": "{boolean}",     "Type": "{string}"    }   ]  },  "Package": {   "TotalPackages": "{int32}",   "VulnerablePackages": "{int32}"  },  "ScannedOn": "{date-time}",  "StopTime": "{date-time}",  "TriggerEvent": "{string}",  "Errors": [   "{array[string]...}"  ] }, "ScanStatus": {  "ScanningState": "{string}",  "UploadProgress": "{int32}",  "ScanProgress": "{int32}" }}
Copy

Expand

Get scan overview by scan ID

Auth

Path Params

id string

GET /api/v1/scans/{id}/overview

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7Bid%7D/overview' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
ScanId	string
Repository	object
ConnectionId	string
ConnectionName	string
RepositoryId	string
RepositoryName	string
RepositoryReference	string
RepositoryMetadata	string
ScanInformation	object
Malware	boolean
Secret	boolean
VulnerabilityIssues	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
Licenses	object
BlockedLicensesCount	int32
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Workflow	object
WorkflowId	string
WorkflowName	string
WorkflowType	string
WorkflowIsDeleted	boolean
Remediations	array[object]
IsEnabled	boolean
Type	string
Package	object
TotalPackages	int32
VulnerablePackages	int32
ScannedOn	date-time
StopTime	date-time
TriggerEvent	string
Errors	array[string]
ScanStatus	object
ScanningState	string
UploadProgress	int32
ScanProgress	int32

Expand

Response

xxxxxxxxxx
 
[ {  "ScanId": "{string}",  "Repository": {   "ConnectionId": "{string}",   "ConnectionName": "{string}",   "RepositoryId": "{string}",   "RepositoryName": "{string}",   "RepositoryReference": "{string}",   "RepositoryMetadata": "{string}"  },  "ScanInformation": {   "Malware": "{boolean}",   "Secret": "{boolean}",   "VulnerabilityIssues": {    "critical": "{int32}",    "high": "{int32}",    "medium": "{int32}",    "low": "{int32}",    "unknown": "{int32}"   },   "Licenses": {    "BlockedLicensesCount": "{int32}",    "Allowed": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ],    "Blocked": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ]   },   "Workflow": {    "WorkflowId": "{string}",    "WorkflowName": "{string}",    "WorkflowType": "{string}",    "WorkflowIsDeleted": "{boolean}",    "Remediations": [     {      "IsEnabled": "{boolean}",      "Type": "{string}"     }    ]   },   "Package": {    "TotalPackages": "{int32}",    "VulnerablePackages": "{int32}"   },   "ScannedOn": "{date-time}",   "StopTime": "{date-time}",   "TriggerEvent": "{string}",   "Errors": [    "{array[string]...}"   ]  },  "ScanStatus": {   "ScanningState": "{string}",   "UploadProgress": "{int32}",   "ScanProgress": "{int32}"  } }]
Copy

Expand

Enumerate all scan results by repository ID

Auth

Path Params

serviceId	string
repositoryId	string

GET /api/v1/scans/{serviceId}/{repositoryId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7BserviceId%7D/%7BrepositoryId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
ScanId	string
Repository	object
ConnectionId	string
ConnectionName	string
RepositoryId	string
RepositoryName	string
RepositoryReference	string
RepositoryMetadata	string
ScanInformation	object
Malware	boolean
Secret	boolean
VulnerabilityIssues	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
Licenses	object
BlockedLicensesCount	int32
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Workflow	object
WorkflowId	string
WorkflowName	string
WorkflowType	string
WorkflowIsDeleted	boolean
Remediations	array[object]
IsEnabled	boolean
Type	string
Package	object
TotalPackages	int32
VulnerablePackages	int32
ScannedOn	date-time
StopTime	date-time
TriggerEvent	string
Errors	array[string]
ScanStatus	object
ScanningState	string
UploadProgress	int32
ScanProgress	int32

Expand

Response

xxxxxxxxxx
 
[ {  "ScanId": "{string}",  "Repository": {   "ConnectionId": "{string}",   "ConnectionName": "{string}",   "RepositoryId": "{string}",   "RepositoryName": "{string}",   "RepositoryReference": "{string}",   "RepositoryMetadata": "{string}"  },  "ScanInformation": {   "Malware": "{boolean}",   "Secret": "{boolean}",   "VulnerabilityIssues": {    "critical": "{int32}",    "high": "{int32}",    "medium": "{int32}",    "low": "{int32}",    "unknown": "{int32}"   },   "Licenses": {    "BlockedLicensesCount": "{int32}",    "Allowed": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ],    "Blocked": [     {      "Id": "{string}",      "Url": "{string}",      "Category": "{string}",      "UsageRestriction": {       "Permissions": [        "{array[string]...}"       ],       "Conditions": [        "{array[string]...}"       ],       "Limitations": [        "{array[string]...}"       ]      }     }    ]   },   "Workflow": {    "WorkflowId": "{string}",    "WorkflowName": "{string}",    "WorkflowType": "{string}",    "WorkflowIsDeleted": "{boolean}",    "Remediations": [     {      "IsEnabled": "{boolean}",      "Type": "{string}"     }    ]   },   "Package": {    "TotalPackages": "{int32}",    "VulnerablePackages": "{int32}"   },   "ScannedOn": "{date-time}",   "StopTime": "{date-time}",   "TriggerEvent": "{string}",   "Errors": [    "{array[string]...}"   ]  },  "ScanStatus": {   "ScanningState": "{string}",   "UploadProgress": "{int32}",   "ScanProgress": "{int32}"  } }]
Copy

Expand

Enumerate all scan schedules

Auth

GET /api/v1/scans/schedules

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/schedules' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
Id	string
WorkflowId	string
StorageId	string
UserId	string
Name	string
Priority	string	Enum: `Low`,`Medium`,`High`
CreatedAt	date-time
LastUpdated	date-time
LastScanTime	date-time
NextScanTime	date-time
RecurrenceType	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
StartDate	date-time
TimeToStart	date-time
EveryNumberOfHours	int32
EveryNumberOfDays	int32
EveryNumberOfWeeks	int32
EveryNumberOfMonths	int32
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
DayOfMonth	int32

Response

xxxxxxxxxx
 
[ {  "Id": "{string}",  "WorkflowId": "{string}",  "StorageId": "{string}",  "UserId": "{string}",  "Name": "{string}",  "Priority": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}",  "LastScanTime": "{date-time}",  "NextScanTime": "{date-time}",  "RecurrenceType": "{string}",  "StartDate": "{date-time}",  "TimeToStart": "{date-time}",  "EveryNumberOfHours": "{int32}",  "EveryNumberOfDays": "{int32}",  "EveryNumberOfWeeks": "{int32}",  "EveryNumberOfMonths": "{int32}",  "DaysOfWeek": [   "{array[string]...}"  ],  "DayOfMonth": "{int32}" }]
Copy

Enumerate files by scan ID

Auth

Path Params

scanId string

Query String

page	integer
pageSize	integer
search	string
includeArchives	boolean

GET /api/v1/scans/{scanId}/files

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7BscanId%7D/files' \ --header 'Authorization: Bearer {token}' \ --data page={page} \ --data pageSize={pageSize} \ --data search={search} \ --data includeArchives={includeArchives}
Copy

Responses

200

Success

array	array[object]
Id	string
ScanId	string
StorageId	string
ScanWorkflowSnapshotId	string
MetaDefenderCoreUrl	string
Name	string
Path	string
Hash	string
ObjectStorageMetadata	string
Size	int64
LastModified	date-time
StorageLocation	string
PathForDisplay	string
ObjectIdentityId	string
ObjectIdentityHash	string
ScanResultId	string
ProgressUpload	int32
ProgressScan	int32
ProcessingState	string	Enum: `InProgress`,`Failed`,`Canceled`,`Available`,`FailedRemediation`
ExceptionDetails	string
Created	date-time
DiscoveryStarted	date-time
DiscoveryStartedDaySec	int64
StreamingStartedTime	date-time
StreamingCompletedTime	date-time
StreamingTimeSpanMs	int64
ScanCompletedTime	date-time
ProcessingTimeSpanMs	int64
ProcessingFailedTime	date-time
ProcessingRetryCount	int32
CreatedAt	date-time
LastUpdated	date-time
TenantId	string

Expand

404

Not Found

Response

xxxxxxxxxx
 
[ {  "Id": "{string}",  "ScanId": "{string}",  "StorageId": "{string}",  "ScanWorkflowSnapshotId": "{string}",  "MetaDefenderCoreUrl": "{string}",  "Name": "{string}",  "Path": "{string}",  "Hash": "{string}",  "ObjectStorageMetadata": "{string}",  "Size": "{int64}",  "LastModified": "{date-time}",  "StorageLocation": "{string}",  "PathForDisplay": "{string}",  "ObjectIdentityId": "{string}",  "ObjectIdentityHash": "{string}",  "ScanResultId": "{string}",  "ProgressUpload": "{int32}",  "ProgressScan": "{int32}",  "ProcessingState": "{string}",  "ExceptionDetails": "{string}",  "Created": "{date-time}",  "DiscoveryStarted": "{date-time}",  "DiscoveryStartedDaySec": "{int64}",  "StreamingStartedTime": "{date-time}",  "StreamingCompletedTime": "{date-time}",  "StreamingTimeSpanMs": "{int64}",  "ScanCompletedTime": "{date-time}",  "ProcessingTimeSpanMs": "{int64}",  "ProcessingFailedTime": "{date-time}",  "ProcessingRetryCount": "{int32}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}",  "TenantId": "{string}" }]
Copy

Get the core result of a file by its scan result ID

Auth

Path Params

scanResultId string

GET /api/v1/scans/{scanResultId}/core-result

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7BscanResultId%7D/core-result' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
extracted_files	object
data_id	string
scan_result_i	int32
detected_by	int32
files_in_archive	array[object]
display_name	string
data_id	string
file_type	string
file_type_description	string
scan_result_i	int32
scan_all_result_i	int32
detected_by	int32
scanned_with	int32
progress_percentage	int32
file_size	int64
process_info	object
post_processing	object
actions_ran	string
actions_failed	string
converted_to	string
copy_move_destination	string
converted_destination	string
sanitization_details	object
failure_category	string
progress_percentage	int32
user_agent	string
profile	string
result	string
blocked_reason	string
file_type_skipped_scan	boolean
processing_time	number
queue_time	number
files_extracted_count	int32
scan_results	object
scan_details	object
*	object
threat_found	string
scan_result_i	int32
def_time	string
scan_time	number
wait_time	number
eng_id	string
data_id	string
scan_all_result_i	int32
start_time	string
total_time	number
total_avs	int32
progress_percentage	int32
scan_all_result_a	string
file_info	object
file_size	int64
upload_timestamp	string
md5	string
sha1	string
sha256	string
file_type	string
file_type_category	string
file_type_description	string
file_type_id	string
file_type_extension	string
display_name	string
original_file_path	string
process_info	object
post_processing	object
actions_ran	string
actions_failed	string
converted_to	string
copy_move_destination	string
converted_destination	string
sanitization_details	object
failure_category	string
progress_percentage	int32
user_agent	string
profile	string
result	string
blocked_reason	string
file_type_skipped_scan	boolean
processing_time	number
queue_time	number
data_id	string
source	string
scanned_on	string
dlp_info	object
hits	integer
verdict	int64
sbom_info	object
final_verdict	object
blocked	boolean
licensing_package_counts	object
allowed	int32
blocked	int32
unknown	int32
unsupported	int32
severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
total_package_count	int32
verdict	string
verdict_explanation	array[string]
vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
vulnerable_package_count	int32
overview_report	object
is_partial_report	boolean
os_info	object
os_name	string
os_version	string
scan_mode	string
steps	array[object]
command	string
license_status	string
licensing_package_counts	object
allowed	int32
blocked	int32
unknown	int32
unsupported	int32
packages	array[object]
authors	string
release_date	string
arch	string
ecosystem	string
group	string
archive	boolean
executable	boolean
uid	string
os_name	string
os_version	string
package_name	string
package_version	string
package_type	string
up_to_date	boolean
step	int32
vulnerability_count	int32
vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
dependencies_vulnerability_count	int32
dependencies_vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
sha256	string
severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
package_count	int32
vulnerable_dependencies_package_count	int32
vulnerable_package_count	int32
packages	array[object]
authors	string
release_date	string
ecosystem	string
group	string
archive	boolean
executable	boolean
uid	string
licenses	object
allowed	array[object]
id	string
url	string
category	string
usage_restriction	object
permissions	array[string]
conditions	array[string]
limitations	array[string]
blocked	array[object]
id	string
url	string
category	string
usage_restriction	object
permissions	array[string]
conditions	array[string]
limitations	array[string]
package_name	string
package_version	string
target	string
latest	object
version	string
release_date	string
hashes	array[object]
sha256	string
file_name	string
vulnerabilities	array[object]
id	string
severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
source	string
fixed_versions	string
cwes	array[string]
type	string
vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
dependencies	array[object]
ecosystem	string
group	string
package_name	string
package_version	string
vulnerabilities	array[object]
id	string
severity	string	Enum: `None`,`Critical`,`High`,`Medium`,`Low`,`Unknown`
source	string
fixed_versions	string
cwes	array[string]
type	string
vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
package_type	string
up_to_date	boolean
dependencies_package_count	int32
dependencies_vulnerability_count	int32
dependencies_vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
vulnerability_count	int32
vulnerability_counts	object
critical	int32
high	int32
medium	int32
low	int32
unknown	int32
has_pe_info	boolean
package_count	int32
timestamp	string
vulnerable_dependencies_package_count	int32
vulnerable_package_count	int32
result_template_hash	string
vulnerability_info	object
result	object
code	int64
hash	string
method	int64
timestamp	string
timing	int64
detected_product	object
has_vulnerability	boolean
is_current	boolean
product	object
id	int64
name	string
remediation_link	string
severity	string
sig_name	string
signature	int64
vendor	object
id	int64
name	string
version	string
version_data	object
count_behind	int64
feed_id	int64
version	string
vulnerabilities	array[object]
description	string
details	object
cpe	string
cve	string
cvss	object
access-complexity	string
access-vector	string
authentication	string
availability-impact	string
confidentiality-impact	string
generated-on-epoch	string
integrity-impact	string
score	string
source	string
cvss_3_0	object
attack_complexity	string
attack_vector	string
availability_impact	string
base_score	string
base_severity	string
confidentiality_impact	string
exploitability_score	string
impact_score	string
integrity_impact	string
privileges_required	string
scope	string
user_interaction	string
vector_string	string
cwe	string
last-modified-epoch	string
published-epoch	string
references	array[string]
severity	string
severity_index	int32
static_id	int64
engine_stat	object
*	array[object]
abandoned	boolean
active	boolean
def_time	string
download_progress	int32
download_time	date-time
eng_id	string
eng_name	string
eng_type	string
eng_ver	string
engine_type	string
pinned	boolean
state	string
type	string
db_ver	string
SessionCookie	string
IsFailed	boolean

Expand

Response

xxxxxxxxxx
 
{
 "extracted_files": {...},
 "scan_results": {...},
 "file_info": {...},
 "process_info": {...},
 "data_id": "{string}", "source": "{string}", "scanned_on": "{string}", "dlp_info": {...},
 "sbom_info": {...},
 "vulnerability_info": {...},
 "engine_stat": {}, "SessionCookie": "{string}", "IsFailed": "{boolean}"}
Copy

Get the core results of files in an archive by their scan result ID

Auth

Path Params

scanResultId string

Query String

count	integer
offset	integer

GET /api/v1/scans/{scanResultId}/archive

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/scans/%7BscanResultId%7D/archive' \ --header 'Authorization: Bearer {token}' \ --data count={count} \ --data offset={offset}
Copy

Responses

200

Success

object	object
CoreScanResults	array[object]
ExtractedFiles	object
DataId	string
ScanResultI	int32
DetectedBy	int32
FilesInArchive	array[object]
DisplayName	string
DataId	string
FileType	string
FileTypeDescription	string
ScanResultI	int32
ScanAllResultI	int32
DetectedBy	int32
ScannedWith	int32
ProgressPercentage	int32
FileSize	int64
ProcessInfo	object
PostProcessing	object
ActionsRan	string
ActionsFailed	string
ConvertedTo	string
CopyMoveDestination	string
ConvertedDestination	string
SanitizationDetails	object
FailureCategory	string
ProgressPercentage	int32
UserAgent	string
Profile	string
Result	string
BlockedReason	string
FileTypeSkippedScan	boolean
ProcessingTime	number
QueueTime	number
FilesExtractedCount	int32
ScanResults	object
ScanDetails	object
*	object
ThreatFound	string
ScanResultI	int32
DefTime	string
ScanTime	number
WaitTime	number
EngId	string
DataId	string
ScanAllResultI	int32
StartTime	string
TotalTime	number
TotalAvs	int32
ProgressPercentage	int32
ScanAllResultA	string
FileInfo	object
FileSize	int64
UploadTimestamp	string
Md5	string
Sha1	string
Sha256	string
FileTypeCategory	string
FileTypeCategoryCloud	string
FileTypeDescription	string
FileTypeExtension	string
FileTypeExtensionCloud	string
DisplayName	string
OriginalFilePath	string
ProcessInfo	object
PostProcessing	object
ActionsRan	string
ActionsFailed	string
ConvertedTo	string
CopyMoveDestination	string
ConvertedDestination	string
SanitizationDetails	object
FailureCategory	string
ProgressPercentage	int32
UserAgent	string
Profile	string
Result	string
BlockedReason	string
FileTypeSkippedScan	boolean
ProcessingTime	number
QueueTime	number
DataId	string
Source	string
ScannedOn	string
DlpInfo	object
Hits	object
DisplayName	string
Hits	array[object]
After	string
Before	string
Hit	string
Certainty	string
CertaintyScore	int64
Severity	string	Enum: `Detected`,`Suspicious`
Verdict	int64
SbomInfo	object
FinalVerdict	object
Blocked	boolean
Severity	string	Enum: `Unknown`,`Low`,`Medium`,`High`,`Critical`
Verdict	string
OverviewReport	object
Steps	array[object]
Command	string
Packages	array[object]
Authors	string
Arch	string
Ecosystem	string
Group	string
Archive	boolean
Executable	boolean
Uid	string
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
OsName	string
Latest	object
Version	string
Hashes	array[object]
Sha256	string
Vulnerabilities	array[object]
Id	string
Source	string
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
Dependencies	array[object]
Ecosystem	string
Group	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
UpToDate	boolean
Step	int32
Sha256	string
Severity	string	Enum: `Unknown`,`Low`,`Medium`,`High`,`Critical`
Packages	array[object]
Authors	string
Ecosystem	string
Group	string
Archive	boolean
Executable	boolean
Uid	string
Licenses	object
Allowed	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Blocked	array[object]
Id	string
Url	string
Category	string
UsageRestriction	object
Permissions	array[string]
Conditions	array[string]
Limitations	array[string]
Target	string
Latest	object
Version	string
Hashes	array[object]
Sha256	string
Vulnerabilities	array[object]
Id	string
Source	string
Cwes	array[string]
Type	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
Dependencies	array[object]
Ecosystem	string
Group	string
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
UpToDate	boolean
VulnerabilityCount	int32
VulnerabilityCounts	object
Critical	int32
High	int32
Medium	int32
Low	int32
Unknown	int32
HasPeInfo	boolean
Timestamp	string
VulnerabilityInfo	object
VulnerabilityInfoResult	object
Code	int64
Hash	string
Method	int64
TimeStamp	string
Timing	int64
DetectedProduct	object
HasVulnerability	boolean
IsCurrent	boolean
Product	object
Id	int64
Name	string
RemediationLink	string
Severity	string
SigName	string
Signature	int64
Vendor	object
Id	int64
Name	string
Version	string
VersionData	object
CountBehind	int64
FeedId	int64
Version	string
Vulnerabilities	array[object]
Description	string
Details	object
Cpe	string
Cve	string
Cvss	object
AccessComplexity	string
AccessVector	string
Authentication	string
AvailabilityImpact	string
ConfidentialityImpact	string
GeneratedOnEpoch	string
IntegrityImpact	string
Score	string
Source	string
Cvss3	object
AttackComplexity	string
AttackVector	string
AvailabilityImpact	string
BaseScore	string
BaseSeverity	string
ConfidentialityImpact	string
ExploitabilityScore	string
ImpactScore	string
IntegrityImpact	string
PrivilegesRequired	string
Scope	string
UserInteraction	string
VectorString	string
Cwe	string
LastModifiedEpoch	string
PublishedEpoch	string
References	array[string]
Severity	string
SeverityIndex	int32
StaticId	int64
Engines	object
*	array[object]
Abandoned	boolean
Active	boolean
DefTime	string
DownloadProgress	int32
EngId	string
EngName	string
EngType	string
EngineVersion	string
EngineType	string
Pinned	boolean
State	string
Type	string
DbVer	string
SessionCookie	string
IsFailed	boolean
HasMore	boolean

Expand

Response

xxxxxxxxxx
 
{
 "CoreScanResults": [...],
 "HasMore": "{boolean}"}
Copy

Settings

/api/v1/jira/{id}/projects

Get the SMTP configuration

Auth

GET /api/v1/smtp

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/smtp' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Smtp	object
Id	string
Host	string
Port	int32
SenderAddress	string
SenderName	string
Domain	string
BaseUrl	string
UserName	string
Password	string
SecureSocketOption	string	Enum: `None`,`Auto`,`SslOnConnect`,`StartTls`,`StartTlsWhenAvailable`
IgnoreCertWarnings	boolean
IsEnabled	boolean
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Smtp": {  "Id": "{string}",  "Host": "{string}",  "Port": "{int32}",  "SenderAddress": "{string}",  "SenderName": "{string}",  "Domain": "{string}",  "BaseUrl": "{string}",  "UserName": "{string}",  "Password": "{string}",  "SecureSocketOption": "{string}",  "IgnoreCertWarnings": "{boolean}",  "IsEnabled": "{boolean}",  "TenantId": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}" }}
Copy

Update the SMTP configuration

Auth

Request Body

object	object
Host	string
BaseUrl	string
Port	int32
SenderAddress	string
SenderName	string
Domain	string
Username	string
Password	string
SecureSocketOption	string	Enum: `None`,`Auto`,`SslOnConnect`,`StartTls`,`StartTlsWhenAvailable`
IgnoreCertWarnings	boolean
IsEnabled	boolean

POST /api/v1/smtp

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/smtp' \ --header 'Authorization: Bearer {token}' \ --data '{  "Host": "{string}",  "BaseUrl": "{string}",  "Port": "{int32}",  "SenderAddress": "{string}",  "SenderName": "{string}",  "Domain": "{string}",  "Username": "{string}",  "Password": "{string}",  "SecureSocketOption": "{string}",  "IgnoreCertWarnings": "{boolean}",  "IsEnabled": "{boolean}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Get All Jira Configurations

Auth

GET /api/v1/jira

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/jira' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
JiraEntries	array[object]
Id	string
Name	string
ApiKey	string
BaseAddress	string
ProductAddress	string
Username	string
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "JiraEntries": [  {   "Id": "{string}",   "Name": "{string}",   "ApiKey": "{string}",   "BaseAddress": "{string}",   "ProductAddress": "{string}",   "Username": "{string}",   "TenantId": "{string}",   "CreatedAt": "{date-time}",   "LastUpdated": "{date-time}"  } ]}
Copy

Add Jira Configuration

Auth

Request Body

object	object
Name	string
ApiKey	string
BaseAddress	string
ProductAddress	string
Username	string

POST /api/v1/jira

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/jira' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "ApiKey": "{string}",  "BaseAddress": "{string}",  "ProductAddress": "{string}",  "Username": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Get Jira Configuration by ID

Auth

Path Params

id string

GET /api/v1/jira/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/jira/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Jira	object
Id	string
Name	string
ApiKey	string
BaseAddress	string
ProductAddress	string
Username	string
TenantId	string
CreatedAt	date-time
LastUpdated	date-time

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Jira": {  "Id": "{string}",  "Name": "{string}",  "ApiKey": "{string}",  "BaseAddress": "{string}",  "ProductAddress": "{string}",  "Username": "{string}",  "TenantId": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}" }}
Copy

Update Jira Configuration by ID

Auth

Path Params

id string

Request Body

object	object
Name	string
ApiKey	string
BaseAddress	string
ProductAddress	string
Username	string

PUT /api/v1/jira/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/jira/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "ApiKey": "{string}",  "BaseAddress": "{string}",  "ProductAddress": "{string}",  "Username": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Delete Jira Configuration by ID

Auth

Path Params

id string

DELETE /api/v1/jira/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/jira/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
JiraId	string

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "JiraId": "{string}"}
Copy

Get Jira Projects by Connection ID

Auth

Path Params

id string

GET /api/v1/jira/{id}/projects

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/jira/%7Bid%7D/projects' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Projects	array[object]
Id	string
Name	string

404

Not Found

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Projects": [  {   "Id": "{string}",   "Name": "{string}"  } ]}
Copy

Users

Manage your users

/api/v1/users/{userId}

/api/v1/user/login

/api/v1/user/login/{userId}

/api/v1/user/token

/api/v1/user/password/request-reset

/api/v1/user/password/new-password

Get users

Auth

Query String

Type	string	Enum: `ActiveUsers`,`NewUsers`
StartIndex	integer
Count	integer
SearchTerm	string

GET /api/v1/users

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/users' \ --header 'Authorization: Bearer {token}' \ --data Type={Type} \ --data StartIndex={StartIndex} \ --data Count={Count} \ --data SearchTerm={SearchTerm}
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
EnumerateUsersDto	object
Entries	array[object]
UserId	string
Username	string
FullName	string
Email	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`
ShowTutorial	boolean
TotalCount	int64

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "EnumerateUsersDto": {  "Entries": [   {    "UserId": "{string}",    "Username": "{string}",    "FullName": "{string}",    "Email": "{string}",    "Role": "{string}",    "ShowTutorial": "{boolean}"   }  ],  "TotalCount": "{int64}" }}
Copy

Update a user

Auth

Request Body

object	object
UserId	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`
UserName	string
FullName	string
Email	string
CurrentPassword	string
NewPassword	string
ShowTutorial	boolean

PUT /api/v1/users

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/users' \ --header 'Authorization: Bearer {token}' \ --data '{  "UserId": "{string}",  "Role": "{string}",  "UserName": "{string}",  "FullName": "{string}",  "Email": "{string}",  "CurrentPassword": "{string}",  "NewPassword": "{string}",  "ShowTutorial": "{boolean}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Add a new user

Auth

Request Body

object	object
FullName	string
UserName	string
Password	string
Email	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`

POST /api/v1/users

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/users' \ --header 'Authorization: Bearer {token}' \ --data '{  "FullName": "{string}",  "UserName": "{string}",  "Password": "{string}",  "Email": "{string}",  "Role": "{string}"}'
Copy

Responses

200

Success

object	object
CreateUserParameters	object
FullName	string
UserName	string
Password	string
Email	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`
CurrentUserId	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "CreateUserParameters": {  "FullName": "{string}",  "UserName": "{string}",  "Password": "{string}",  "Email": "{string}",  "Role": "{string}" }, "CurrentUserId": "{string}"}
Copy

Get current user

Auth

GET /api/v1/user

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/user' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
UserDto	object
UserId	string
Username	string
FullName	string
Email	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`
ShowTutorial	boolean

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "UserDto": {  "UserId": "{string}",  "Username": "{string}",  "FullName": "{string}",  "Email": "{string}",  "Role": "{string}",  "ShowTutorial": "{boolean}" }}
Copy

Delete a user

Auth

Path Params

userId string

DELETE /api/v1/users/{userId}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/users/%7BuserId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Login user

Auth

Request Body

object	object
Username	string
Password	string

POST /api/v1/user/login

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/user/login' \ --header 'Authorization: Bearer {token}' \ --data '{  "Username": "{string}",  "Password": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
JwtToken	object
Token	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "JwtToken": {  "Token": "{string}" }}
Copy

It will remove all tokens of this user

Auth

Path Params

userId string

DELETE /api/v1/user/login/{userId}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/user/login/%7BuserId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Get new Access Token

Auth

Request Body

object	object
AccessToken	string

PUT /api/v1/user/token

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/user/token' \ --header 'Authorization: Bearer {token}' \ --data '{  "AccessToken": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
JwtToken	object
Token	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "JwtToken": {  "Token": "{string}" }}
Copy

Request password reset

Auth

Request Body

object	object
EmailInput	string	minLength: 1

POST /api/v1/user/password/request-reset

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/user/password/request-reset' \ --header 'Authorization: Bearer {token}' \ --data '{  "EmailInput": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Reset user password

Auth

Request Body

object	object
NewPassword	string	minLength: 12
NewPasswordConfirmation	string	minLength: 12
SecureToken	string
UserId	string

POST /api/v1/user/password/new-password

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/user/password/new-password' \ --header 'Authorization: Bearer {token}' \ --data '{  "NewPassword": "{string}",  "NewPasswordConfirmation": "{string}",  "SecureToken": "{string}",  "UserId": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
User	object
UserId	string
Username	string
FullName	string
Email	string
Role	string	Enum: `None`,`ReadOnlyAdministrator`,`Administrator`,`SsoAdministrator`,`SsoReadOnlyAdministrator`,`TenantAdministrator`,`Invalid`
ShowTutorial	boolean

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "User": {  "UserId": "{string}",  "Username": "{string}",  "FullName": "{string}",  "Email": "{string}",  "Role": "{string}",  "ShowTutorial": "{boolean}" }}
Copy

Version

Manage versions

/api/v1/version

Get application version

Auth

GET /api/v1/version

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/version' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
Version	string
LastSupportedConfigVersion	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "Version": "{string}", "LastSupportedConfigVersion": "{string}"}
Copy

Webhook

Manage your scans

/api/v1/webhook/hmac/{routeParameter}

/api/v1/webhook/{routeParameter}

Handle No-Auth Scan Event

Handles a scan event triggered by a webhook. Requires a custom header and a body.

Auth

Path Params

routeParameter string

Request Body

No request body

POST /api/v1/webhook/hmac/{routeParameter}

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/webhook/hmac/%7BrouteParameter%7D' \ --header 'X-Hub-Signature: {X-Hub-Signature}'
Copy

Responses

200

Success

No response body

400

Bad Request

500

Server Error

Response

xxxxxxxxxx
 
No response
Copy

Handle Scan Event

Handles a scan event triggered by a webhook. Requires a custom body.

Auth

Path Params

routeParameter string

Request Body

No request body

POST /api/v1/webhook/{routeParameter}

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/webhook/%7BrouteParameter%7D' \ --header 'API Key: {API Key}'
Copy

Responses

200

Success

No response body

400

Bad Request

500

Server Error

Response

xxxxxxxxxx
 
No response
Copy

Workflows

Manage workflows

/api/v1/workflows/{id}

/api/v1/workflows/{id}

/api/v1/workflows/{id}

/api/v1/workflows/{id}/scan-source

/api/v1/workflows/repositories/{repositoryId}

List all workflows

Auth

Query String

includeDeleted boolean

GET /api/v1/workflows

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/workflows' \ --header 'Authorization: Bearer {token}' \ --data includeDeleted={includeDeleted}
Copy

Responses

200

Success

array	array[object]
Id	string
Name	string
Description	string
UserId	string
ScanConfigurationId	string
Deleted	boolean
Type	string	Enum: `SourceCode`,`Container`,`Binary`,`Default`
RecurrencePattern	object
Type	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
HourlyRecurrence	object
EveryNumberOfHours	int32
DailyRecurrence	object
EveryNumberOfDays	int32
WeeklyRecurrence	object
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
EveryNumberOfWeeks	int32
MonthlyRecurrence	object
EveryNumberOfMonths	int32
DayOfMonth	int32
ScanSources	array[object]
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]
Remediations	array[object]
IsEnabled	boolean
Type	string
FileDiscoveryFilterConfiguration	object
IsEnabled	boolean
DaysBeforeRescan	int32
FilterStrategy	string	Enum: `None`,`HashMatch`

Expand

Response

xxxxxxxxxx
 
[ {  "Id": "{string}",  "Name": "{string}",  "Description": "{string}",  "UserId": "{string}",  "ScanConfigurationId": "{string}",  "Deleted": "{boolean}",  "Type": "{string}",  "RecurrencePattern": {   "Type": "{string}",   "HourlyRecurrence": {    "EveryNumberOfHours": "{int32}"   },   "DailyRecurrence": {    "EveryNumberOfDays": "{int32}"   },   "WeeklyRecurrence": {    "DaysOfWeek": [     "{array[string]...}"    ],    "EveryNumberOfWeeks": "{int32}"   },   "MonthlyRecurrence": {    "EveryNumberOfMonths": "{int32}",    "DayOfMonth": "{int32}"   }  },  "ScanSources": [   {    "ServiceId": "{string}",    "ServiceName": "{string}",    "Repositories": [     {      "RepositoryId": "{string}",      "RepositoryName": "{string}",      "Type": "{string}",      "Connection": "{string}",      "PackageType": "{string}",      "Organization": "{string}",      "Registry": "{string}",      "ReferencesToScan": [       "{array[string]...}"      ]     }    ]   }  ],  "Remediations": [   {    "IsEnabled": "{boolean}",    "Type": "{string}"   }  ],  "FileDiscoveryFilterConfiguration": {   "IsEnabled": "{boolean}",   "DaysBeforeRescan": "{int32}",   "FilterStrategy": "{string}"  } }]
Copy

Expand

Create a workflow

Auth

Request Body

object	object
Name	string
Description	string
ScanConfigurationId	string
Type	string	Enum: `SourceCode`,`Container`,`Binary`,`Default`
RecurrencePattern	object
Type	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
HourlyRecurrence	object
EveryNumberOfHours	int32
DailyRecurrence	object
EveryNumberOfDays	int32
WeeklyRecurrence	object
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
EveryNumberOfWeeks	int32
MonthlyRecurrence	object
EveryNumberOfMonths	int32
DayOfMonth	int32
ScanSources	array[object]
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]
Remediations	array[object]
IsEnabled	boolean
Type	string
FileDiscoveryFilterConfiguration	object
IsEnabled	boolean
DaysBeforeRescan	int32
FilterStrategy	string	Enum: `None`,`HashMatch`

Expand

POST /api/v1/workflows

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/workflows' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Description": "{string}",  "ScanConfigurationId": "{string}",  "Type": "{string}",  "RecurrencePattern": {    "Type": "{string}",    "HourlyRecurrence": {      "EveryNumberOfHours": "{int32}"    },    "DailyRecurrence": {      "EveryNumberOfDays": "{int32}"    },    "WeeklyRecurrence": {      "DaysOfWeek": [        "{array[string]...}"      ],      "EveryNumberOfWeeks": "{int32}"    },    "MonthlyRecurrence": {      "EveryNumberOfMonths": "{int32}",      "DayOfMonth": "{int32}"    }  },  "ScanSources": [    {      "ServiceId": "{string}",      "ServiceName": "{string}",      "Repositories": [        {          "RepositoryId": "{string}",          "RepositoryName": "{string}",          "Type": "{string}",          "Connection": "{string}",          "PackageType": "{string}",          "Organization": "{string}",          "Registry": "{string}",          "ReferencesToScan": [            "{array[string]...}"          ]        }      ]    }  ],  "Remediations": [    {      "IsEnabled": "{boolean}",      "Type": "{string}"    }  ],  "FileDiscoveryFilterConfiguration": {    "IsEnabled": "{boolean}",    "DaysBeforeRescan": "{int32}",    "FilterStrategy": "{string}"  }}'
Copy

Expand

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Get workflow by Id

Auth

Path Params

id string

GET /api/v1/workflows/{id}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/workflows/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Id	string
Name	string
Description	string
UserId	string
ScanConfigurationId	string
Deleted	boolean
Type	string	Enum: `SourceCode`,`Container`,`Binary`,`Default`
RecurrencePattern	object
Type	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
HourlyRecurrence	object
EveryNumberOfHours	int32
DailyRecurrence	object
EveryNumberOfDays	int32
WeeklyRecurrence	object
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
EveryNumberOfWeeks	int32
MonthlyRecurrence	object
EveryNumberOfMonths	int32
DayOfMonth	int32
ScanSources	array[object]
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]
Remediations	array[object]
IsEnabled	boolean
Type	string
FileDiscoveryFilterConfiguration	object
IsEnabled	boolean
DaysBeforeRescan	int32
FilterStrategy	string	Enum: `None`,`HashMatch`

Expand

Response

xxxxxxxxxx
 
{ "Id": "{string}", "Name": "{string}", "Description": "{string}", "UserId": "{string}", "ScanConfigurationId": "{string}", "Deleted": "{boolean}", "Type": "{string}", "RecurrencePattern": {  "Type": "{string}",  "HourlyRecurrence": {   "EveryNumberOfHours": "{int32}"  },  "DailyRecurrence": {   "EveryNumberOfDays": "{int32}"  },  "WeeklyRecurrence": {   "DaysOfWeek": [    "{array[string]...}"   ],   "EveryNumberOfWeeks": "{int32}"  },  "MonthlyRecurrence": {   "EveryNumberOfMonths": "{int32}",   "DayOfMonth": "{int32}"  } }, "ScanSources": [  {   "ServiceId": "{string}",   "ServiceName": "{string}",   "Repositories": [    {     "RepositoryId": "{string}",     "RepositoryName": "{string}",     "Type": "{string}",     "Connection": "{string}",     "PackageType": "{string}",     "Organization": "{string}",     "Registry": "{string}",     "ReferencesToScan": [      "{array[string]...}"     ]    }   ]  } ], "Remediations": [  {   "IsEnabled": "{boolean}",   "Type": "{string}"  } ], "FileDiscoveryFilterConfiguration": {  "IsEnabled": "{boolean}",  "DaysBeforeRescan": "{int32}",  "FilterStrategy": "{string}" }}
Copy

Expand

Update a workflow

Auth

Path Params

id string

Request Body

object	object
Name	string
Description	string
ScanConfigurationId	string
RecurrencePattern	object
Type	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
HourlyRecurrence	object
EveryNumberOfHours	int32
DailyRecurrence	object
EveryNumberOfDays	int32
WeeklyRecurrence	object
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
EveryNumberOfWeeks	int32
MonthlyRecurrence	object
EveryNumberOfMonths	int32
DayOfMonth	int32
ScanSources	array[object]
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]
Remediations	array[object]
IsEnabled	boolean
Type	string
FileDiscoveryFilterConfiguration	object
IsEnabled	boolean
DaysBeforeRescan	int32
FilterStrategy	string	Enum: `None`,`HashMatch`

Expand

PUT /api/v1/workflows/{id}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/workflows/%7Bid%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Description": "{string}",  "ScanConfigurationId": "{string}",  "RecurrencePattern": {    "Type": "{string}",    "HourlyRecurrence": {      "EveryNumberOfHours": "{int32}"    },    "DailyRecurrence": {      "EveryNumberOfDays": "{int32}"    },    "WeeklyRecurrence": {      "DaysOfWeek": [        "{array[string]...}"      ],      "EveryNumberOfWeeks": "{int32}"    },    "MonthlyRecurrence": {      "EveryNumberOfMonths": "{int32}",      "DayOfMonth": "{int32}"    }  },  "ScanSources": [    {      "ServiceId": "{string}",      "ServiceName": "{string}",      "Repositories": [        {          "RepositoryId": "{string}",          "RepositoryName": "{string}",          "Type": "{string}",          "Connection": "{string}",          "PackageType": "{string}",          "Organization": "{string}",          "Registry": "{string}",          "ReferencesToScan": [            "{array[string]...}"          ]        }      ]    }  ],  "Remediations": [    {      "IsEnabled": "{boolean}",      "Type": "{string}"    }  ],  "FileDiscoveryFilterConfiguration": {    "IsEnabled": "{boolean}",    "DaysBeforeRescan": "{int32}",    "FilterStrategy": "{string}"  }}'
Copy

Expand

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Delete Workflow by id

Auth

Path Params

id string

DELETE /api/v1/workflows/{id}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/workflows/%7Bid%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Update workflow scan source

Auth

Path Params

id string

Request Body

object	object
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]

PUT /api/v1/workflows/{id}/scan-source

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/workflows/%7Bid%7D/scan-source' \ --header 'Authorization: Bearer {token}' \ --data '{  "ServiceId": "{string}",  "ServiceName": "{string}",  "Repositories": [    {      "RepositoryId": "{string}",      "RepositoryName": "{string}",      "Type": "{string}",      "Connection": "{string}",      "PackageType": "{string}",      "Organization": "{string}",      "Registry": "{string}",      "ReferencesToScan": [        "{array[string]...}"      ]    }  ]}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

List all workflows by repositoryId

Auth

Path Params

repositoryId string

GET /api/v1/workflows/repositories/{repositoryId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/workflows/repositories/%7BrepositoryId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

array	array[object]
Id	string
Name	string
Description	string
UserId	string
ScanConfigurationId	string
Deleted	boolean
Type	string	Enum: `SourceCode`,`Container`,`Binary`,`Default`
RecurrencePattern	object
Type	string	Enum: `Hourly`,`Daily`,`Weekly`,`Monthly`
HourlyRecurrence	object
EveryNumberOfHours	int32
DailyRecurrence	object
EveryNumberOfDays	int32
WeeklyRecurrence	object
DaysOfWeek	array[string]	Enum: `Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`
EveryNumberOfWeeks	int32
MonthlyRecurrence	object
EveryNumberOfMonths	int32
DayOfMonth	int32
ScanSources	array[object]
ServiceId	string
ServiceName	string
Repositories	array[object]
RepositoryId	string
RepositoryName	string
Type	string
Connection	string
PackageType	string
Organization	string
Registry	string
ReferencesToScan	array[string]
Remediations	array[object]
IsEnabled	boolean
Type	string
FileDiscoveryFilterConfiguration	object
IsEnabled	boolean
DaysBeforeRescan	int32
FilterStrategy	string	Enum: `None`,`HashMatch`

Expand

Response

xxxxxxxxxx
 
[ {  "Id": "{string}",  "Name": "{string}",  "Description": "{string}",  "UserId": "{string}",  "ScanConfigurationId": "{string}",  "Deleted": "{boolean}",  "Type": "{string}",  "RecurrencePattern": {   "Type": "{string}",   "HourlyRecurrence": {    "EveryNumberOfHours": "{int32}"   },   "DailyRecurrence": {    "EveryNumberOfDays": "{int32}"   },   "WeeklyRecurrence": {    "DaysOfWeek": [     "{array[string]...}"    ],    "EveryNumberOfWeeks": "{int32}"   },   "MonthlyRecurrence": {    "EveryNumberOfMonths": "{int32}",    "DayOfMonth": "{int32}"   }  },  "ScanSources": [   {    "ServiceId": "{string}",    "ServiceName": "{string}",    "Repositories": [     {      "RepositoryId": "{string}",      "RepositoryName": "{string}",      "Type": "{string}",      "Connection": "{string}",      "PackageType": "{string}",      "Organization": "{string}",      "Registry": "{string}",      "ReferencesToScan": [       "{array[string]...}"      ]     }    ]   }  ],  "Remediations": [   {    "IsEnabled": "{boolean}",    "Type": "{string}"   }  ],  "FileDiscoveryFilterConfiguration": {   "IsEnabled": "{boolean}",   "DaysBeforeRescan": "{int32}",   "FilterStrategy": "{string}"  } }]
Copy

Expand

Licenses

/api/v1/licenses/online

Get licenses

Auth

GET /api/v1/licenses

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/licenses' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`NotFound`,`Error`
License	object
ProductId	string
ProductName	string
Expiration	int64
DeploymentId	string
ActivationKey	string
LicenseContent	string
MaxDevelopers	int32
ResponseMessage	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "License": {  "ProductId": "{string}",  "ProductName": "{string}",  "Expiration": "{int64}",  "DeploymentId": "{string}",  "ActivationKey": "{string}",  "LicenseContent": "{string}",  "MaxDevelopers": "{int32}" }, "ResponseMessage": "{string}"}
Copy

Remove licenses

Auth

DELETE /api/v1/licenses

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/licenses' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`FailedToDeactivate`,`FailedToDeactivateDeploymentIdMalformed`,`NotFound`
ResponseMessage	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseMessage": "{string}"}
Copy

Activate a online license

Auth

Request Body

object	object
Key	string	minLength: 1

POST /api/v1/licenses/online

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/licenses/online' \ --header 'Authorization: Bearer {token}' \ --data '{  "Key": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`FailedToActivate`
ResponseMessage	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseMessage": "{string}"}
Copy

Ocm

Get OCM

Auth

GET /api/v1/ocm

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/ocm' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
OcmInformation	object
Id	string
ApiKey	string
ServerApi	string
RegistrationCode	string
DeploymentId	string
CmVersion	string
ScanConfigurationHash	string
StorageConfigurationHash	string
RetentionConfigurationHash	string
ExternalLoggerConfigurationHash	string
UserConfigurationHash	string
LicenseConfigurationHash	string
SmtpConfigurationHash	string
NotificationConfigurationHash	string
EnrollStatus	string	Enum: `NotEnrolled`,`Enrolled`
LastServerConnection	int64
LastConfigurationSync	int64
ConnectionStatus	string	Enum: `Disconnected`,`Connected`
CreatedAt	date-time
LastUpdated	date-time
TenantId	string

Expand

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "OcmInformation": {  "Id": "{string}",  "ApiKey": "{string}",  "ServerApi": "{string}",  "RegistrationCode": "{string}",  "DeploymentId": "{string}",  "CmVersion": "{string}",  "ScanConfigurationHash": "{string}",  "StorageConfigurationHash": "{string}",  "RetentionConfigurationHash": "{string}",  "ExternalLoggerConfigurationHash": "{string}",  "UserConfigurationHash": "{string}",  "LicenseConfigurationHash": "{string}",  "SmtpConfigurationHash": "{string}",  "NotificationConfigurationHash": "{string}",  "EnrollStatus": "{string}",  "LastServerConnection": "{int64}",  "LastConfigurationSync": "{int64}",  "ConnectionStatus": "{string}",  "CreatedAt": "{date-time}",  "LastUpdated": "{date-time}",  "TenantId": "{string}" }}
Copy

Update OCM

Auth

Request Body

object	object
ServerApi	string
RegCode	string

PUT /api/v1/ocm

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/ocm' \ --header 'Authorization: Bearer {token}' \ --data '{  "ServerApi": "{string}",  "RegCode": "{string}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Delete OCM

Auth

DELETE /api/v1/ocm

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/ocm' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}"}
Copy

Services

/api/v1/services/{serviceId}

/api/v1/services/{serviceId}

/api/v1/services/{serviceId}

/api/v1/services/{serviceId}/{repositoryId}/references

/api/v1/services/{serviceId}/references

/api/v1/services/{serviceId}/resources

/api/v1/services/references

Get all services

Auth

Query String

content	boolean
type	array	Enum: `GitHubSdk`,`DockerHubSdk`,`BitbucketSdk`,`AmazonEcrSdk`,`QuaySdk`,`JFrogContainerSdk`,`JFrogBinarySdk`,`AzureAcrSdk`,`GitLabSourceSdk`,`GitLabContainerSdk`,`SvnSdk`

GET /api/v1/services

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/services' \ --header 'Authorization: Bearer {token}' \ --data content={content} \ --data type={type}
Copy

Responses

200

Success

object	object
ServiceDtos	array[object]
Name	string
Id	string
CredentialsType	int32
ScanWorkflowId	string
Domain	string
StatusMessage	string

206

Success

400

Bad Request

Response

xxxxxxxxxx
 
{ "ServiceDtos": [  {   "Name": "{string}",   "Id": "{string}",   "CredentialsType": "{int32}",   "ScanWorkflowId": "{string}",   "Domain": "{string}"  } ], "StatusMessage": "{string}"}
Copy

Add a service

Auth

Request Body

object	object
Name	string
Credentials	string

POST /api/v1/services

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/services' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Credentials": "{string}"}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Id	string
Name	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Id": "{string}", "Name": "{string}"}
Copy

Get a service by id

Auth

Path Params

serviceId string

Query String

content	boolean
Search	string
Page	integer
PageSize	integer
FilterValue	string
Cursor	string
PrioritizedRepositoriesReference	string

GET /api/v1/services/{serviceId}

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D' \ --header 'Authorization: Bearer {token}' \ --data content={content} \ --data Search={Search} \ --data Page={Page} \ --data PageSize={PageSize} \ --data FilterValue={FilterValue} \ --data Cursor={Cursor} \ --data PrioritizedRepositoriesReference={PrioritizedRepositoriesReference}
Copy

Responses

200

Success

object	object
Name	string
Id	string
CredentialsType	int32
ScanWorkflowId	string
Domain	string

400

Bad Request

404

Not Found

Response

xxxxxxxxxx
 
{ "Name": "{string}", "Id": "{string}", "CredentialsType": "{int32}", "ScanWorkflowId": "{string}", "Domain": "{string}"}
Copy

Update a service by id

Auth

Path Params

serviceId string

Request Body

object	object
Name	string
Credentials	string
HasNewCredentials	boolean

PUT /api/v1/services/{serviceId}

xxxxxxxxxx
 
curl --request PUT \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D' \ --header 'Authorization: Bearer {token}' \ --data '{  "Name": "{string}",  "Credentials": "{string}",  "HasNewCredentials": "{boolean}"}'
Copy

Responses

200

Success

object	object
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string
Id	string
Name	string

400

Bad Request

Response

xxxxxxxxxx
 
{ "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}, "Id": "{string}", "Name": "{string}"}
Copy

Delete a service by id

Auth

Path Params

serviceId string

DELETE /api/v1/services/{serviceId}

xxxxxxxxxx
 
curl --request DELETE \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Result	string	Enum: `Success`,`Error`,`InternalError`,`NotFound`
ResponseKey	string
ResponseMessage	string
ResponseMessageParams	object
*	string

404

Not Found

Response

xxxxxxxxxx
 
{ "Result": "{string}", "ResponseKey": "{string}", "ResponseMessage": "{string}", "ResponseMessageParams": {}}
Copy

Get service references by serviceId and repositoryId

Auth

Path Params

serviceId	string
repositoryId	string

Query String

Page	integer
PageSize	integer
FilterValue	string
Cursor	string

GET /api/v1/services/{serviceId}/{repositoryId}/references

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D/%7BrepositoryId%7D/references' \ --header 'Authorization: Bearer {token}' \ --data Page={Page} \ --data PageSize={PageSize} \ --data FilterValue={FilterValue} \ --data Cursor={Cursor}
Copy

Responses

200

Success

object	object
References	array[string]
TotalReferences	int32

404

Not Found

Response

xxxxxxxxxx
 
{ "References": [  "{array[string]...}" ], "TotalReferences": "{int32}"}
Copy

Get service references by serviceId

Auth

Path Params

serviceId string

GET /api/v1/services/{serviceId}/references

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D/references' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
ServiceId	string
ServiceName	string

404

Not Found

Response

xxxxxxxxxx
 
{ "ServiceId": "{string}", "ServiceName": "{string}"}
Copy

Get service resources by serviceId

Auth

Path Params

serviceId string

GET /api/v1/services/{serviceId}/resources

xxxxxxxxxx
 
curl --get \ --url 'https://opswat.developerhub.io/api/v1/services/%7BserviceId%7D/resources' \ --header 'Authorization: Bearer {token}'
Copy

Responses

200

Success

object	object
Resources	array[string]

404

Not Found

Response

xxxxxxxxxx
 
{ "Resources": [  "{array[string]...}" ]}
Copy

Add services references

Auth

Request Body

array	array[object]
ServiceId	string
RepositoryIds	array[string]

POST /api/v1/services/references

xxxxxxxxxx
 
curl --request POST \ --url 'https://opswat.developerhub.io/api/v1/services/references' \ --header 'Authorization: Bearer {token}' \ --data '[  {    "ServiceId": "{string}",    "RepositoryIds": [      "{array[string]...}"    ]  }]'
Copy

Responses

200

Success

array	array[object]
ServiceId	string
ServiceName	string

204

No Content

404

Not Found

Response

xxxxxxxxxx
 
[ {  "ServiceId": "{string}",  "ServiceName": "{string}" }]
Copy

Startup