Skip to content

Group

Contains group object structure and API calls to interact with them. Tracker group used to organize trackers in user interface. Currently, its function is purely visual.


Group object structure:

{
    "id": 167,
    "title": "Main office",
    "color": "FF6DDC"
}
  • id - int. Group ID. Used to reference group in objects and API calls. Read-only, assigned automatically by the server.
  • title - string. User-specified group title, 1 to 60 printable characters, e.g. "Employees".
  • color - string. Group color in web format (without #), e.g. "FF6DDC". Determines the color of tracker markers on the map.

API actions

API base path: /tracker/group.

assign

Assigns multiple trackers to the specified group.

required sub-user rights: admin (available only to master users).

parameters

name description type format
id Group ID, or 0 if trackers should be removed from any group. int 167
trackers Array of IDs of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked. int array [999199, 999919]

example

curl -X POST 'https://api.navixy.com/v2/tracker/group/assign' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "trackers": [999199, 991999], "id": 167}'

response

{ "success": true }

errors

  • 201 - Not found in the database – if no group found with the specified ID (or group belongs to another user).
  • 217 - List contains nonexistent entities – if one or more of tracker IDs belong to nonexistent tracker (or to a tracker belonging to different user).

create

Creates a new empty group.

required sub-user rights: admin (available only to master users).

parameters

name description type format
title Ser-specified group title, 1 to 60 printable characters. string "Employees"
color Group color. string "FF6DDC"

examples

curl -X POST 'https://api.navixy.com/v2/tracker/group/create' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "title": "Employees", "color": "FF6DDC"}'
https://api.navixy.com/v2/tracker/group/create?hash=a6aa75587e5c59c32d347da438505fc3&title=Employees&color=FF6DDC

response

{
    "success": true,
    "id": 222
}
  • id - int. An ID of created group, e.g. 222.

errors

General types only.


delete

Deletes group with the specified ID. The group must belong to authorized user. All trackers from this group will be assigned to default group (0).

required sub-user rights: admin (available only to master users).

parameters

name description type format
id ID of group to delete. int 167

examples

curl -X POST 'https://api.navixy.com/v2/tracker/group/delete' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "id": 167}'
https://api.navixy.com/v2/tracker/group/delete?hash=a6aa75587e5c59c32d347da438505fc3&id=167

response

{ "success": true }

errors

  • 201 - Not found in the database – if no group found with the specified ID (or group belongs to another user).

list

Gets all user tracker groups. There is always "default" unnamed group with ID = 0. It cannot be modified, deleted, and is not returned by this API call.

examples

curl -X POST 'https://api.navixy.com/v2/tracker/group/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3"}'
https://api.navixy.com/v2/tracker/group/list?hash=a6aa75587e5c59c32d347da438505fc3

response

{
    "success": true,
    "list": [
        {
            "title": "test",
            "color": "FF6DDC",
            "id": 129301
        }
    ]
}

errors

General types only.


update

Updates specified tracker group. Group must belong to the authorized user.

required sub-user rights: admin (available only to master users).

parameters

name description type format
id ID of group to update. int 167
title Ser-specified group title, 1 to 60 printable characters. string "Employees"
color Group color. string "FF6DDC"

examples

curl -X POST 'https://api.navixy.com/v2/tracker/group/update' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "id": 167, "title": "Employees", "color": "FF6DDC"}'
https://api.navixy.com/v2/tracker/group/update?hash=a6aa75587e5c59c32d347da438505fc3&id=167&title=Employees&color=FF6DDC

response

{ "success": true }

errors

  • 201 - Not found in the database – if no group found with the specified ID (or group belongs to another user).

Last update: December 26, 2022