Connect device

Connect to the provided C2C Project.
SecurityC2COAuth2
Request
query Parameters

project_id
string
The project_id you intend to connect to
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
204
Succesful response after identifying the device.
post/v2/devices/connect
Request samples
curl
JavaScript
Node.js
Python
C#
Response samples
application/json
{"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"asset_type": "video",
"creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
"deleted_at": "2021-08-03T00:00:00Z",
"device_id": "3bafab7b-4400-4bcf-8e6e-09f954699940",
"inserted_at": "2021-08-03T00:00:00Z",
"last_seen_at": "2021-08-03T00:00:00Z",
"name": "string",
"project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
"updated_at": "string",
"status": "offline",
"timezone": "string",
"authorization": {"_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"
},
"project": {"archive_status": "standard",
"archived_at": "2019-08-24T14:15:22Z",
"archived_file_count": 0,
"archived_storage": 0,
"collaborator_count": 0,
"deleted_at": "2019-08-24T14:15:22Z",
"description": "string",
"file_count": 0,
"folder_count": 0,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"ignore_archive": false,
"inserted_at": "2019-08-24T14:15:22Z",
"invite_url": "string",
"name": "string",
"owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
"private": false,
"project_preferences": {"collaborator_can_download": true,
"collaborator_can_invite": true,
"collaborator_can_share": true,
"notify_on_new_asset": true,
"notify_on_new_collaborator": true,
"notify_on_new_comment": true,
"notify_on_updated_label": true,
"notify_slack": true
},
"read_only": false,
"root_asset": {"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"archive_from": "2019-08-24T14:15:22Z",
"archive_scheduled_at": "2019-08-24T14:15:22Z",
"archive_status": "string",
"archived_at": "2019-08-24T14:15:22Z",
"asset_type": "document",
"bundle": true,
"bundle_view": "string",
"cover_asset_id": "6bd8f503-67d9-4b55-b7c3-e1b6bef82750",
"creator": {"digest_frequency": "string",
"features_seen": null,
"profile_image_original": null,
"image_32": "string",
"image_128": "string",
"from_google": true,
"mfa_enforced_at": "string",
"email": "string",
"bio": null,
"name": "string",
"image_64": "string",
"timezone_value": "string",
"account_id": "string",
"updated_at": "string",
"image_256": "string",
"_type": "string",
"user_hash": "string",
"context": null,
"upload_url": "string",
"location": null,
"phone": null,
"deleted_at": null,
"profile_image": "string",
"first_login_at": "string",
"joined_via": "string",
"email_confirm_by": null,
"id": "string",
"next_digest_date": "string",
"email_preferences": null,
"last_seen": "string",
"inserted_at": "string",
"roles": {"admin": true,
"id": "string",
"sales": true,
"support": true
},
"user_default_color": "string"
},
"frames": 0,
"hard_deleted_at": "2019-08-24T14:15:22Z",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"index": 0,
"is_bundle_child": true,
"is_hls_required": true,
"is_session_watermarked": true,
"item_count": 0,
"label": "approved",
"metadata": { },
"metadata_flags": {"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"is_360": true,
"is_hdr": true,
"is_original_player_compatible": true
},
"name": "string",
"original": "string",
"parent_asset_id": "a7612734-1419-43cf-9bc9-c7901ea79e60",
"project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
"properties": {"": "string"
},
"required_transcodes": {"cover": true,
"finalized": ["thumb"
],
"h264_1080_best": true,
"h264_2160": true,
"h264_360": true,
"h264_540": true,
"h264_720": true,
"image_full": true,
"image_high": true,
"page_proxy": true,
"thumb": true,
"thumb_540": true,
"thumb_orig_ar_540": true,
"thumb_scrub": true
},
"team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",
"user_permissions": {"can_download": true,
"can_modify_template": true,
"can_public_share_presentation": true,
"can_public_share_review_link": true,
"can_share_downloadable_presentation": true,
"can_share_downloadable_review_link": true,
"can_share_unwatermarked_presentation": true,
"can_share_unwatermarked_review_link": true
},
"type": "file",
"view_count": 0
},
"root_asset_id": "e2e8cb12-c966-48e3-9079-2267fba907a1",
"shared": false,
"storage": 0,
"team": {"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"disable_sbwm_internally": false,
"creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
"storage": 0,
"default_font_color": "string",
"access": "private",
"font_color": "string",
"user_role": { },
"file_count": 0,
"default_session_watermark_template": {"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"app_default": false,
"creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"watermark_blocks": [{"alpha": 0.5,
"data_points": [{"order": null,
"type": null,
"value": null
}
],
"font_size": "small",
"name": "string",
"position": "top_left",
"position_reference_point": "top_left",
"position_x": 0,
"position_y": 0,
"scroll_text": "none",
"text_alignment": "left",
"text_color": "#FFFFFF",
"text_shadow": false
}
]
},
"link": "string",
"asset_lifecycle_policy": 0,
"upload_url": "string",
"admin_only_actions": {"lifecycle": false
},
"deleted_at": "2019-08-24T14:15:22Z",
"default_background_color": "string",
"storage_limit": 0,
"location": "string",
"name": "string",
"default_color": "string",
"slack_webhook": { },
"image_64": "string",
"archived_storage": 0,
"image_128": "string",
"solo": false,
"account": {"invoice_emails": ["string"
],
"city": "string",
"account_default_color": "string",
"company_name": "string",
"storage": 0,
"file_count": 0,
"owner": {"digest_frequency": "string",
"features_seen": null,
"profile_image_original": null,
"image_32": "string",
"image_128": "string",
"from_google": true,
"mfa_enforced_at": "string",
"email": "string",
"bio": null,
"name": "string",
"image_64": "string",
"timezone_value": "string",
"account_id": "string",
"updated_at": "string",
"image_256": "string",
"_type": "string",
"user_hash": "string",
"context": null,
"upload_url": "string",
"location": null,
"phone": null,
"deleted_at": null,
"profile_image": "string",
"first_login_at": "string",
"joined_via": "string",
"email_confirm_by": null,
"id": "string",
"next_digest_date": "string",
"email_preferences": null,
"last_seen": "string",
"inserted_at": "string",
"roles": {"admin": true,
"id": "string",
"sales": true,
"support": true
},
"user_default_color": "string"
},
"upload_url": "string",
"deleted_at": "2019-08-24T14:15:22Z",
"line1": "string",
"postal_code": "string",
"vat": "string",
"company_address": "string",
"lifetime_file_count": 0,
"state": "string",
"teams": [{ }
],
"image_64": "string",
"archived_storage": 0,
"image_128": "string",
"owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
"user_count": 0,
"locked_at": "2019-08-24T14:15:22Z",
"image": "string",
"team_count": 0,
"collaborator_role_count": 0,
"billing_emails": "string",
"image_32": "string",
"unpaid_at": "2019-08-24T14:15:22Z",
"inserted_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"project_count": 0,
"duration": 0,
"delinquent_at": "2019-08-24T14:15:22Z",
"collaborator_count": 0,
"plan": {"archived_storage_limit": 0,
"autoscaling": true,
"available_features": {"archival_storage": true,
"custom_branded_emails": true,
"custom_branded_presentations": true,
"reel_player": true,
"secure_sharing": true,
"session_based_watermarking": true,
"team_only_comments": true
},
"collaborator_limit": 0,
"cost": 0,
"default_plan": true,
"deleted_at": "2019-08-24T14:15:22Z",
"enterprise": true,
"file_limit": 0,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"inserted_at": "2019-08-24T14:15:22Z",
"lifetime_file_limit": 0,
"member_limit": 0,
"name": "string",
"payment_method": "stripe",
"period": "monthly",
"project_limit": 0,
"storage_limit": 0,
"team_limit": 0,
"tier": "free",
"title": "string",
"updated_at": "2019-08-24T14:15:22Z",
"user_limit": 0,
"user_max": 0,
"version": 0
},
"watermark": {"image": {"alpha": 0.5,
"image": {"bucket": "string",
"key": "string",
"type": "image/jpeg",
"uploaded": false
},
"position": "top_left"
},
"text": {"alpha": 0.5,
"lines": ["string"
],
"position": "top"
}
},
"folder_count": 0,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"display_name": "string",
"country": "string",
"subscription": {"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"archived_storage_limit": 0,
"balance": 0,
"cancellation_option": "string",
"cancellation_reason": "string",
"cancelled_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"inserted_at": "2019-08-24T14:15:22Z",
"last_payment_at": "2019-08-24T14:15:22Z",
"member_limit": 0,
"next_bill_at": "2019-08-24T14:15:22Z",
"on_trial": true,
"plan": {"archived_storage_limit": 0,
"autoscaling": true,
"available_features": {"archival_storage": true,
"custom_branded_emails": true,
"custom_branded_presentations": true,
"reel_player": true,
"secure_sharing": true,
"session_based_watermarking": true,
"team_only_comments": true
},
"collaborator_limit": 0,
"cost": 0,
"default_plan": true,
"deleted_at": "2019-08-24T14:15:22Z",
"enterprise": true,
"file_limit": 0,
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"inserted_at": "2019-08-24T14:15:22Z",
"lifetime_file_limit": 0,
"member_limit": 0,
"name": "string",
"payment_method": "stripe",
"period": "monthly",
"project_limit": 0,
"storage_limit": 0,
"team_limit": 0,
"tier": "free",
"title": "string",
"updated_at": "2019-08-24T14:15:22Z",
"user_limit": 0,
"user_max": 0,
"version": 0
},
"plan_id": "00713021-9aea-41da-9a88-87760c08fa72",
"promotion_expires_at": "2019-08-24T14:15:22Z",
"promotion_id": "27271a4f-601a-4379-9d7d-c9febeff12e4",
"requires_autoscaling": true,
"storage_limit": 0,
"subscription_end_at": "2019-08-24T14:15:22Z",
"total_archived_storage_limit": 0,
"total_lifetime_file_limit": 0,
"total_member_limit": 0,
"total_project_limit": 0,
"total_storage_limit": 0,
"total_user_limit": 0,
"updated_at": "2019-08-24T14:15:22Z",
"user_limit": 0
},
"account_members": [{"accepted_at": "2019-08-24T14:15:22Z",
"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"declined_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"inserted_at": "2019-08-24T14:15:22Z",
"role": "admin",
"updated_at": "2019-08-24T14:15:22Z",
"user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
}
],
"frames": 0,
"member_count": 0,
"image_256": "string"
},
"image_32": "string",
"inserted_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"project_count": 0,
"duration": 0,
"team_image": "string",
"collaborator_count": 0,
"bio": "string",
"color": "string",
"email_branding": {"accent_color": "string",
"background_color": "string",
"image": {"bucket": "string",
"key": "string",
"type": "image/jpeg",
"uploaded": false
}
},
"folder_count": 0,
"dark_theme": false,
"default_session_watermark_template_id": "cfb3efe2-1061-4d0c-8f9c-90a094c1a06d",
"session_watermark_templates": [{"account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65",
"app_default": false,
"creator_id": "9cceffdd-8381-4074-8256-eafae24ebee6",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"watermark_blocks": [{"alpha": 0.5,
"data_points": [null
],
"font_size": "small",
"name": "string",
"position": "top_left",
"position_reference_point": "top_left",
"position_x": 0,
"position_y": 0,
"scroll_text": "none",
"text_alignment": "left",
"text_color": "#FFFFFF",
"text_shadow": false
}
]
}
],
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"member_limit": 0,
"frames": 0,
"member_count": 0,
"image_256": "string",
"background_color": "string"
},
"team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",
"updated_at": "2019-08-24T14:15:22Z",
"user_permissions": {"can_download": true,
"can_modify_template": true,
"can_public_share_presentation": true,
"can_public_share_review_link": true,
"can_share_downloadable_presentation": true,
"can_share_downloadable_review_link": true,
"can_share_unwatermarked_presentation": true,
"can_share_unwatermarked_review_link": true
},
"user_preferences": {"collaborator_can_download": true,
"collaborator_can_invite": true,
"collaborator_can_share": true,
"notify_on_new_asset": true,
"notify_on_new_collaborator": true,
"notify_on_new_comment": true,
"notify_on_updated_label": true,
"notify_slack": true
},
"watermark": {"image": {"alpha": 0.5,
"image": {"bucket": "string",
"key": "string",
"type": "image/jpeg",
"uploaded": false
},
"position": "top_left"
},
"text": {"alpha": 0.5,
"lines": ["string"
],
"position": "top"
}
}
},
"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"
}
],
"channel_count": 100,
"path_asset_type": "string",
"path_name": "string",
"required_metadata_attributes": ["string"
]
}
Connect device

query Parameters

header Parameters

Overview

Integrations

Company

Support
