API reference · Account
Comment on a film
POST/api/studio/projects/{id}/commentsSigned in session
Pinned to a moment of the cut (at, seconds) or to one of its takes (asset_id), one of the two. At most 2000 characters, 500 a film (409 too_many_comments). Whoever may open the film: its maker, and for a team's film every member whose role edits films (owner, admin, member). The signed in account; same origin for a write.
Parameters
| Field | Type | What it is |
|---|---|---|
| id (path)required | string | The project's id, stp_ followed by hex. |
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| bodyrequired | string | At most 2000 characters. |
| at | number | At least 0. |
| asset_id | string | At most 80 characters. |
| label | string | At most 120 characters. |
Example
{
"body": "string",
"at": 0,
"asset_id": "string",
"label": "string"
}Answer 201
The comment.
| Field | Type | What it is |
|---|---|---|
| id | string | |
| object | string | One of "studio.comment". |
| body | string | |
| at | number or null | The moment of the cut, seconds. |
| asset_id | string or null | The take it is on. |
| label | string or null | |
| author | object | Who saved or wrote it: you, or a teammate by their wallet, shortened. |
| author. | boolean | |
| author. | string or null | |
| created_at | integer | |
| resolved_at | integer or null | |
| resolved_by | object or null | |
| can_delete | boolean |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 403OpenAI shaped error.
- 404OpenAI shaped error.
- 409OpenAI shaped error.
- 429OpenAI shaped error.
Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.