manage timelines
List, create, duplicate, rename, configure, open and delete timelines, and keep one as a template. list returns a page of timelines, newest edit first, each with name, id, last edit, editor link, clip count, duration, forked_from where duplicated and parent_id where it is a clip of a project. Duplicating (create with from) is how variations are made. template keeps a finished piece as a shape: its picture clips become holes, get_templates lists it, and create with from_template and fill copies it with new files in the holes in one call. find_text finds wording in every timeline’s titles, captions, graphics and chapters. open opens a timeline in the user’s editor as a tab. delete is permanent; a project holding clips is refused unless whole_project is set, and its feed post goes with it. Free.
Authorizations
An API key (es_live_…) from Settings, under API keys, or an OAuth access token.
Headers
Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.
The workspace this one call acts in, when it is not the key's own.
Body
The workspace's timelines, newest edit first.
Words to find in every timeline, whatever the case: an old tagline, a misspelled name. Returns each timeline holding them with every title, caption, graphic, chapter and note that does.
2 - 200Keep a timeline as a starting shape, or stop. Its pictures and its titles become the holes a copy fills; clear the ones that should stay, and say what belongs in each with edit_timeline updateClip placeholder.
Composition size in pixels (setAspectRatio on edit_timeline is the shorthand for the standard sizes) and frame rate.
Show this timeline in the user's editor as a tab, switched to. The call cannot tell whether an editor is open to receive it.
Take a timeline away for good. There is no trash. A clip of a project goes on its own; a project goes with its clips only when whole_project says so, and its post leaves the feed with it.
Listing only: timelines per page. Default 50.
1 <= x <= 100next_cursor from the answer before: the next page of the list.
Optional: one sentence shown to the user beside this action.
600
