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

curl
JavaScript
Node.js
Python
C#

Response samples

application/json

{"_type": "project_device",
"asset_type": "video",
"authorization": {"_type": "project_device_authorization",
"creator": {"_type": "user",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string"
},
"creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
"expires_at": "2019-08-24T14:15:22Z",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"inserted_at": "2019-08-24T14:15:22Z",
"project_device_id": "a213991b-2425-45cf-811d-58054d333488",
"scopes": {"account_read": true,
"action_create": true,
"action_delete": true,
"action_read": true,
"action_update": true,
"asset_create": true,
"asset_delete": true,
"asset_read": true,
"asset_update": true,
"auditlog_read": true,
"comment_create": true,
"comment_delete": true,
"comment_read": true,
"comment_update": true,
"device_connect": true,
"id": "string",
"offline": true,
"presentation_create": true,
"presentation_delete": true,
"presentation_read": true,
"presentation_update": true,
"project_create": true,
"project_delete": true,
"project_read": true,
"project_update": true,
"reviewlink_create": true,
"reviewlink_delete": true,
"reviewlink_read": true,
"reviewlink_update": true,
"team_create": true,
"team_read": true,
"team_update": true,
"webhook_create": true,
"webhook_delete": true,
"webhook_read": true,
"webhook_update": true
}
},
"channels": [{"_type": "project_device_channel",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"actor_id": "04f37679-bfbf-4906-b749-01756515cecf",
"asset_type": "audio",
"device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
"external_index": 100,
"inserted_at": "2021-08-03T00:00:00Z",
"name": "string",
"project_id": "string",
"project_device_id": "string",
"real_time_logging_capable": false,
"status": "offline",
"updated_at": "2021-08-03T00:00:00Z"
}
],
"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": {"_type": "string",
"id": "string",
"name": "string"
},
"project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
"status": "online",
"timezone": "string",
"updated_at": "2019-08-24T14:15:22Z"
}