Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Note

This endpoint is only supported for the following scanners:

  • Checkmarx


/rest/remoteproviders/{remoteProviderAppId}/queueScan

 

Descriptor

Value

HTTP Method

POST

Description

Queues a scan for the Remote Provider application, using the source code repository stored in the ThreadFix application it is mapped to.

Restricted

true

 

Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.

 

Request POST Data Parameters

Parameter

Value

Required

Description

incremental

Boolean

No

default=false; If true then Checkmarx will execute an incremental scan, where it only checks files that have changed since the last scan.

sync

Boolean

No

default=false; If true the call will wait until the scan is reported finished by the remote provider before returning.

branchName

String

No

The name of the branch in the source repository to pull.

commitId

String

No

The ID of the commit in the source repository to pull.

tag

String

No

The name of the Tag in the source repository to pull.

 

Sample Call:

Code Block
themeEclipse
curl --insecure -H 'Accept: application/json' -X POST --data 'incremental=false&sync=true&branchName=master' http://localhost:8080/threadfix/rest/remoteproviders/2/queueScan?apiKey={apiKey}

 

Sample Output:


Code Block
themeEclipse
{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": "10060"
}


Page Tree
rootRemote Providers API