Create a Comment from a C2C device | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/devices/assets/asset_id/comments"
payload = { "text": "string" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "annotation": "string",
  "completed": false,
  "completed_at": "string",
  "completer_id": "string",
  "has_replies": false,
  "id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
  "like_count": 0,
  "owner": {
    "digest_frequency": "0 * * * *",
    "features_seen": "string",
    "profile_image_original": "string",
    "image_32": "string",
    "image_128": "string",
    "from_google": false,
    "mfa_enforced_at": "string",
    "email": "jane@frame.io",
    "bio": "string",
    "name": "Jane Doe",
    "image_64": "string",
    "timezone_value": "America/New_York",
    "account_id": "string",
    "updated_at": "2025-12-19T14:55:05.324848Z",
    "image_256": "string",
    "_type": "user",
    "context": {
      "company_name": "string",
      "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "industry": "string",
      "job_title": "string",
      "role": "string",
      "team_size": 2
    },
    "upload_url": "string",
    "location": "string",
    "phone": "string",
    "deleted_at": "string",
    "profile_image": "https://static-assets.frame.io/app/anon.jpg",
    "first_login_at": "2025-09-17T18:09:39.768640Z",
    "joined_via": "organic",
    "email_confirm_by": "string",
    "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "next_digest_date": "2025-09-17T18:09:35.668306Z",
    "email_preferences": "string",
    "last_seen": "string",
    "inserted_at": "2025-09-17T18:09:35.685694Z",
    "from_adobe": true,
    "avatar_color": "yellow",
    "highest_account_role": "string",
    "integrations": [
      "string"
    ],
    "roles": {
      "admin": false,
      "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "sales": true,
      "support": true,
      "service_desk": false
    },
    "user_default_color": "#ff409f"
  },
  "owner_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "text": "This is a comment from the camera",
  "timestamp": 33,
  "_type": "comment",
  "anonymous_user_id": "string",
  "aspect_ratio": 1.777778,
  "asset_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "comment_entities": [],
  "deleted_at": "string",
  "device_channel_input_id": "string",
  "duration": 1,
  "fov": 65,
  "frame": 33,
  "inserted_at": "2026-01-28T19:31:40.501158Z",
  "page": 1,
  "parent_id": "string",
  "pitch": 1,
  "private": true,
  "read_count": 0,
  "review_link_id": "string",
  "target_asset_id": "string",
  "text_edited_at": "string",
  "thumb": "string",
  "timestamp_microseconds": 1,
  "updated_at": "2026-01-28T19:31:40.523368Z",
  "yaw": 1
}

Leave a comment on an Asset from a paired C2C device.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

asset_idstringRequiredformat: "uuid"

Asset ID

Request

Comment to create or update

textstringRequired

The body of the comment.

timestampdoubleOptional

Timestamp for the comment, in frames, starting at 0. Comments can be "global" to an asset in which you don't provide the timestamp.

Response

C2C Comment success response

annotationstringOptional

completedbooleanOptional

completed_atstringOptional

completer_idstringOptionalformat: "uuid"

has_repliesbooleanOptional

idstringOptionalformat: "uuid"

like_countintegerOptional

ownerobjectOptional

User model

owner_idstringOptionalformat: "uuid"

textstringOptional

timestampintegerOptional

_typestringOptional

anonymous_user_idstringOptionalformat: "uuid"

aspect_ratiodoubleOptional

asset_idstringOptionalformat: "uuid"

comment_entitieslist of anyOptional

deleted_atstringOptional

device_channel_input_idstringOptional

durationintegerOptional

fovintegerOptional

framedoubleOptional

inserted_atstringOptional

pageintegerOptional

parent_idstringOptionalformat: "uuid"

pitchintegerOptional

privatebooleanOptional

read_countintegerOptional

review_link_idstringOptionalformat: "uuid"

target_asset_idstringOptionalformat: "uuid"

text_edited_atstringOptional

thumbstringOptional

timestamp_microsecondsintegerOptional

updated_atstringOptional

yawintegerOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error