WIwithchima
Tella Motion

Create a Tella Motion document

Changed on

Creates a blank document, 10 s long (the canvas.set op changes that). With videoId it is the video's, as large as the video unless sized, for an overlay or b-roll you build in place. Without it the document is yours and in no video yet (1920×1080 unless sized); the first video it is placed in takes it over. Edit it with POST /v1/motion/documents/{id}/commands, then show it with POST /v1/videos/{id}/clips/{clipId}/overlays (motionDocumentId) or a layout's media: {type: "motion", documentId}. It plays there live, so later edits show in the video as you make them.

post/v1/motion/documents

Request

Request body

heightnumber

Canvas height in pixels. Defaults to the video's, or 1080 without a video.

namestring required

What it shows.

videoIdstring

The video (vid_…) that owns the document. Leave it out for one of your own that no video plays yet: the first video it is placed in takes it over.

widthnumber

Canvas width in pixels. Defaults to the video's, or 1920 without a video.

Example request

{
  "name": "Lower third",
  "videoId": "vid_abc123"
}

Response

Created

Example response

{
  "document": {
    "createdAt": "2026-10-22T10:00:00.000Z",
    "id": "ffd_abc123",
    "name": "Lower third",
    "ownerID": "vid_abc123",
    "scope": "story"
  }
}

Changes