> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Move Devices Between Operators

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-bold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 bg-white dark:bg-[#1e1e1e] hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>

      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Lynx API allows you to reassign devices from one operator to another within the hierarchy in your Nayax system. This is particularly useful for businesses managing multiple operators, regions, or organizational units, ensuring seamless control and tracking of devices as they change hands.

This page presents how to move a device from one operator to another using the Lynx API. In the step-by-step guide below, you'll use the following endpoint:

<EndpointCard title="Move Devices" href="/reference/lynx/devices/move-devices-to-actor-id" method="put" />

<Warning>
  **Authentication**

  Refer to the [Security & Token](/docs/manage-data-operations/lynx-api/security) page of this documentation to learn how to access your tokens, and how to properly use it to authenticate your API requests.
</Warning>

## Moving Devices

Use the [Move Devices](/reference/lynx/devices/move-devices-to-actor-id) endpoint to assign or move devices to the specified `actorId`. The request body should include an array of device identifiers, such as serial numbers. See the example request in the code block below:

```sh Request theme={null}
curl -X PUT "https://qa-lynx.nayax.com/operational/v1/devices/move/<ACTOR_ID>" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '[
  "SN12345X",
  "SN67890Y"
]'
```

<Note>
  **Path Params**

  Replace `<ACTOR_ID>` with the target actor's unique identifier for the new operator.
</Note>

As you can see, the body of the request above contains two serial numbers for devices that will be moved to the targeted Operator. The response will return the status of each device moved. See the code block below:

```json Response theme={null}
[
  {
    "HW_serial": "SN12345X",
    "actor_id": 3001492652,
    "is_connected": true
  },
  {
    "HW_serial": "SN67890Y",
    "actor_id": 3001492652,
    "is_connected": false
  }
]
```

Where:

| Parameter      | Description                                                                              |
| :------------- | :--------------------------------------------------------------------------------------- |
| `HW_serial`    | The hardware serial number of the device.                                                |
| `actor_id`     | Confirms the new `actorId` to which the device was moved                                 |
| `is_connected` | Indicates whether or not the device was connected to a virtual machine before moving it. |

<br />