Attach Profile to Multiple Device Groups

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.

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

Attachment request: profileID (string), groupIDList (array of group IDs), operation ('add' or 'remove'), isViewProfile (boolean, false for regular profiles).

Responses

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

503

Service Unavailable

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