device-api

Update device

Updates device attributes

post/v1/default/device/{id}

Request

  • Base URL
    https://api.bymason.com
  • Auth
    API key in header Authorization

Path parameters

idstring uuid required

Device ID

Request body

namestring

Device name

Response

Update device response

idstring uuid

Unique identifier for the device

selfstring

Reference to this device

namestring

Device name

imeistring

International mobile equipment identity

createdAtstring date-time

Date device was added to the Mason account

family'D03' | 'F07' | 'D450' | 'D450A' | 'D450A1' | 'D450B' | 'C210' | 'F210' | 'F450' | 'G430' | 'G450' | 'I3399A' | 'A4100' | 'D215'
lastcheckinstring date-time

Timestamp for the last time the device reported a heartbeat to the platform

serialnumberstring

Serial number of the device

Example response

{
  "name": "Store 123 Device #2",
  "imei": "615022756680303",
  "group": {
    "self": "/default/group/myGroup",
    "name": "myGroup"
  },
  "battery": {
    "level": "100"
  },
  "serialnumber": "21BC01CF8DFF",
  "connection": {
    "dataUsage": {
      "appsDataUsage": [
        {
          "packageNames": [
            "com.myApp1",
            "com.myApp2"
          ],
          "uid": 10139
        }
      ]
    },
    "wifi": {
      "adapterMacAddress": "7e:8a:68:f2:40:10",
      "bssid": "9c:53:22:c6:a3:6f",
      "ssid": "MyNetwork"
    },
    "sim": [
      {
        "carrier": "T-Mobile - Twilio",
        "countryiso": "us",
        "iccid": "89883070000018591915",
        "mnc": "360",
        "mcc": "311"
      }
    ]
  },
  "os": {
    "configuration": {
      "product": "default",
      "project": "myProject",
      "version": "1"
    },
    "masonOS": {
      "release": "11",
      "incremental": "RD07C8FTLJFJ",
      "version": "6.2.5"
    }
  },
  "apps": [
    {
      "application": "com.example.myapplication",
      "version": "1"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.