post
https://hub.xyte.io/core/v1/organization/devices//merge
Merge one or more shadow devices under a primary device
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Overview
Merge one or more shadow devices under this primary device. The primary device and each shadow must belong to the same organization. The merge group is capped at four devices (1 primary + up to 3 shadows).
Authorization
This endpoint requires Authorization.
Path Parameters
| Key | Type | Description | Required |
|---|---|---|---|
| device_id | string | The primary device ID. | Yes |
Request Body
| Key | Type | Description | Required |
|---|---|---|---|
| with_device_ids | array of string | IDs of devices to merge as shadows under the primary device. | Yes |
{
"with_device_ids": ["8f2c1e4a-...", "b71d0a93-..."]
}Response
Returns { "success": true } on success.
{
"success": true
}Errors
| Status | Example | Meaning |
|---|---|---|
| 400 | with_device_ids must not be empty | The with_device_ids list was empty. |
| 401 | Not authorized | Missing or invalid Authorization key. |
| 422 | merge group would exceed max size 4 | The resulting merge group would exceed four devices. |