Send MFA Device Logs
PUT {{apiPath}}/environments/{{envID}}/users/{{userID}}/devices/{{deviceID}}/logs
The PUT /environments/{{envID}}/users/{{userID}}/devices/{{deviceID}}/logs operation issues a request for logs from a user's native device. This operation can only be used with devices with a type of MOBILE.
The value of expiresAt is set at 24 hours from the time of the request for the logs. When the user connects to the app, it sends the logs and the status changes from PENDING to RECEIVED. expiresAt is reset when the logs are sent, or when the system date reaches the request's expiry time.
Prerequisites
- See PingOne MFA and MFA Devices for important overview information.
| Property | Type | Required? |
|---|---|---|
status | String | Required |
See the Device properties data model for full property descriptions.
Request Body
{"status"=>"PENDING"}
RESPONSES
status: OK
{"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/7d40a771-8776-4de4-b69b-ef8dba75fd70/devices/588b1e0c-3387-45ed-a1c2-ebb16b8a6dad/logs"},"device":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/users/7d40a771-8776-4de4-b69b-ef8dba75fd70/devices/588b1e0c-3387-45ed-a1c2-ebb16b8a6dad"}},"status":"PENDING","expiresAt":"2020-03-06T17:38:31.767Z"}