UpdateLinkedProjectsOnVulnerabilities

This method can be used for the following functionality: Update linked projects on vulnerabilities.

Parameters

The following URL, Headers and Parameters are required for requests to this API endpoint. Where a parameter is optional, it will be indicated. Otherwise treat all parameters as mandatory.

Access

This API can only be used by Administrators.

Headers

PUT /api/ss/vulnerabilities/projects HTTP/1.1
Host: demo.attackforge.com
X-SSAPI-KEY: APIKey
Content-Type: application/json
Connection: close

Body

The body supplied must be a list of link objects:

{
  "links": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link"
    }
  ]
}

projectId

Project Id for the project to link/unlink the vulnerability.

Example:

{
  "links": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link"
    }
  ]
}

vulnerabilityId

Vulnerability Id for the vulnerability to link/unlink.

Example:

{
  "links": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link"
    }
  ]
}

action

Must be either link or unlink.

Example:

{
  "links": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link"
    }
  ]
}

Example

The following example is a cURL request to link a vulnerability to a project.

Request

Include API Token instead of stars in 'X-SSAPI-KEY: ***************************************' parameter.

curl -X PUT 'https://demo.attackforge.com/api/ss/vulnerabilities/projects' -H 'Host: demo.attackforge.com' -H 'X-SSAPI-KEY: ***************************************' -H 'Content-Type: application/json' -H 'Connection: close' -d '{
   "links": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link"
    }
  ]
}'

Response

Response contains a result or error.

{
  "result": [
    {
      "projectId": "64b500641f57624e0d52063e",
      "vulnerabilityId": "68096c7e53dba8b392978423",
      "action": "link",
      "status": "ok|error"
    }
  ],
  "error": "..."
}