As of December 31st, 2023 ThreadFix 2.X has reached End of Life and is no longer supported. For any further information please contact the Success and Implementation team.

Submit Defect to Specified Tracker - API

/rest/{version}/applications/{appId}/appTrackers/{appTrackerId}/defectSubmission

Descriptor

Value

HTTP Method

POST

Description

Like Submit Defect API, except that this call works for applications with multiple defect trackers. 

Submits a defect to the tracker with the given appTrackerId attached to the application with the given appId.

Required Permission

Submit Defects

Version Introduced

2.4.0

Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

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

Request POST Data Parameters

The available Data Parameters depend on the Defect Tracker being used and can vary based on your configurations for the Defect Tracker.  Use the “Get Defect Tracker Fields for Specified Tracker” call to see what you will need.  The following parameters should always be available.

Parameter

Value

Required

Description

summary

String

Yes

Title of the Defect Tracker ticket submitted. 

AdditionalScannerInfo

String

No

Denotes if the defect should include extra fields specified in defectDescription.vm.

vulnerabilityIds

Integer

Yes

Ids for the vulnerabilities to file a defect for.  Only one defect is created and all the vulnerabilities are attached to it.

Example: vulnerabilityIds=75006&vulnerabilityIds=75007

DescriptionTemplate

String

No

Choose the description template, Filename e.g. Classic_Description.vm.

IncludeScannerDetail

String

No

True or False, checkbox for additional scanner detail.



In Jira if no issuetype is furnished, the submitted ticket will default to using issuetype=1 corresponding to Bug issue type Defect ticket. 



Sample Call:

curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" -X POST --data 'issuetype=1&summary=Defect Submitted Through REST API&project=10000&customfield_10500=Test of New Version&assignee=threadfix&vulnerabilityIds=23121&vulnerabilityIds=23149' http://localhost:8080/threadfix/rest/latest/applications/34/appTrackers/11/defectSubmission



Sample Output:



{     "message": "",     "success": true,     "responseCode": -1,     "object": "The Defect was submitted to the tracker." }



www.threadfix.it | www.coalfire.com
Copyright © 2024 Coalfire. All rights reserved.

This Information Security Policy is CoalFire - Public: Distribution of this material is not limited.