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": "Great shot! The lighting here really enhances the mood." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "annotation": "Color grading suggestion",
  "completed": false,
  "completed_at": null,
  "completer_id": null,
  "has_replies": false,
  "id": "e3f1c9a2-7b4d-4f3a-9a2b-1d2e3f4a5b6c",
  "like_count": 3,
  "owner": {
    "digest_frequency": "0 * * * *",
    "features_seen": "commenting,uploading",
    "profile_image_original": "https://cdn.frame.io/profiles/janedoe_original.jpg",
    "image_32": "https://cdn.frame.io/profiles/janedoe_32.jpg",
    "image_128": "https://cdn.frame.io/profiles/janedoe_128.jpg",
    "from_google": false,
    "mfa_enforced_at": null,
    "email": "jane.doe@creativestudios.com",
    "bio": "Passionate about storytelling through video editing.",
    "name": "Jane Doe",
    "image_64": "https://cdn.frame.io/profiles/janedoe_64.jpg",
    "timezone_value": "America/New_York",
    "account_id": "acc-1234567890",
    "updated_at": "2025-12-19T14:55:05.324848Z",
    "image_256": "https://cdn.frame.io/profiles/janedoe_256.jpg",
    "_type": "user",
    "context": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "team_size": 5,
      "role": "Video Editor",
      "company_name": "Creative Studios",
      "industry": "Film & Video Production",
      "job_title": "Senior Editor"
    },
    "upload_url": "https://uploads.frame.io/user/janedoe",
    "location": "New York, NY",
    "phone": "+1-555-123-4567",
    "deleted_at": null,
    "profile_image": "https://cdn.frame.io/profiles/janedoe_128.jpg",
    "first_login_at": "2025-09-17T18:09:39.768640Z",
    "joined_via": "organic",
    "email_confirm_by": null,
    "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "next_digest_date": "2025-09-17T18:09:35.668306Z",
    "email_preferences": "daily",
    "last_seen": "2026-01-27T15:45:00Z",
    "inserted_at": "2025-09-17T18:09:35.685694Z",
    "from_adobe": true,
    "avatar_color": "yellow",
    "highest_account_role": "editor",
    "integrations": [
      "Adobe Premiere Pro",
      "DaVinci Resolve"
    ],
    "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": "Great shot! The lighting here really enhances the mood.",
  "timestamp": 33,
  "_type": "comment",
  "anonymous_user_id": null,
  "aspect_ratio": 1.777778,
  "asset_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "comment_entities": [],
  "deleted_at": null,
  "device_channel_input_id": "channel-01",
  "duration": 120,
  "fov": 65,
  "frame": 33,
  "inserted_at": "2026-01-28T19:31:40.501158Z",
  "page": 1,
  "parent_id": null,
  "pitch": 5,
  "private": true,
  "read_count": 0,
  "review_link_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
  "target_asset_id": null,
  "text_edited_at": null,
  "thumb": "https://cdn.frame.io/thumbs/comment1234.jpg",
  "timestamp_microseconds": 33000000,
  "updated_at": "2026-01-28T19:31:40.523368Z",
  "yaw": 10
}

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_idstringRequired

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

annotationstring

completedboolean

completed_atstring

completer_idstringformat: "uuid"

has_repliesboolean

idstringformat: "uuid"

like_countinteger

ownerobject

User model

owner_idstringformat: "uuid"

textstring

timestampinteger

_typestring

anonymous_user_idstringformat: "uuid"

aspect_ratiodouble

asset_idstringformat: "uuid"

comment_entitieslist of any

deleted_atstring

device_channel_input_idstring

durationinteger

fovinteger

framedouble

inserted_atstring

pageinteger

parent_idstringformat: "uuid"

pitchinteger

privateboolean

read_countinteger

review_link_idstringformat: "uuid"

target_asset_idstringformat: "uuid"

text_edited_atstring

thumbstring

timestamp_microsecondsinteger

updated_atstring

yawinteger

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error