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, or, with presetId, get a placeable company logo from the default library (not saved to a library). 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.

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, for a vintage shot, the film's title and year, or for a logo, the brand's name.

Required string length: 1 - 255
Example:

"Intro camera take"

presetId
string

In place of sourceId: the presetId of a logo item from GET /v1/library?scope=default&type=logo, the brand's domain. Returns that company's logo as an image named after the brand, with a sourceId to place it; nothing is saved to a library, and scope and videoId are ignored.

Example:

"stripe.com"

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 saves it to the library of the video named by videoId.

Available options:
private,
workspace,
video
sourceId
string

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. Required unless presetId is given.

Example:

"su_abc123def456"

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 scope: "video": the video whose media library (the editor's "This video" tab) the item 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