Device Information

Fetches information about the current device connection.

Can be used to verify authorization token and returns information useful to present useful information in your user interface.

SecurityC2CDeviceAuth or OAuth2
Request
header Parameters
x-client-version
string
Default: 0.0.0

Firmware or software version of a C2C integration. Will be used to determine the correct Device Model configuration for the device when multiple are available. Must be a valid semantic version.

For more on semantic versions, see here: https://semver.org/

Example: 2.16.4
Responses
200

Example response

Response Schema: application/json
_type
required
string
Value: "project_device"
asset_type
required
string
Enum: "video" "audio" "data"
required
object
required
Array of objects (ProjectDeviceChannel) non-empty unique
creator_id
required
string <uuid>
device_id
required
string <uuid>
id
required
string <uuid>
inserted_at
required
string <date-time>
last_seen_at
required
string <date-time>
name
required
string <= 250 characters
required
object
project_id
required
string <uuid>
status
required
string
Enum: "online" "offline" "paused"
timezone
required
string
updated_at
required
string <date-time> non-empty
deleted_at
string or null <date-time>
401

Unauthorized response

get/v2/devices/me
Request samples
Response samples
application/json
{
  • "_type": "project_device",
  • "asset_type": "video",
  • "authorization": {
    },
  • "channels": [
    ],
  • "creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
  • "deleted_at": "2019-08-24T14:15:22Z",
  • "device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "inserted_at": "2019-08-24T14:15:22Z",
  • "last_seen_at": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "project": {
    },
  • "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
  • "status": "online",
  • "timezone": "string",
  • "updated_at": "2019-08-24T14:15:22Z"
}