Skip to main content
POST
Duplicate a Tella Motion document

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Tella Motion document ID (ffd_…), from GET /v1/motion/documents.

Body

application/json

Copy a document under the same owner. The copy is independent: later edits to either do not reach the other.

name
string
required

The copy's name.

Minimum string length: 1
Example:

"Topic title: Pricing"

commands
(setCurve · object | bindProperty · object | split · object | trim · object | delete · object | duplicate · object | setSpeed · object | setTransition · object | addTitle · object | addShape · object | addMedia · object | setTitle · object | setShape · object | animate · object | setProperty · object | setKeyframes · object | editKeyframe · object | removeKeyframes · object | addEffect · object | setEffect · object | removeEffect · object | moveEffect · object | setMasks · object | setMatte · object | group · object | ungroup · object | stagger · object | applyLook · object | fitCanvas · object | setMarkers · object | setTimeRemap · object | setExpression · object | setTextAnimation · object | addPath · object | setPath · object | duck · object | expect · object | setFades · object | op · object)[]

Edits to run on the copy, as POST /v1/motion/documents/{id}/commands takes them, e.g. setTitle to give the same title card another heading.

Required array length: 1 - 256 elements

One edit in a batch: an editor command (camelCase type, times in seconds) or an op (dotted type, raw render timeline values). See https://docs.tella.com/mcp-tools/motion-commands for every command and op with an example.

Response

Created

The copy and, with commands, the batch's result

document
object
required

A Tella Motion document: a render timeline (a tree of media, sound, text, shape, sequence and composition nodes) that a Tella Motion clip, overlay or b-roll plays live, so edits show in the video at once.

applied
object

With commands: the batch's result on the copy.