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), default (Tella's curated sound effect and background music catalogs, which hold no other media type), or pinterest, arena or mymind (the images you saved in that service, once you connect it under Settings → Connections; bring one in with POST /v1/library and from)

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

"private"

type
enum<string>

Only return items of this type. With scope=default only sound-effect and music are valid, since the curated catalog holds no other media type; omitting it returns both.

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

"video"

query
string

With scope=pinterest, arena or mymind only: words to search your saves for. Omit to list your newest saves.

Example:

"mountain logo"

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.

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.