Update a linked device | Aura Panic API

curl -X PUT https://staging-panic.aura.services/panic-api/v2/devices \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "customerId": 12345,
  "deviceSerial": "111111111111111AAABBBB",
  "deviceSupplier": "Sigfox",
  "deviceAlias": "Panic Button"
}'

{
  "message": "Successfully updated the device",
  "device": {
    "id": 12345,
    "customerId": 12345,
    "customerSourceId": 1,
    "deviceId": "string",
    "deviceSerial": "string",
    "alias": "Panic Button",
    "deviceTypeId": 1,
    "firmwareVersion": "string",
    "defaultLocation": {},
    "healthCheckLastReceivedDate": "2024-01-15T09:30:00Z",
    "batteryLevel": 1,
    "batteryLevelLastReceivedDate": "2024-01-15T09:30:00Z",
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z"
  }
}

Updates an existing device link, such as its type or alias.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

customerIdintegerRequired

deviceSerialstringRequired

deviceSupplierstringRequired

deviceAliasstringOptional

deviceTypeintegerOptional

Optional device type identifier. If omitted, AURA attempts to resolve the type from deviceSupplier. The supplied serial must still match the registered device template for that type or supplier.

firmwareVersionstring or integerOptional

Response

Successful.

messagestring

deviceobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error