11.28.0 Additions
Added
GET /v1/m2m/tenant-id — new
GET /v1/m2m/tenant-id — newReturns the M2M-sourced tenant ID. Useful when a client running under M2M authentication needs to identify the tenant it's operating against without inferring it from another resource.
Response: M2mTenantIdInfo
{
"tenantId": "a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6"
}Unified groups — v2
The unified group endpoints — which return both computer and mobile device groups in one call — are promoted from v1 to v2.
| Method | Path | Replaces |
|---|---|---|
GET | /v2/groups | GET /v1/groups |
GET | /v2/groups/{id} | GET /v1/groups/{id} |
PATCH | /v2/groups/{id} | PATCH /v1/groups/{id} |
DELETE | /v2/groups/{id} | DELETE /v1/groups/{id} |
The PATCH endpoint now uses the new GroupUpdateDtoV2 payload, which adopts the V2 Smart Group criteria format described below.
Mobile device groups — v2
A complete v2 surface for mobile device Smart Groups and Static Groups.
| Method | Path | Replaces |
|---|---|---|
GET | /v2/mobile-device-groups | GET /v1/mobile-device-groups |
GET | /v2/mobile-device-groups/smart-groups | GET /v1/mobile-device-groups/smart-groups |
GET | /v2/mobile-device-groups/smart-groups/{id} | GET /v1/mobile-device-groups/smart-groups/{id} |
GET | /v2/mobile-device-groups/smart-group-membership/{id} | GET /v1/mobile-device-groups/smart-group-membership/{id} |
POST | /v2/mobile-device-groups/smart-groups | POST /v1/mobile-device-groups/smart-groups |
PUT | /v2/mobile-device-groups/smart-groups/{id} | PUT /v1/mobile-device-groups/smart-groups/{id} |
DELETE | /v2/mobile-device-groups/smart-groups/{id} | DELETE /v1/mobile-device-groups/smart-groups/{id} |
GET | /v2/mobile-device-groups/static-groups | GET /v1/mobile-device-groups/static-groups |
GET | /v2/mobile-device-groups/static-groups/{id} | GET /v1/mobile-device-groups/static-groups/{id} |
GET | /v2/mobile-device-groups/static-group-membership/{id} | GET /v1/mobile-device-groups/static-group-membership/{id} |
POST | /v2/mobile-device-groups/static-groups | POST /v1/mobile-device-groups/static-groups |
PATCH | /v2/mobile-device-groups/static-groups/{id} | PATCH /v1/mobile-device-groups/static-groups/{id} |
DELETE | /v2/mobile-device-groups/static-groups/{id} | DELETE /v1/mobile-device-groups/static-groups/{id} |
POST | /v2/mobile-device-groups/{id}/erase | POST /v1/mobile-device-groups/{id}/erase |
Smart Group create and update calls now use MobileDeviceSmartGroupCriteriaV2, and Static Group payloads use SmartGroupAssignmentV2 and SmartGroupDetailV2.
Computer groups — v3
A complete v3 surface for computer Smart Groups and Static Groups, replacing the v2 equivalents.
| Method | Path | Replaces |
|---|---|---|
GET | /v3/computer-groups/smart-groups | GET /v2/computer-groups/smart-groups |
GET | /v3/computer-groups/smart-groups/{id} | GET /v2/computer-groups/smart-groups/{id} |
GET | /v3/computer-groups/smart-group-membership/{id} | GET /v2/computer-groups/smart-group-membership/{id} |
POST | /v3/computer-groups/smart-groups | POST /v2/computer-groups/smart-groups |
PUT | /v3/computer-groups/smart-groups/{id} | PUT /v2/computer-groups/smart-groups/{id} |
DELETE | /v3/computer-groups/smart-groups/{id} | DELETE /v2/computer-groups/smart-groups/{id} |
GET | /v3/computer-groups/static-groups | GET /v2/computer-groups/static-groups |
GET | /v3/computer-groups/static-groups/{id} | GET /v2/computer-groups/static-groups/{id} |
POST | /v3/computer-groups/static-groups | POST /v2/computer-groups/static-groups |
PUT | /v3/computer-groups/static-groups/{id} | PUT /v2/computer-groups/static-groups/{id} |
DELETE | /v3/computer-groups/static-groups/{id} | DELETE /v2/computer-groups/static-groups/{id} |
Smart Group payloads use the new SmartComputerGroupV3 and ComputerSmartGroupCriteriaV2 schemas. Static Group assignments now treat the assignments array as a set with uniqueItems: true, and group names are capped at 255 characters.