Device Information | Frame.io API Documentation

{
  "_type": "project_device",
  "id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
  "asset_type": "video",
  "creator_id": "8437941d-dad1-467d-ba57-6758be7c5598",
  "device_id": "a6bde4d5-433d-40d9-89db-da46c484a499",
  "inserted_at": "2025-10-23T20:17:41.997130Z",
  "last_seen_at": "2025-10-23T20:28:33Z",
  "last_known_firmware_version": "1.0.0",
  "name": "Jpg-C2C-Hardware-123456789000000000",
  "project_id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
  "updated_at": "2025-10-23T20:28:33.037163Z",
  "status": "offline",
  "timezone": "America/New_York",
  "authorization": {
    "_type": "project_device_authorization",
    "creator": {
      "_type": "user",
      "id": "8437941d-dad1-467d-ba57-6758be7c5598",
      "name": "Charlie Anderson"
    },
    "creator_id": "8437941d-dad1-467d-ba57-6758be7c5598",
    "id": "ec45e65f-ab5e-4c00-b56a-8edb14a2d6de",
    "inserted_at": "2025-10-23T20:28:33.033487Z",
    "project_device_id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
    "scopes": {
      "account_read": false,
      "action_create": false,
      "action_delete": false,
      "action_read": false,
      "action_update": false,
      "asset_create": true,
      "asset_delete": false,
      "asset_read": false,
      "asset_update": false,
      "auditlog_read": false,
      "comment_create": false,
      "comment_delete": false,
      "comment_read": false,
      "comment_update": false,
      "device_connect": false,
      "id": "string",
      "offline": true,
      "presentation_create": false,
      "presentation_delete": false,
      "presentation_read": false,
      "presentation_update": false,
      "project_create": false,
      "project_delete": false,
      "project_read": false,
      "project_update": false,
      "reviewlink_create": false,
      "reviewlink_delete": false,
      "reviewlink_read": false,
      "reviewlink_update": false,
      "team_create": false,
      "team_read": false,
      "team_update": false,
      "webhook_create": false,
      "webhook_delete": false,
      "webhook_read": false,
      "webhook_update": false
    },
    "expires_at": null
  },
  "project": {
    "id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
    "name": "C2C Demo v3",
    "_type": "project"
  },
  "channels": [
    {
      "_type": "project_device_channel",
      "id": "5fc73e79-1de7-4f8a-b016-6763e54d8c29",
      "actor_id": "8437941d-dad1-467d-ba57-6758be7c5598",
      "asset_type": "video",
      "device_id": "a6bde4d5-433d-40d9-89db-da46c484a499",
      "external_index": 0,
      "inserted_at": "2025-10-23T20:17:41.999683Z",
      "name": "Jpg C2C Hardware",
      "project_id": "57b04261-a440-480b-b0e5-c2d3dee7591b",
      "project_device_id": "4f2da3a9-71a3-4ab2-bcfe-b15a1b2c88e7",
      "real_time_logging_capable": false,
      "status": "offline",
      "updated_at": "2025-10-23T20:17:41.999683Z"
    }
  ]
}

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.

Authentification

AuthorizationBearer

Authentification bearer de la forme Bearer <token>, où token est votre jeton d’authentification.

En-têtes

x-client-versionstringOptionnelPar défaut 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/

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/

Réponse

Device information response

_typestringPar défaut project_device

Resource type identifier

idstringformat: "uuid"

asset_typestring

The type of asset that this device will be producing

creator_idstringformat: "uuid"

deleted_atstringformat: "date-time"

device_idstringformat: "uuid"

inserted_atstringformat: "date-time"

last_seen_atstringformat: "date-time"

last_known_firmware_versionstring

The last known firmware version reported by the device

namestring<=255 characters

Name of this device as shown in the iOS app and web app

project_idstringformat: "uuid"

The Project ID that this device is linked to

updated_atstring

statusenum

timezonestring

authorizationobject

Authorization details for a project device

projectobject

channelslist of objects

channel_countinteger<=100

path_asset_typestring<=50 characters

path_namestring<=50 characters

required_metadata_attributeslist of strings

Erreurs

401

Unauthorized Error

1	import requests
2
3	url = "https://api.frame.io/v2/devices/me"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())