Tella Motion

Edit a Tella Motion document

Changed on Oct 29, 2026

Applies a batch of ops and the editor's own commands as one transaction and one undo step; nothing applies unless everything does. Prefer a command for anything the editor does (titles, shapes, media, keyframes and easing, effects, masks, text animation, fades), since it keeps the editor's conventions; use ops (node.patch, node.move, node.insert, …) for the rest. GET /v1/motion/schema?schema=edits&type=… gives each one's fields. Pass baseRevision to refuse the batch with 409 if the document changed since you read it, and dryRun to check it without saving.

post/v1/motion/documents/{id}/commands

Request

Base URL
https://api.tella.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/motion/documents/:id/commands/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

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

Request body

baseRevisioninteger

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

dryRunboolean

Check the batch without saving it.

Example request

{
  "commands": [
    {
      "type": "node.patch"
    }
  ]
}

Response

changedboolean

okboolean required

seqinteger

The document's revision after the batch.

Changes

Oct 29, 20266ae7d793a0a7 Revision changes
- breaking
  removed subschema #1 from the //// request property anyOf list
- breaking
  removed subschema #1 from the //// request property anyOf list
- breaking
  removed subschema #1 from the //// request property anyOf list
- breaking
  removed subschema #1 from the ////// request property anyOf list
- breaking
  removed subschema #1 from the /// request property anyOf list
- breaking
  removed subschema #1 from the ///// request property anyOf list
- info
  added the new optional request property /////
- info
  added the new optional request property /////
- info
  added subschema #1 subschema #3 to the //// request property anyOf list
- info
  added subschema #1 subschema #3 to the //// request property anyOf list
- info
  added subschema #1 subschema #3 to the //// request property anyOf list
- info
  added subschema #1 subschema #3 to the ////// request property anyOf list
- info
  added subschema #1 subschema #3 to the /// request property anyOf list
- info
  added subschema #1 subschema #3 to the ///// request property anyOf list
- info
  added the new alphaAdd enum value to the request property ////
- info
  added the new animatedDissolve enum value to the request property ////
- info
  added the new none enum value to the request property /////
- info
  added the new premultipliedColorBurn enum value to the request property ////
- info
  added the new premultipliedColorDodge enum value to the request property ////
- info
  added the new premultipliedDifference enum value to the request property ////
- info
  added subschema #3 subschema #4 to the /// request property oneOf list
Oct 27, 2026b17798512a3c Revision changes
- breaking
  the / request property type changed from object to no type
- warning
  removed the request property //
- info
  added to the / request property anyOf list

Operation history (3 revisions)