Overview
Permanently remove a device from your account. This action cannot be undone.Endpoint
Authentication
Required Scopes:write
Additional Requirement: Must be the device owner (not just shared access)
Request
Path Parameters
Headers
Example Request
Response
Success Response (200 OK)
Error Responses
403 Forbidden
404 Not Found
Code Examples
What Happens After Deletion
When you delete a device:- Device is unlinked from your account
- All shares are revoked - users with shared access lose access
- Device settings persist - temperature, schedule, etc. remain on the device
- Device remains functional - continues operating with last known settings
- Can be reclaimed - Generate a new entry key on the thermostat to reclaim it
Use Cases
Device Replacement
Selling/Moving
Reclaiming a Deleted Device
To reclaim a device after deletion:- On the thermostat: Settings → Nest App → Get Entry Code
- In dashboard: Add Device → Enter the entry code
- Device will be linked to your account again
Next Steps
List Devices
View all your devices
Get Status
Check device status
Authentication
Manage API keys