Create a Comment | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/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": "[...]",
  "completed": false,
  "completed_at": "2020-07-15T17:30:00.906305Z",
  "completer_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "has_replies": true,
  "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "like_count": 10,
  "owner": {
    "email": "jane@frame.io",
    "name": "Jane Doe",
    "account_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
    "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
  },
  "owner_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
  "text": "This is a comment.",
  "timestamp": 60
}

Authentication

AuthorizationBearer

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

Path parameters

asset_idstringRequiredformat: "uuid"

Request

Comment to create or update

textstringRequired

The body of the comment.

annotationstringOptional

Serialized list of geometry and/or drawing data. Learn more [here](https://developer.frame.io/docs/workflows-assets/working-with-annotations)

pageintegerOptional

Page number for a comment (documents only).

timestampdoubleOptional

Timestamp for the comment, in frames, starting at 0.

Comments can “global” to an asset in which you don’t provide the timestamp, or if you’re reviewing a “document” like a PDF then you would use page instead of timestamp to identify where the comment belongs.

durationintegerOptional

Used to produce range-based comments, this is the duration measured in frames.

privatebooleanOptional

Set to true to make your comment a “Team-only Comment” that won’t be visible to anonymous reviewers or Collaborators.

pitchintegerOptionalDeprecated

Pitch measurement for the comment (360deg video only).

yawintegerOptionalDeprecated

Yaw measurement for the comment (360deg video only).

Response

Comment success response

annotationstring

completedboolean

completed_atstring

completer_idstringformat: "uuid"

has_repliesboolean

idstringformat: "uuid"

like_countinteger

ownerobject

User model

owner_idstringformat: "uuid"

textstring

timestampinteger

Errors

401

Unauthorized Error

404

Not Found Error

1	import requests
2
3	url = "https://api.frame.io/v2/assets/asset_id/comments"
4
5	payload = { "text": "string" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"annotation": "[...]",
3	"completed": false,
4	"completed_at": "2020-07-15T17:30:00.906305Z",
5	"completer_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
6	"has_replies": true,
7	"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
8	"like_count": 10,
9	"owner": {
10	"email": "jane@frame.io",
11	"name": "Jane Doe",
12	"account_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
13	"id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
14	},
15	"owner_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
16	"text": "This is a comment.",
17	"timestamp": 60
18	}