WIwithchima
Tella Motion

Add a Tella Motion clip

Changed on

Adds a clip at the end of a video that plays a blank Tella Motion document of its own, or your document documentId that no video plays yet, and returns the clip and its document. With documentId and no videoId, it makes a new video for the document, as large as its canvas, and returns its videoId and editUrl. Build what it shows with POST /v1/motion/documents/{id}/commands. The clip routes that edit layouts, cuts, zooms, overlays or the transcript refuse a Tella Motion clip; it can still be renamed, moved and deleted.

post/v1/motion/clips

Request

Request body

documentIdstring

A Tella Motion document of yours that no video plays yet, for the clip to play instead of a blank one. The video takes it over.

durationnumber

How long the clip plays, in seconds (default 10): the blank document's canvas length. Not with documentId, whose document keeps its own length.

namestring required

The clip's name, and the new video's when there is no videoId.

videoIdstring

The video (vid_…) to add the clip to. Leave it out, with documentId, for a new video.

Example request

{
  "documentId": "ffd_abc123",
  "duration": 4,
  "name": "Intro title",
  "videoId": "vid_abc123"
}

Response

Created

clipIdstring required
editUrlstring

The new video in the Tella editor, when the clip made one.

videoIdstring

The new video, when the clip made one.

Example response

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

Changes

  • dde1f23eeb8bRevision changes
    • info

      added the new optional request property

  • 240a74ea0ff7Revision changes
    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status