HomeGuidesAPI Reference
GuidesAPI ReferenceGitHubAirheads Developer CommunityLog In
API Reference

Move devices to a group.

List of given device serials will be moved to the specified group.

  1. If the device is already part of any group: Move device to group and assign specified group in device management page.
    Note: if given device is part of a swarm, stack or controller, all associated devices will be moved to the target group.

  2. If device is not part of any group: Assign specified group in device management page.

The 'preserve_config_overrides' parameter can be used to retain device configuration overrides when it is moved to UI group.
The configuration of devices of type mentioned in this list will be preserved when the device is moved to a UI group.
The device configuration will not be reset completely with the group level configuration
This is supported only for AOS_CX devices.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

List of devices to be moved to specified group.

string
required
serials
array of objects
required
serials*
preserve_config_overrides
array of strings

The configuration of devices of type mentioned in this list will be preserved when the device is moved to a UI group.
The device configuration will not be reset completely with the group level configuration.

This is supported only for AOS_CX devices.

preserve_config_overrides
Responses
200

Successful operation.

401

Unauthorized access, authentication required.

403

Forbidden, do not have write access for group.

413

Request-size limit exceeded.

417

Request-size limit exceeded.

429

API Rate limit exceeded.

default

the default response

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json