POST /devices/{serial_number}/install

Install a device at a location

This endpoint allows you to associate a specific DTM device with a designated location.

Install a device at a location

Install a device at a location

post

/devices/{serial_number}/install

Authorizations

Path parameters

serial_numberstringrequired

serial_number

Body

location_idstringrequired

Example: loc_xxxxx

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.getdor.com/dtm-api/v1/devices/{serial_number}/install' \
  --header 'Authorization: Basic username:password' \
  --header 'Content-Type: application/json' \
  --data '{"location_id":"loc_xxxxx"}'

200

400

404

200

{
  "data": {
    "created_at": "2021-10-10T00:00:00Z",
    "deleted_at": "2021-10-10T00:00:00Z",
    "device": {
      "serial_number": "AA000000",
      "device_type_name": "DTM",
      "firmware_version_name": "1.0.0",
      "last_checkin_at": "2021-10-10T00:00:00Z"
    },
    "location": {
      "name": "AA000000",
      "id": "loc_xxxxx",
      "address": {
        "address_1": "1234 Demo Street",
        "address_2": "text",
        "city": "San Francisco",
        "administrative_area": "CA",
        "country": "United States",
        "postal_code": 94110
      }
    }
  },
  "meta": {}
}

Successful operation