Skip to main content
POST
Create a device group
Key: Write Scope: Company

Authorizations

Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Body

application/json
name
string
required

Device group name

Minimum string length: 1
target
object
required

Device-group target filter. An object keyed by criterion key (from the /device-groups/filters-options catalog); each value is a clause { operationType: "INCLUDE" | "EXCLUDE", values: string[] } — never a bare array. Add top-level matchAny: true for OR across clauses. Example: { "platform": { "operationType": "INCLUDE", "values": ["MACOS"] } }.

Response

default - application/json
id
string
required

Device group ID

name
string
required

Device group name

target
object
required

Device-group target filter. An object keyed by criterion key (from the /device-groups/filters-options catalog); each value is a clause { operationType: "INCLUDE" | "EXCLUDE", values: string[] } — never a bare array. Add top-level matchAny: true for OR across clauses. Example: { "platform": { "operationType": "INCLUDE", "values": ["MACOS"] } }.