Update Risk Evaluation
PUT {{apiPath}}/environments/{{envID}}/riskEvaluations/{{riskEvalID}}/event
Use PUT /environments/{{envID}}/riskEvaluations/{{riskID}}/event
to update the risk evaluation configuration, and to modify the completion status of the resource when the risk evaluation is still in progress.
Note: The update operation is important to provide more accurate risk evaluations.
You can update the transaction up to 30 minutes after the successful POST
request. Transactions that are not updated maintain a completionStatus
of IN_PROGRESS
. If you attempt to update the transaction after 30 minutes, the response returns an error.
Prerequisites
See PingOne Protect and Risk Evaluations for important overview information.
For complete property descriptions, see Risk Evaluations.
The completionStatus
property required in the request body can be modified in a PUT
request only if the value is IN_PROGRESS
. The risk evaluation resource cannot be updated if the current value is SUCCESS
or FAILED
.
Property | Type | Required? |
---|---|---|
completionStatus | String | Optional |
Request Body
{"completionStatus"=>"SUCCESS"}
RESPONSES
status: OK
{"_links":{"self":{"href":"https://api.pingone.eu/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/riskEvaluations/9be12e1a-0a45-4baf-93a5-bcc0c626d656/event"},"riskEvaluation":{"href":"https://api.pingone.eu/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/riskEvaluations/9be12e1a-0a45-4baf-93a5-bcc0c626d656"},"environment":{"href":"https://api.pingone.eu/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"}},"completionStatus":"SUCCESS","targetResource":{"id":"969e4a59-5cf9-44c3-a1ba-9f392bf7f622","name":"Jira"},"ip":"156.35.85.124","flow":{"type":"AUTHENTICATION"},"session":{"id":"31618b01-08cd-4bee-b0d3-90b895671bb4"},"user":{"id":"john","name":"John DeMock","type":"EXTERNAL","groups":[{"name":"dev"},{"name":"sre"}]},"sharingType":"SHARED","browser":{"userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36"}}