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 catalog, which holds 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 is valid, since the curated catalog holds no other media type.

Available options:
image,
video,
sound-effect,
music,
lut
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.