Attaches or detaches a profile to/from multiple device groups in a single operation. When a profile is attached, devices in those groups apply its content (for example, installing its apps) on their next sync; if the account is configured for push-on-change, the server also sends a push so devices pick it up immediately. Either way, no further API call is needed. Group IDs can be looked up with GET /rest/manager/filters/getfilters (entries with isGroupFilter: true are device groups; use their id values here).
Request example:
{
"profileID": "665f2a91c33e5b4ea1d7f003",
"groupIDList": ["663a11f0be21aa04c77d2e55"],
"operation": "add",
"isViewProfile": false
}operation: 'add' to attach, 'remove' to detach.isViewProfile: false for regular profiles.
Note: on each device only one priority profile (typeOfAllowMultiProfile: false) runs - the lowest orderIndex whose conditions are met - so attaching a second priority profile to a device's groups does not make it run alongside the first (see createorupdate). Detaching (remove) stops the profile from being applied and enforced on those devices but does not uninstall its apps or revert its settings.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Bad Request
401Unauthorized
403Forbidden
429Too Many Requests
503Service Unavailable