PingOne Platform APIs

Risk Data

You can use the riskUserProfile endpoint to erase all of the risk-related data that has been collected for a specific user.

Risk Data data model

Property Type Required Mutable Description

user

Object

Required

N/A

Contains the fields representing the details of the user whose risk data is to be erased.

user.id

String

Required

N/A

The ID of the user whose risk data is to be erased.

user.type

String

Required

N/A

The type of the user whose risk data is to be erased - can be PING_ONE or EXTERNAL.

Risk data errors

In addition to the general error codes, the erase risk data operation can return the following errors:

HTTP status Top‑level code Detail code When it happens and what the response contains

400

INVALID_DATA

EMPTY_VALUE or INVALID_VALUE

Message: Validation Error : [<property> <message>]

When and details

When: A POST /environments/{envID}/riskUserProfile request omits the required user object, supplies a PING_ONE user without an id, a PING_ONE user with an id that is not a UUID, or an EXTERNAL user without an id

Details: must not be null for an omitted user; invalid PING_ONE user, one of id or name must be present for a PING_ONE user without an id; PING_ONE user id must be a valid UUID for a PING_ONE user id that is not a UUID; invalid EXTERNAL user, id must be present for an EXTERNAL user without an id; all with target user, for example Validation Error : [user must not be null].

400

INVALID_REQUEST

INVALID_VALUE or None

Message: The request could not be completed. The request was malformed or invalid.

When and details

When: The request body cannot be deserialized, for example a property with the wrong JSON type

Details: For a JSON field conversion error, the detail code is INVALID_VALUE with the failing field’s path as the target and message Invalid value for attribute.; otherwise no details are returned.

415

INVALID_REQUEST

None

Message:

The server is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method.
When and details

When: The request does not use the required application/vnd.pingidentity.risk.userProfile.reset+json content type

Details: None.

403

ACCESS_FAILED

None

Message: The actor attempting to perform the request is not authorized.

When and details

When: The actor lacks the risk:reset:userProfile permission

Details: None