Governance Console
Update a detection
Update a governance detection by its unique identifier. Only the attributes present in the request are modified, allowing a detection to be acknowledged as an exception, reopened, reassigned, or deferred for mitigation.
patch/api/v2/governance/detections/{detection_id}
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/token
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
detection_idstring required
The unique identifier of the detection.
Request body
Example request
{
"data": {
"attributes": {
"assigned_team": "platform-security",
"assigned_to": "11111111-2222-3333-4444-555555555555",
"mitigate_after": "2024-03-15T00:00:00Z",
"state": "exception"
},
"type": "governance_control_detection"
}
}Response
OK
Example response
{
"data": {
"attributes": {
"assigned_team": "platform-security",
"assigned_to": "11111111-2222-3333-4444-555555555555",
"assignment_source": "manual",
"control_id": "unused_api_keys",
"created_at": "2024-03-01T12:00:00Z",
"detection_type": "unused_api_keys",
"display_name": "CI Deploy Key",
"exception_at": "2024-03-05T09:00:00Z",
"exception_by": "11111111-2222-3333-4444-555555555555",
"metadata": {
"region": "us-east-1"
},
"mitigate_after": "2024-03-15T00:00:00Z",
"mitigated_at": "2024-03-10T15:30:00Z",
"priority": 1,
"resource_id": "api-key-12345",
"resource_type": "api_key",
"state": "active"
},
"id": "3f9b2c1a-8d4e-4a6b-9c2f-1e7d5a0b3c4d",
"type": "governance_control_detection"
}
}Changes
Changes to this operation have not been checked yet.