Skip to content

Update device group
Stable

Request

Update a group in Devices & Groups.

Security
apiKey
Path
group_idstring, (uuid)required

A UUID string identifying this enterprise device group.

enterprise_idstringrequired

A UUID string identifying enterprise.

Query
actionstring

add / remove / rename / move

Body*/*required
namestring(Name)required

Group name

parentstring, (uuid)(Parent)

Parent group id

device_idsArray of strings, (uuid), unique(Device ids)

Devices ids

cURL
curl -i -X PUT \
  'https://develop-api.esper.io/_mock/openapi/enterprise/{enterprise_id}/devicegroup/{group_id}/?action=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: */*' \
  -d '{
    "name": "string",
    "parent": "42e2bc1b-6741-4e2e-b138-97b4a342c999",
    "device_ids": [
      "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
  }'

Responses

successful operation

Bodyapplication/json
idstring, (uuid)(Id)read-only

Group id

namestring(Name)required

Group name

created_onstring, (date-time)(Created on)read-only

Date and time of when the group was created

enterprisestring, (url)(Enterprise)read-only

Enterprise url

parentstring, (url)(Parent)

Parent group url

device_countinteger(Device count)read-only

Count of devices in the group

pathstring(Path)read-only

Path of the group

children_countinteger(Children count)read-only

Count of child groups

thumbnailstring, (uuid)(thumbnail)

thumbnail associated with the group

blueprintstring, (uuid)(Blueprint)read-only

Blueprint associated with the group.

Response
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "name": "string",
  "created_on": "2019-08-24T14:15:22Z",
  "enterprise": "string",
  "parent": "string",
  "device_count": 0,
  "path": "string",
  "children_count": 0,
  "thumbnail": "dec11f24-4767-4257-ac7d-bde137bc173e",
  "blueprint": "f63e6a96-31ed-4c31-b384-a8046257f34c"
}