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), or default (Tella's curated sound effect and background music catalogs, which hold no other media type)

Available options:
private,
workspace,
default
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
Example:

"video"

cursor
string

Pagination cursor from a previous response. Keep paging while cursor is present. scope=default is a fixed catalog returned as a single page, so it never sets 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.

Last modified on October 6, 2026