Recover, revoke, or erase a device
Manage an existing device’s connection and stored records from its own page.
Before you start
- Open the intended device from Endpoints.
- Check its hostname and device identity before making a change.
Screenshots show the current Rapport interface with fictional example data. Use your organization’s devices and values. Select an image to enlarge it.
Inspect the agent update
Expand Device management on the device overview to see its reported agent version and latest update result. A failed Windows update can expose Repair agent installation and Read recovery result. These open the existing reviewed task workflow for this device.
Open the device’s management section
Open Endpoints, select the device, and expand Device management beside its activity feed. These administrator controls live with the device’s history. Find individual devices through Endpoints or a filtered status count on Agents.
Recover the existing connection
Choose Recover agent connection → Generate recovery token and complete fresh MFA. Copy the token while it is shown. It is bound to this device, expires after one hour, and can be used once.
Use the token on that same device
Run the signed installer on the original device and enter the recovery token when prompted. Successful recovery rotates its previous credentials while retaining the device record. Refresh the device page and check a new heartbeat. If the token expires, generate a new recovery token for this record.
Revoke access when the agent must disconnect
Choose Revoke agent access, confirm the device name in the dialog, and complete MFA. All active agent credentials stop working immediately. The agent is not uninstalled and its existing history remains available. Reconnection requires recovery.
Erase stored Rapport records only when intended
Choose Erase stored device data. Read the scope, type the exact device name, and choose Erase device data with MFA. This permanently removes its Rapport inventory, telemetry, workforce records, results, and terminal metadata, and revokes credentials. A minimal audit record remains.
Check the confirmed result before retrying
For recovery or revocation, refresh the record and verify the reported state. After erasure, Rapport returns to Endpoints and confirms removal or background erasure in progress. If the operation was not confirmed, refresh before submitting again.
If something doesn’t work
I cannot see Device management.
It requires an administrator or owner in the selected organization with a verified session. Check both role and organization.
I only want to stop new enrollments.
Revoke the install token in Manage install tokens. That does not revoke credentials on devices already enrolled.
I need to remove the agent software.
Use the platform-specific uninstall instructions on Install agent. Revoking credentials and erasing records do not uninstall software.
Still need help? Contact Rapport support with the page, action, time, and error message. Do not include passwords or secret tokens.
All documentation