Skip to main content
POST
Edit 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

A batch of ops and editor commands, applied in order as one transaction and one undo step: nothing applies unless everything does.

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)[]
required
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.

baseRevision
integer

The seq you inspected. The batch is refused with 409 when the document has changed since.

Required range: 0 <= x <= 9007199254740991
dryRun
boolean

Check the batch without saving it.

Response

OK

The outcome of a batch. On failure ok is false and the error names the failing item's index; nothing is applied.

ok
boolean
required
changed
boolean
seq
integer

The document's revision after the batch.

Required range: -9007199254740991 <= x <= 9007199254740991
{key}
any