Skip to main content
POST
Write or revise many scenes of a video project at once from briefs, then check them.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

canvasId
string
required

Body

application/json

A brief for each scene to write or revise

Request body for writing scenes from briefs

companyId
string
required

Company ID

scenes
object[]
required

The scenes to write or revise, each with its brief

direction
string

What every scene shares: the customer, tone, type treatment, motifs

beats
number[]

Beat times in seconds of the video

downbeats
number[]

Downbeat times in seconds of the video

Response

Scenes written, failures and the check frames

Scenes written from briefs

written
string[]

Scene ids written

failed
object

Scene id -> why it was not written

problems
object

Scene id -> problems still open on its check frame

other
string[]

Problems not tied to one scene

imageUrl
string

Contact sheet with one check frame per written scene

seconds
integer

Time the writers took