Device

The Device API manages device registation with the Builder.

When devices are first booted, they will "register" with the builder using their device ID (ClaimID). The device then remains under the management of the Builder until it is "claimed" by a user for management using the "claim" API.

When claimed, the device is redirected to the device cloud when it next invokes the "register" API.

Get

The Get API will fetch a device record by its ID (ClaimID).

Endpoint

POST /device/get

Authorized User Role

user

Request Body

Field	Type	Required	Notes
id	string	yes	Device Claim ID.

Response

Field	Type
id	string
accountId	string
managerAccountId	string
cloudId	string
productId	string
test	boolean

Find

Endpoint

POST /device/find

Authorized User Role

user

Request Body

Field	Type
id	string
cloudId	string
productId	string

Query String Options

Field	Type
limit	number
next	object
prev	object

Response

Paged response.

Field	Type	Notes
data	array	Array of items.
next	string	Paged cursor to use for the next page of items.
prev	string	Pages cursor to use for the previous page of items.

Device

An array of Device items.

Field	Type
id	string
accountId	string
managerAccountId	string
cloudId	string
productId	string
test	boolean

Register

Register a device when manufactured.

When devices are first booted during manufacturing test, the Ioto device agent will "register" with the builder using its device ID (ClaimID). If the device has been claimed by a user, the API will return a response containing the API address of the managing device cloud and an access token. If the device has not been claimed, the "registered" field will be set to true in the response (alone).

To register, supply the device claim ID and the product token ID. If the device is a test device only, set the "test" field to true
so that the device will not count toward your Ioto agent subscription count.
.

Endpoint

POST /device/register

Authorized User Role

public

Request Body

Field	Type	Required	Notes
id	string	yes	Device Claim ID.
account	string		Manager Account ID if auto claiming.
cloud	string		Cloud ID if auto claiming.
product	string	yes	Product ID Token.
test	boolean		Set to true for test devices.
*	any

Response

Field	Type	Notes
api	string	API endpoint for the device cloud that claimed the device.
token	string	Access token for requests to the device cloud.
registered	boolean	Set to true when registered.
cloudType	string	Type of cloud hosting.
cloudName	string	Cloud name.
cloudRegion	string	Cloud geographical region.

Release

Release a device from management by a device cloud

Releasing a device returns it to the builder to be available for claiming by another cloud.

Endpoint

POST /device/release

Authorized User Role

user

Request Body

Field	Type	Required	Notes
id	string	yes	Device claim ID.
callback	boolean
certArn	string

Remove

Remove a device from the builder.

If the device has been claimed by a device cloud, it should be released before being removed.

Endpoint

POST /device/remove

Authorized User Role

admin

Request Body

Field	Type	Required	Notes
id	string	yes	Device claim ID.