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 library the item belongs to: workspace items are shared with everyone in the workspace, private items are only visible to their creator

Available options:
private,
workspace
Example:

"private"

type
enum<string>

Only return items of this 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.

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.