Skip to main content
POST
Add a source to the library

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json

Save an uploaded source to the library so it can be listed and reused later, or, with from, bring in an image you saved in a connected Pinterest, Are.na or mymind account, or a vintage film shot. LUT sources must be valid 3D .cube files with LUT_3D_SIZE at most 65. Apply a saved LUT using its item id in PATCH /v1/videos/{id}/clips/{clipId}/filters. Font sources must be .ttf or .otf files of at most 20 MB; the item is named after the font's family and its id is a text overlay's fontId.

sourceId
string
required

Source ID from POST /v1/sources, with the bytes already uploaded to its uploadUrl. With from, the id of an item from GET /v1/library?scope=<from> instead.

Example:

"su_abc123def456"

from
enum<string>

Bring an image in from your connected Pinterest, Are.na or mymind account, or a shot from Tella's vintage film catalog, instead of saving an uploaded source. Tella copies it, and the returned item's sourceId places it like any other image or video.

Available options:
pinterest,
arena,
mymind,
vintage
Example:

"pinterest"

name
string

Display name shown in the library. Defaults to the item's type, or for a vintage shot, the film's title and year.

Required string length: 1 - 255
Example:

"Intro camera take"

scope
enum<string>

Where to save the item (default: private). workspace shares it with everyone in the workspace and requires an owner or member role; viewers get a 403. video, with from set to pinterest, arena or mymind only, saves it to the library of the video named by videoId.

Available options:
private,
workspace,
video
type
enum<string>

Expected item type. Optional — the type is taken from the source's own kind; supplying a value that disagrees is an error.

Available options:
image,
video,
sound-effect,
lut,
font
videoId
string

With from and scope: "video": the video whose media library the image is saved to. Requires edit access to that video.

Example:

"vid_abc123def456"

Response

Created

The newly created library item

item
object
required

A placeable piece of media — either saved to a workspace's library, or an entry in Tella's curated catalog