Adding and removing devices

This page explains the process of adding devices to your nRF Cloud team and removing them from the team.

Adding devices

Devices are added automatically during the onboarding process when using the OnboardDevice, or OnboardDevices endpoints, or during auto-onboarding.

To add a device that uses a certificate downloaded from either the nRF Cloud portal or CreateDeviceCertificate endpoint, you must associate it with your team. This applies to Thingy:91 or nRF916x DKs for which you have not provisioned a new certificate. You must manually associate the device using either the nRF Cloud portal or the AssociateDevice endpoint.

A device knows whether it is associated by finding {"pairing":{"state":"paired"}} in its device shadow. Devices using the nRF Cloud library attempt to do this automatically.

Bulk onboarding and key registration

You can view the results of previous operations related to bulk device onboarding or registration of public keys in the nRF Cloud portal:

1. Log in to the nRF Cloud portal.
2. Select Device Management in the left navigation bar.
3. Select Bulk Operation History.
4. From this page, you can view completed requests by bulk ops request ID:
   • Click download in the File column of the Upload History table to download a JSON file containing the server response.
   • If the request returned errors, you can download a JSON file containing the response from the Errors column of the Upload History table.

Deleting devices

To delete a device from your team, use either the nRF Cloud portal or the DeleteDevice endpoint.

Deleting the device also removes any associated data.

note

Deleting a device removes its association. If you have claimed a device and used provisioning commands or auto-onboarding to add it to nRF Cloud, the following steps, as well as the DeleteDevice endpoint, do not affect the device's claim status.

Deleting devices using the nRF Cloud portal

To delete a device from your team:

1. Log in to the nRF Cloud portal.
2. Select Device Management from the left navigation bar.
3. Select Devices.
4. You can delete one or more devices from the Devices overview, or a single device from that device's page:

   • To delete one or more devices from the device overview:

     1. Select the checkbox next to one or more devices that you want to delete.

     2. Click Delete.

        A pop-up opens asking for confirmation.

     3. Click OK.

   • To delete a single device from its own page:

     1. Click the device name. The device's own page opens.

     2. Click Delete Device.

        A pop-up opens asking for confirmation.

     3. Click OK.

The device and its associated data are now removed.