Add Device Group

Restriction: This API endpoint is not supported in the Free Trial cloud.

Adds a new device group.

Important: To be able to run this API endpoint, you need to be an Admin user or part of Perfecto Support.

 

URL

Copy 
http://<your-cloud>.app.perfectomobile.com/api/v1/device-groups

Method

POST

Header parameters

Name

Description

Perfecto-Authorization

Security Token

Data parameters (body)

Parameter Type Description

name*

string

The name of the device group being created. Cannot exceed 128 characters.

description

string

A description for the device group being added. Cannot exceed 512 characters.

userNames

array of strings

The names of the users associated with this device group.

deviceIds

array of strings The IDs of the devices associated with this device group.

* Mandatory parameter

Success response

Code: 200 OK

Error response

Status and a generic error message

Example

Copy
JSON request
{
    "name":"groupApi55", 
    "description":"my group", 
    "deviceIds":["L7DE8985B3"], 
    "userNames":["alexBar"]
}