Listing devices

Retrieve a list of all devices in your organization.

REQUEST
curl
curl -X GET https://api.teleport.withthegrid.com/v1/device/ \
-H 'authorization:Bearer [token]'
RESPONSE
successful responses
201
List of devices
body for status 201 (in TS)
{
devices: {
hashId: string;
name: string;
cloudApi: "READ" | "READ_WRITE";
reportingInterval: number;
dataForwarding: boolean;
assets: {
type: string;
identifier: string;
}[];
}[];
}
details for body status 201 (in TS)
devices[].cloudApi
"READ" means that the device is visible in the Teleport Cloud API, but requests to schedule asset commands or setting asset parameters for them will be rejected. "READ_WRITE" means that scheduling asset commands and setting asset parameters is allowed.

devices[].reportingInterval
In seconds. Applies to the default report type of each asset, like "solarPower", "windPower" and "batteryPower". Does not apply to auxilary reports like "batteryPower.flash".

devices[].dataForwarding
Whether data forwarding is enabled for this device. See https://teleport.withthegrid.com/data-forwarding/ for more information.
error responses (next to generic errors)
No other error responses than the generic ones.