Add Assets #

Adds one or more assets to a group.

This endpoint allows you to associate assets with a group by specifying their IDs and the group's path.
The assets will be linked to the group and their groups property will be updated accordingly.

Query Syntax #

HTTP #

URL: http://kuzzle:7512/_/device-manager/:engineId/groups/:_id/addAssets
Method: POST

Other protocols #

{
  "controller": "device-manager/groups",
  "action": "addAssets",
  "engineId": "<engineId>",
  "_id": "<groupId>",
  "body": {
    "path": "<group path>",
    "assetIds": ["<assetId1>", "<assetId2>", ...]
  }
}

Arguments #

engineId: Engine ID (required)
_id: Group ID (required)

Body properties #

path: Path of the group (required)
assetIds: Array of asset IDs to add to the group (required)

Response #

{
  "status": 200,
  "error": null,
  "controller": "device-manager/groups",
  "action": "addAssets",
  "requestId": "<unique request identifier>",
  "result": {
    "successes": [
      { "_id": "<assetId1>", "body": { /* updated asset content */ } },
      { "_id": "<assetId2>", "body": { /* updated asset content */ } }
      // ...
    ],
    "errors": [
      // If any asset update failed, error details here
    ],
    "group": {
      "_id": "<groupId>",
      "_source": {
        "name": "<group name>",
        "model": "<group model>",
        "metadata": { ... },
        "path": "<group path>",
        // other group properties
      }
    }
  }
}

Errors #

Returns an error if the group path is invalid or does not exist.
Returns an error if any asset ID does not exist.