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.

認証

AuthorizationBearer

Bearer <token>形式のBearer認証。tokenは認証トークンです。

パスパラメータ

asset_idstring必須

リクエスト

Comment to create or update

textstring必須

The body of the comment.

timestampdoubleオプション

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

レスポンス

C2C Comment success response

annotationstring

completedboolean

completed_atstring

completer_idstring形式: "uuid"

has_repliesboolean

idstring形式: "uuid"

like_countinteger

ownerobject

User model

owner_idstring形式: "uuid"

textstring

timestampinteger

_typestring

anonymous_user_idstring形式: "uuid"

aspect_ratiodouble

asset_idstring形式: "uuid"

comment_entitieslist of any

deleted_atstring

device_channel_input_idstring

durationinteger

fovinteger

framedouble

inserted_atstring

pageinteger

parent_idstring形式: "uuid"

pitchinteger

privateboolean

read_countinteger

review_link_idstring形式: "uuid"

target_asset_idstring形式: "uuid"

text_edited_atstring

thumbstring

timestamp_microsecondsinteger

updated_atstring

yawinteger

エラー

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error