Set Application URL 3.0 - API

/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 the user wants to assign to the application.

Sample Call:

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.

{
    "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
        }
    }
}