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. 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 instead of saving an uploaded source. Tella copies the image, and the returned item's sourceId places it like any other image.

Available options:
pinterest,
arena,
mymind
Example:

"pinterest"

name
string

Display name shown in the library. Defaults to the item's type.

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