Moving Devices

How to hand devices over to another workspace, and how to review a move request that somebody sent to you.

Moving hands devices over to another workspace for good. The devices leave your workspace and become the receiving workspace's devices, including the billing for them.

Nothing happens right away. A move is a request first, and the devices stay exactly where they are until an administrator in the target workspace accepts it.

Moving is permanent. Once a move has been accepted, only the receiving workspace can move the devices back — you cannot undo it from your side.

TL;DR

If you don't have the time to read through this documentation, we have prepared a short intro video for you:

Moving or Claiming?

Use claiming if you want another workspace to have access to devices that stay yours. Use moving if the devices should stop being yours altogether.

Claiming

Sending a Move Request

1. Navigate to your fleet view (Fleet / All Devices) and select the devices you want to move.

2. In the action bar that appears, select "Advanced" and then "Move to workspace".

3. Choose the target workspace.

4. Optionally tick "Copy integration settings" and add a message for the receiving workspace.

5. Confirm with "Send move request".

You need the device permission in your workspace to send a request.

Choosing the Target Workspace

Search the field by name to find the workspaces you are a member of.

To move devices to a workspace you are not a member of — a customer's workspace, for example — paste its workspace ID into the same field and select the "Use workspace ID" entry that appears. Ask an administrator of that workspace for the ID.

What Is Not Moved

Rules, webhooks and reports stay with your workspace. They are not moved and not copied, so recreate them in the target workspace if they are still needed there.

Integration settings, such as network server or MQTT credentials and secrets, are only handed over if you tick "Copy integration settings" before sending the request.

If you use the MQTT broker, your topics change. The devices join a copy of their product in the target workspace, and that copy gets its own product slug — the part of the MQTT topic that identifies the product. Data still sent to the old topics no longer arrives, and anything subscribed to them stops receiving. Point both at the new topics after the move.

Reviewing an Incoming Request

When another workspace wants to move devices to you, a banner appears above your device list. You can also open the list directly under Administration, in "Device move requests".

On the "Incoming" tab, select "Review" to see who sent the request, which devices it covers and any message that came with it. Choose the plan the incoming devices should get in your workspace, then accept or reject.

Accepting a request means your workspace takes on the billing for those devices from that moment on. The accept button states how many devices that is.

Rejecting leaves the devices in the sending workspace.

Tracking Requests You Sent

The "Outgoing" tab lists the requests your workspace has sent. While a request is still pending you can withdraw it with "Cancel".

By default only pending requests are shown. Select "Show all" to include the ones that have already been resolved — accepted, rejected, expired or failed.