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.

Authentification

AuthorizationBearer

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

Paramètres de chemin

asset_idstringRequis

Requête

Comment to create or update

textstringRequis

The body of the comment.

timestampdoubleOptionnel

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

Réponse

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

Erreurs

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error