# Edit Device Details > Rename a Device and change its Policies, Device Employee, Tags, or Segment from the Overview tab in Applivery, on any platform, or via the API. Source: https://docs.applivery.com/en/device-management/general-settings/edit-device-details/ • Last updated: 2026-11-12 **Key topics:** Rename a Device, Policy assignment, Device Employee, Device Tags, Segments, Device update API, Applivery, Apple, Android, AOSP, Windows --- **TL;DR:** Use the pencil icons on a Device's Overview tab to rename it or change its Policies, Employee, Tags, or Segment, or update them all in one API call. You can update a Device's main details one field at a time, directly from its **Overview** tab. Each editable field (**Display name**, **Policies**, **Device Employee**, **Tags**, and **Segment**) has its own pencil icon that opens a small dialog to change just that field. The dialogs are the same on every platform: Apple, Android, AOSP, and Windows. ![edit-device-details-overview](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/f574c0ef-bf4d-4a35-a00e-19a6181cd533.png) Each dialog saves on its own. Once you click **Save** (or **Move**, for Segments), Applivery shows **Saved successfully!** and the Overview tab reflects the change right away, with no need to save the whole page. ![edit-device-details-saved](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/2d36e872-ccf3-4a9d-82ef-cca5627844f8.png) ## Rename a Device Click the pencil icon next to the Device's name at the top of the Overview tab to open **Change display name**. Enter the new **Display name** and click **Save**. ![edit-device-details-display-name](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/1f5f1d8a-3698-44ce-9ff2-8e5e42f895af.png) The new name shows up immediately, both in the page header and in the Devices list. :::info The Display name only changes how the Device appears in Applivery. It doesn't rename the Device itself. On Apple Devices, you can learn more about renaming the Device itself in **Device Renaming** by following this [link.](https://docs.applivery.com/en/device-management/apple/apple-policies/device-renaming/) ::: ## Change the assigned Policies Click the pencil icon next to **Policies** to open **Change policy**. Here you can add more than one Policy and set their priority. :::info You can learn more about assigning several Policies and how priority works in **Policy Composition** by following this [link.](https://docs.applivery.com/en/device-management/general-settings/policy-composition/#assigning-policies) ::: ## Reassign the Device Employee Click the pencil icon next to **Device Employee** to open **Change device employee**. Start typing a name or email to search the Employees in your Workspace, then select one. If you want to pick someone else, click **Change**. Click **Save** to apply it. ![edit-device-details-employee](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/0cce5948-1c45-4307-982c-8898c72da57b.png) ## Change Tags Click the pencil icon next to **Tags** to open **Change tags**. You'll see the tags already used in your Workspace as a selectable list. Click a tag to add it, or remove one you no longer need, and click **Save**. ![edit-device-details-tags](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/93a42dbd-0831-4a8b-bda0-b69551cd7f2c.png) :::info You can learn more about how tags work and how to use them in **Device Tags** by following this [link.](https://docs.applivery.com/en/device-management/general-settings/device-tags/) ::: ## Move a Device to another Segment Click the pencil icon next to **Segment** to open **Move device to other segment**. You'll see your full Segment tree with the **Current Segment** highlighted. Search or browse to the Segment you want, select it as the **Target Segment**, and click **Move**. ![edit-device-details-segments](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/608cc095-438f-4e37-b9c6-00dd5b217f29.png) :::info You can learn more about **Segments** by following this [link.](https://docs.applivery.com/en/device-management/general-settings/segments/) ::: ## Use the API You can also update all these fields together in a single call, using the device update endpoint of each platform. To authenticate, you need a Service Account token. You can learn how to create one in **Service Accounts** by following this [link.](https://docs.applivery.com/en/platform/api/service-accounts/)

Platform

Endpoint

Policies field

Apple

PUT /organizations/:organizationId/mdm/apple/enterprise/devices/:admDeviceId

admPolicyAssignments

Android

PUT /organizations/:organizationId/mdm/android/enterprise/devices/:emmDeviceId

emmPolicyAssignments

AOSP

PUT /organizations/:organizationId/mdm/aosp/enterprise/devices/:aosDeviceId

aosPolicyAssignments

Windows

PUT /organizations/:organizationId/mdm/windows/enterprise/devices/:winDeviceId

winPolicyAssignments

For example, this request updates a Windows Device: ```bash curl 'https://api.applivery.io/v1/organizations/ORG_ID/mdm/windows/enterprise/devices/DEVICE_ID' \ -X PUT \ -H 'Authorization: Bearer YOUR_SERVICE_ACCOUNT_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "displayName": "Sales Laptop 01", "tags": ["COUNTRY:Spain", "finance"], "mdmUserId": "EMPLOYEE_ID", "winPolicyAssignments": [ { "winPolicyId": "POLICY_ID_1", "priority": 100 }, { "winPolicyId": "POLICY_ID_2", "priority": 200 } ], "segmentId": SEGMENT_ID }' ``` Each field maps to one of the Dashboard dialogs:

Field

Dashboard dialog

Notes

displayName

Change display name

Up to 128 characters.

tags

Change tags

Send the full list of tags you want on the Device. It replaces the current tags instead of adding to them.

mdmUserId

Change device employee

Send null to unassign the Employee.

admPolicyAssignments, emmPolicyAssignments, aosPolicyAssignments, winPolicyAssignments

Change policy

Each item includes the Policy ID (admPolicyId, emmPolicyId, aosPolicyId, or winPolicyId) and a priority from 0 to 10000. Lower numbers mean higher priority.

segmentId

Move device to another segment

The numeric ID of the target Segment.

Unlike the Dashboard dialogs, which save each field on its own, the API call updates only the fields you include in the request. Leave a field out to keep its current value.