Add device

Add a device to an organization.

Note: POST calls create new data, and do not affect existing data.

Request
Security:
bearerAuth
path Parameters
orgId
required
string

The ID of the organization. Obtain this from GET /organizations.

Example: 62
Request Body schema: application/json
name
required
string (Device name)

The name assigned to the device in the POST /organizations/{orgId}/devices call.

imei
required
string (IMEI)

The IMEI number of the device. The IMEI number can be found on a sticker on the device itself or on the back of the device box.

groupId
integer (Group ID) >= -1

The ID of the group. Obtain this from GET /organizations/{orgId}/devices. If a groupId of -1 is selected, the device will be added without being assigned to any group.

Responses
200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

409

Conflict error

500

Internal server error

post/organizations/{orgId}/devices
Request samples
application/json
{
  • "name": "Aragorn's car",
  • "imei": "357660101000198",
  • "groupId": 32
}
Response samples
    2 more
    409
    500
application/json
{
  • "requestId": "df5fg-45fgfdsg-45fg-45454"
}