manage timelines

List, create, duplicate, rename, configure, open and delete timelines, and keep one as a template. A change to a piece already made is edit_timeline on it, or a version (create with parent); create alone starts a new piece. list returns a page of timelines, newest edit first, each with name, id, last edit, clip count, duration, forked_from where duplicated, parent_id where it is a clip of a project, and on_feed. Duplicating (create with from) makes an alternate cut. create can take its shape and clips in the same call, placed as edit_timeline addClip places them, and returns the new timeline as get_timeline reads it with the placement notes and check. 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 shows a timeline in the user’s editor and returns its link. delete is permanent; a project holding clips is refused unless whole_project is set, and its feed post goes with it. Free.

POST

tools

manage_timelines

manage timelines

curl --request POST \
  --url https://eversince.ai/api/v1/tools/manage_timelines \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/manage_timelines"

payload = { "name": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/manage_timelines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

required

An API key (es_live_…) from Settings, under API keys, or an OAuth access token.

Headers

Idempotency-Key

string

Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again.

x-workspace-id

string

The workspace this one call acts in, when it is not the default: for a key or a connected agent, one of the workspaces the user allowed it.

Body

application/json

list

boolean

The workspace's timelines.

name

string

With list: only timelines whose name contains this, any case.

Required string length: 1 - 200

starred

boolean

Clips and timelines starred on their feed post, latest first, with starred_at.

find_text

string

Words to find inside timelines, whatever the case: an old tagline, a misspelling. Not their names: list with name. Returns each timeline holding them with every title, caption, graphic, chapter and note that does.

Required string length: 2 - 200

create

object

Show child attributes

template

object

Keep 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.

Show child attributes

rename

object

Show child attributes

settings

object

Composition size in pixels (setAspectRatio on edit_timeline is the shorthand for the standard sizes) and frame rate.

Show child attributes

open

object

Show this timeline in the user's editor as a tab, switched to; the editor opens on a computer, not a phone. The call cannot tell whether an editor is open to receive it.

Show child attributes

delete

object

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.

Show child attributes

limit

integer

Listing only: timelines per page. Default 50.

Required range: 1 <= x <= 100

cursor

string

next_cursor from the answer before.

context

string

Optional: one sentence shown to the user beside this action.

Maximum string length: 600

Response

Done, or a job started for work that runs longer (follow it with get_jobs).

any

required

data

object

required

meta

object

required

Show child attributes

media

object[]

manage timelines

curl --request POST \
  --url https://eversince.ai/api/v1/tools/manage_timelines \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'

import requests

url = "https://eversince.ai/api/v1/tools/manage_timelines"

payload = { "name": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://eversince.ai/api/v1/tools/manage_timelines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ok": true,
  "data": {},
  "meta": {
    "request_id": "<string>",
    "cost": {},
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  },
  "media": [
    {}
  ]
}

{
  "ok": false,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "suggested_action": "<string>",
    "cloud_processing": {
      "ran_on": "cloud",
      "minutes": 123,
      "charged_minutes": 123,
      "queued_minutes": 123,
      "left_minutes": 123,
      "held_minutes": 123,
      "bought_minutes": 123,
      "note": "<string>"
    }
  }
}

Discovery

Timeline

Workspace

Library

Canvas

Generation

Research

Account

Models

Uploads

Webhooks

manage timelines

Authorizations

Headers

Body

Response