Skip to main content
GET
List library items

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Query Parameters

scope
enum<string>
required

Which set of media to read: private (only visible to their creator), workspace (shared with everyone in the workspace), video (one video's own library, the editor's "This video" tab; pass videoId), default (Tella's curated sound effect and background music catalogs, and company logos with type=logo), pinterest, arena or mymind (the images you saved in that service, once you connect it under Settings → Connections), or vintage (Tella's catalog of public-domain vintage film shots). Bring a pinterest, arena, mymind or vintage item in with POST /v1/library and from.

Available options:
private,
workspace,
video,
default,
pinterest,
arena,
mymind,
vintage
Example:

"private"

type
enum<string>

Only return items of this type. With scope=default only sound-effect, music and logo are valid; omitting it returns the sound effects and music. logo is valid with scope=default only, and needs query.

Available options:
image,
video,
sound-effect,
music,
lut,
screenshot,
font,
logo
Example:

"video"

videoId
string

With scope=video only, and required there: the video whose library to list. Requires edit access to that video.

Example:

"vid_abc123def456"

query
string

With scope=pinterest, arena, mymind or vintage: words to search for. Omit to list your newest saves, or with vintage, to browse featured films. With scope=default and type=logo, required: the company to find, by name or domain.

Example:

"mountain logo"

collection
string

With scope=pinterest, arena or mymind only: one of your boards, channels or spaces, by its name, id or address (an Are.na channel can be anyone's public one). Lists its images, and adds the collection with its description to the response; query is ignored.

Example:

"Moodboard"

cursor
string

Pagination cursor from a previous response. Keep paging while cursor is present. scope=default is a fixed catalog, and pinterest, arena and mymind return a single page of your newest saves or best matches, so they never set one. vintage pages through its results.

limit
integer

Items per page (1-60, default 24). Treat it as a target rather than an exact count: pages are read from storage before unlistable items are filtered out, and cursors address whole storage pages, so a response may contain somewhat more than limit. Returning the extra items is deliberate — trimming them would drop them, because the cursor has already moved past.

Required range: 1 <= x <= 60
Example:

24

Response

OK

A page of library items

items
object[]
required
cursor
string

Cursor for the next page. Absent when there are no more items.