• Home
  • Dynatrace API
  • Environment
  • Application Security
  • Security problems
  • PUT mute status of a remediation item

Security problems API - PUT mute status of a remediation item

Sets the mute status of a remediation item.

The request consumes an application/json payload.

PUTManagedDynatrace for Governmenthttps://{your-domain}/e/{your-environment-id}/api/v2/securityProblems/{id}/remediationItems/{remediationItemId}/muteState
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/securityProblems/{id}/remediationItems/{remediationItemId}/muteState
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/securityProblems/{id}/remediationItems/{remediationItemId}/muteState

Authentication

To execute this request, you need an access token with securityProblems.write scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

The ID of the required third-party security problem.

pathrequired
remediationItemIdstring

The ID of the remediation item.

pathrequired
bodyRemediationItemMuteStateChange

The JSON body of the request. Contains the mute state information to be applied.

bodyoptional

Request body objects

The RemediationItemMuteStateChange object

An updated configuration of the remediation item's mute state.

ElementTypeDescriptionRequired
mutedboolean

The desired mute state of the remediation item.

required
reasonstring

The reason for the mute state change.

The element can hold these values
  • AFFECTED
  • CONFIGURATION_NOT_AFFECTED
  • FALSE_POSITIVE
  • IGNORE
  • INITIAL_STATE
  • OTHER
  • VULNERABLE_CODE_NOT_IN_USE
required
commentstring

A comment about the mute state change reason.

required

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

json
{ "muted": true, "reason": "IGNORE", "comment": "string" }

Response

Response codes

CodeDescription
200

Success. The requested mute state has been applied to the remediation item.

204

Not executed. The remediation item was previously put into the requested mute state by the same user with the same reason and comment.

Example

In this example, the request mutes the PROCESS_GROUP-70DF2C1374244F5A remediation item of the security problem with the ID of 3_SNYK-JAVA-IONETTY-1042268 from the GET request example. The response code of 200 indicates a successful request.

The API token is passed in the Authorization header.

Curl

bash
curl --request PUT \ --url https://mySampleEnv.live.dynatrace.com/api/v2/securityProblems/3_SNYK-JAVA-IONETTY-1042268/remediationItems/PROCESS_GROUP-70DF2C1374244F5A/muteState \ --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \ --header 'Content-Type: application/json' \ --data '{ "muted": true, "reason": "OTHER", "comment": "API test" }'

Request URL

plaintext
https://mySampleEnv.live.dynatrace.com/api/v2/securityProblems/3_SNYK-JAVA-IONETTY-1042268/remediationItems/PROCESS_GROUP-70DF2C1374244F5A/muteState

Request body

json
{ "muted": true, "reason": "OTHER", "comment": "API test" }

Response code

200

Related topics
  • Application Security

    Detect, monitor, remediate vulnerabilities at runtime, and block attacks on your applications.

  • Davis security advisor API

    Find out what the Dynatrace Davis security advisor API offers.