Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
/rest/{version}/applications/{appId}/addUrl
Descriptor | Value |
|---|---|
HTTP Method | POST |
Description | Sets the application’s URL. |
Required Permission | Manage Applications |
Version Introduced | 2.3.0 |
Changes in 2.5.1 | Adds the updatedDate field to the response. This field is present when using older REST versions as well. |
Changes in 2.7.5 | Added "testEnvironment", "releaseFrequency", and "isInternal" to the REST call response. |
Changes in 2.7.9 | Added "unassignedVulnCount" for unmapped severities. |
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 |
|---|---|---|---|
url | String | yes | The URL you want to assign to the application. |
Sample Call:
| Code Block | ||||
|---|---|---|---|---|
| ||||
curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" -X POST --data 'url=http://www.example-url.com' http://localhost:8080/threadfix/rest/latest/applications/1/addUrl |
Sample Output:
Values for importTime and updatedDate are returned as Epoch time in milliseconds.
| Code Block | theme | Eclipse
|---|
{
"message": "",
"success": true,
"responseCode": -1,
"object": {
"id": 1,
"name": "Application",
"url": "http://www.example-url.com",
"uniqueId": null,
"applicationCriticality": {
"id": 2,
"name": "Medium"
},
"policyStatuses": [],
"description": null,
"releaseFrequency": "UNKNOWN",
"testEnvironment": null,
"grcApplication": null,
"scans": [
{
"id": 1,
"importTime": 1309962639000,
"updatedDate": 1309962639000,
"numberClosedVulnerabilities": 0,
"numberNewVulnerabilities": 2,
"numberOldVulnerabilities": 0,
"numberResurfacedVulnerabilities": 0,
"numberTotalVulnerabilities": 2,
"numberRepeatResults": 0,
"numberRepeatFindings": 0,
"numberInfoVulnerabilities": 0,
"numberLowVulnerabilities": 0,
"numberMediumVulnerabilities": 1,
"numberHighVulnerabilities": 1,
"numberCriticalVulnerabilities": 0,
"scannerName": "w3af"
}
],
"infoVulnCount": 0,
"lowVulnCount": 0,
"mediumVulnCount": 1,
"highVulnCount": 1,
"criticalVulnCount": 0,
"totalVulnCount": 2,
"isInternal": false,
"unassignedVulnCount": 0,
"organization": {
"name": "Test Team",
"id": 1
},
"waf": {
"name": "New WAF",
"id": 1
}
}
} |
| Page Tree | ||
|---|---|---|
|