Documentation

Recover, revoke, or erase a device

Manage an existing device’s connection and stored records from its own page.

Access Administrator or owner with fresh MFAConsole path /app/endpointsReviewed

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.

Open the device’s management section. Example organization and device data.

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.

Recover the existing connection. Example organization and device data.

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