Skip to main content
POST
Create a node

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

id
string<uuid>
required
nodeType
enum<string>
required
Available options:
text,
image,
video,
audio,
file,
group,
custom_text,
pdf,
composite,
stitch,
magic_resize
geometry
object
required
title
string
groupId
string<uuid> | null
modelConfig
object | null
textPrompt
string | null
text
string
Maximum string length: 100000
outputAspectRatio
enum<string> | null
Available options:
21:9,
16:9,
4:3,
5:4,
3:2,
1:1,
2:3,
3:4,
4:5,
9:16,
9:21
outputDuration
integer | null
Required range: x > 0
outputResolution
Available options:
360p,
480p,
540p,
580p,
720p,
1080p,
1440p,
2160p,
4k,
0.5K,
1K,
2K,
4K,
1k,
2k
matchAudioToVideoDuration
boolean | null
seed
integer | null
Required range: 0 <= x <= 2147483647
negativePrompt
string | null
stitchClipOrder
string[] | null
stitchScaleFit
enum<string> | null
Available options:
fit,
stretch
stitchAudioOverlays
object[] | null
stitchClipTrims
object | null
voiceId
string | null
Minimum string length: 1
customVoiceId
string<uuid> | null
elevenLabsVoiceSettings
object | null
src
string<uri> | null
mediaType
enum<string> | null
Available options:
image,
video,
audio,
pdf
s3Key
string
s3Bucket
string
contentType
string
sourceNodeId
string<uuid>
groupType
enum<string> | null
Available options:
default,
unified,
template
templatePorts
object[] | null
templateId
string<uuid> | null

Response

201

id
string<uuid>
required
nodeType
enum<string>
required
Available options:
text,
image,
video,
audio,
file,
group,
custom_text,
pdf,
composite,
stitch,
magic_resize
geometry
object
required
groupId
string<uuid> | null
required
title
string
required
modelConfig
object | null
required
textPrompt
string | null
required
outputAspectRatio
enum<string> | null
required
Available options:
21:9,
16:9,
4:3,
5:4,
3:2,
1:1,
2:3,
3:4,
4:5,
9:16,
9:21
outputDuration
integer | null
required
Required range: x > 0
outputResolution
required
Available options:
360p,
480p,
540p,
580p,
720p,
1080p,
1440p,
2160p,
4k,
0.5K,
1K,
2K,
4K,
1k,
2k
seed
integer | null
required
Required range: 0 <= x <= 2147483647
negativePrompt
string | null
required
src
string | null
required
previewSrc
string | null
required
mediaType
enum<string> | null
required
Available options:
image,
video,
audio,
pdf
generatedText
string | null
required
activeVersionId
string<uuid> | null
required
assetDurationInMs
integer | null
required
Required range: x >= 0
createdByUserId
string<uuid> | null
required
autoModel
boolean | null
fastModel
boolean | null
matchAudioToVideoDuration
boolean | null
stitchClipOrder
string[] | null
stitchScaleFit
enum<string> | null
Available options:
fit,
stretch
stitchAudioOverlays
object[] | null
stitchClipTrims
object | null
voiceId
string | null
customVoiceId
string | null
elevenLabsVoiceSettings
object | null
Last modified on July 17, 2026