Get device details

This action will return a specific device matching the given UUID.

Try this request in your browser

/api/ /devices/info

Headers

X-Auth-App
X-Auth-Token
X-Auth-Secret
X-Auth-Extension
X-Auth-Password
X-Proxy-Auth-Token
X-Proxy-Auth-Secret

Parameters

uuid String

Structures

Include extended attributes?
Include expansions?

The request output will be shown here...

URL

https://connectapi.dial9.co.uk/api/v2/devices/info

Access

Must be authenticated as a user or API token. If not authorised, a AccessDenied error will be returned.

Parameters

Parameter Type Default

uuid Required

The UUID of the device

String null

Errors

Error Attributes

DeviceNotFound

No device was found given the UUID provided

  • uuid

    The provided UUID

NoAccessToDevice

Your authenticated identity is not permitted to access this device

Response Data

This action will return a device structure.

You'll receive all extended data with this structure, by default. You can change this behaviour by passing true or false in the _full parameter on the request. By default, you'll receive all expansions for the structure. You remove any/all of them by providing an array of new expansion names in the _expansions parameter on the request.