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

sourceId
string
required

Source ID from POST /v1/sources, with the bytes already uploaded to its uploadUrl

Example:

"su_abc123def456"

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.

Available options:
private,
workspace
Example:

"private"

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

Response

Created

The newly created library item

item
object
required

A reusable piece of media saved to a workspace's library — the same items the editor's media panels show