Set tracking links for affected entities in Dynatrace with the Vulnerabilities API, using the vulnerability ID and tracking link data.
| POST | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/vulnerabilities/v1/vulnerabilities/{id}/affected-entities:set-tracking-links |
You provide the vulnerability ID in the path and send affectedEntityIds and trackingLink in the request body. It returns a response for editing tracking links of affected entities from Dynatrace.
To execute this request, you need a platform token or OAuth access token with vulnerability-service:vulnerabilities:write scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| id | string | The ID of the related vulnerability. | path | Required |
| body | Set | The JSON body of the request containing input parameters. | body | Required |
SetTrackingLinksRequestBody objectInput parameters for setting tracking links of affected entities.
| Element | Type | Description | Required |
|---|---|---|---|
| affectedEntityIds | Affected | - | Required |
| trackingLink | Tracking | - | Required |
AffectedEntityIds objectTrackingLink object| Element | Type | Description | Required |
|---|---|---|---|
| url | string | The tracking link URL set for the affected entities, e.g. https://example.com/ISSUE-123. Note that only valid URLs with 'http' or 'https' protocols are supported. | Required |
| text | string | The tracking link text set for the affected entities, e.g. 'ISSUE-123'. | Required |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{"affectedEntityIds": ["string"],"trackingLink": {"url": "string","text": "string"}}
| Code | Description |
|---|---|
| 200 | - |
| 400 | - |
| 401 | - |
| 403 | - |
| 404 | - |
| 429 | - |
| 500 | - |
| 501 | - |
| 503 | - |