> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mediakind.ferndocs.com/mkio/how-to/managing-edge-devices/on-board-fleet-devices/remove-device/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mediakind.ferndocs.com/_mcp/server.

# Remove edge devices

Remove an edge device through the MK.IO portal or Fleet API when it should no longer belong to the project.

## Remove a device

### Remove a device using the MK.IO UI

* Log in to MK.IO.

* Open the project you want to remove the device from and go to the Devices page.

* Click on the device you want to remove. If needed, use Search here.

* Click  then Delete device.

* Click Delete to confirm.

### Remove using the MK.IO API

To remove a device, send a DELETE request:

```http
DELETE https://app.mk.io/api/v1/projects/project_name/fleet/devices/device1

```

### Resolve removal warnings

The API (and UI) displays a warning if either of the following is true:

The device does not have an up-to-date usage report.

* The last usage report shows services were still running on the device.

To resolve this:

* Confirm the device is powered on and can connect to MK.IO. Check the Connected status under Appliance > Fleet.

* Stop all services on the device. Use the
  remote UI if needed.

* Wait for the usage report to update. This can take 10 to 20 minutes.

* Retry the DELETE request.

### Force delete an unreachable device

If the device cannot be accessed due to hardware failure, force the deletion by
adding query parameters to the request:

```http
DELETE https://app.mk.io/api/v1/projects/project_name/fleet/devices/device1?force=true&reason=<reason>&notes=<notes>

```

| Parameter | Description                                                                                                   |
| --------- | ------------------------------------------------------------------------------------------------------------- |
| `force`   | Set to `true` to enable force deletion.                                                                       |
| `reason`  | One of: `Failed`, `Maintenance`, `Storage`, `Other`.                                                          |
| `notes`   | A description of the reason. Required when `reason` is `Other`. Minimum 5 characters, maximum 255 characters. |