Logo

Device Group

APIs for device group management

Find out more about device group management

List device groups

Returns EnterpriseDeviceGroup list

SecurityapiKey
Request
path Parameters
enterprise_id
required
string

A UUID string identifying enterprise.

query Parameters
name
string

Filter by group name

limit
integer
Default: 20

Number of results to return per page.

offset
integer
Default: 0

The initial index from which to return the results.

Responses
200

successful operation

401

Authorization information is missing or invalid.

404

Not Found.

500

Internal server error

get/enterprise/{enterprise_id}/devicegroup/
Request samples 
Response samples 
application/json
{
  • "count": 0,
  • "next": "string",
  • "previous": "string",
  • "results": [
    ]
}
Create a device group
Returns EnterpriseDeviceGroup instance


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string
A UUID string identifying enterprise.


 
Request Body schema: */*
required
name
required
string (Name) 
Group name


 
parent
string <uuid>  (Parent) 
Parent group id


 
device_ids
Array of strings <uuid>  (Device ids)   unique 
Devices ids


 
Responses 
201
successful operation


400
Bad request


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


500
Internal server error


post/enterprise/{enterprise_id}/devicegroup/
Request samples 
Response samples 
application/json
{
  • "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"
}
Get device group information
Returns EnterpriseDeviceGroup instance


SecurityapiKey 
Request 
path Parameters
group_id
required
string <uuid> 
A UUID string identifying this enterprise device group.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
Responses 
200
successful operation


401
Authorization information is missing or invalid.


404
Not Found.


500
Internal server error


get/enterprise/{enterprise_id}/devicegroup/{group_id}/
Request samples 
Response samples 
application/json
{
  • "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"
}
Update device group
Returns EnterpriseDeviceGroup instance


SecurityapiKey 
Request 
path Parameters
group_id
required
string <uuid> 
A UUID string identifying this enterprise device group.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
query Parameters
action
string
add / remove / rename / move


 
Request Body schema: */*
required
name
required
string (Name) 
Group name


 
parent
string <uuid>  (Parent) 
Parent group id


 
device_ids
Array of strings <uuid>  (Device ids)   unique 
Devices ids


 
Responses 
200
successful operation


400
User update error


401
Authorization information is missing or invalid


404
Not Found


500
Internal server error


put/enterprise/{enterprise_id}/devicegroup/{group_id}/
Request samples 
Response samples 
application/json
{
  • "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"
}
Delete a device group
Emtpy response


SecurityapiKey 
Request 
path Parameters
group_id
required
string <uuid> 
A UUID string identifying this enterprise device group.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
Responses 
204
The resource was deleted successfully.


400
Invalid request.


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


404
Not Found.


500
Internal server error


delete/enterprise/{enterprise_id}/devicegroup/{group_id}/
Request samples 
Response samples 
application/json
{
  • "errors": [
    ],
  • "message": "string",
  • "status": 0
}
Partial update group
Returns EnterpriseDeviceGroup instance


SecurityapiKey 
Request 
path Parameters
group_id
required
string <uuid> 
A UUID string identifying this enterprise device group.


 
enterprise_id
required
string
A UUID string identifying enterprise.


 
query Parameters
action
string
add / remove / rename / move


 
Request Body schema: */*
required
name
string (Name) 
Group name


 
parent
string <uuid>  (Parent) 
Parent group id


 
device_ids
Array of strings <uuid>  (Device ids)   unique 
Device ids


 
Responses 
200
successful operation


400
Bad request


401
Authorization information is missing or invalid.


403
Forbidden, no permission to perform this action.


404
Not Found.


500
Internal server error


patch/enterprise/{enterprise_id}/devicegroup/{group_id}/
Request samples 
Response samples 
application/json
{
  • "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"
}
Upload a thumbnail pic
Returns GroupThumbail instance


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string <uuid> 
Enterprise ID


 
Request Body schema: multipart/form-data
required
image_file
string <binary> 
 
Responses 
200
Thumbnail


post/enterprise/{enterprise_id}/devicegroup/thumbnail/
Request samples 
Response samples 
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "image_file": "string",
  • "thumbnail_url": "string",
  • "created_on": "2019-08-24T14:15:22Z"
}
List thumbnail pics
Returns list of GroupThumbail instances


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string <uuid> 
Enterprise ID


 
Responses 
200
Thumbnail


get/enterprise/{enterprise_id}/devicegroup/thumbnail/
Request samples 
Response samples 
application/json
{
  • "count": 0,
  • "previous": "string",
  • "next": "string",
  • "results": [
    ]
}
Group thumbnail detail
Returns detail of a group thumbnail instance


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string <uuid> 
Enterprise ID


 
thumbnail_id
required
string <uuid> 
Group thumbnail ID


 
Responses 
200
Thumbnail


get/enterprise/{enterprise_id}/devicegroup/thumbnail/{thumbnail_id}/
Request samples 
Response samples 
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "image_file": "string",
  • "thumbnail_url": "string",
  • "created_on": "2019-08-24T14:15:22Z"
}
Delete group thumbnail
Delete a given thumbnail instance


SecurityapiKey 
Request 
path Parameters
enterprise_id
required
string <uuid> 
Enterprise ID


 
thumbnail_id
required
string <uuid> 
Group thumbnail ID


 
Responses 
204
Deleted group thumbnail


401
Group thumbnail delete error


delete/enterprise/{enterprise_id}/devicegroup/thumbnail/{thumbnail_id}/
Request samples 
Response samples 
application/json
{
  • "errors": [
    ],
  • "message": "string",
  • "status": 0
}
➔ Next to Token