Skip to main content
POST
Start a bulk run

Authorizations

Authorization
string
header
required

A Melius API key (mel_...), sent as Authorization: Bearer <key>.

x-team-id
string
header
required

The team (workspace) to act on. Defaults to the key's team when omitted.

Path Parameters

canvasId
string<uuid>
required

Body

application/json

Body

nodeIds
string<uuid>[]
required
Required array length: 1 - 500 elements
imageUrls
string<uri>[]
numVariations
integer
Required range: 1 <= x <= 10
matchAudioToVideoDurationNodeIds
string<uuid>[]
Maximum array length: 500

Response

201

id
string<uuid>
required
canvasId
string<uuid>
required
status
enum<string>
required
Available options:
pending,
running,
finished,
failed
totalNodes
integer
required
completedNodes
integer
required
failedNodes
integer
required
skippedNodes
integer
required
nodeEntries
object[]
required
createdAt
string<date-time>
required
Last modified on July 17, 2026