List library items
Returns a page of reusable media saved to the library — images, videos, sound effects, music and LUTs — for one scope. Items added through the API include a sourceId you can pass anywhere a source is accepted, including images. Editor-added images, music and LUTs expose a hosted url instead. Media still being generated in the editor is omitted. scope=default returns Tella’s curated sound effect catalog instead of stored media: those items carry a presetId to place them with, a category, and a publicly fetchable url for previewing, and arrive as a single page. Tella’s default backgrounds are not part of this catalog — they are placed as a background rather than as a source, and are listed by GET /v1/backgrounds.
Authorizations
API key obtained from your Tella account settings
Query Parameters
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)
private, workspace, default "private"
Only return items of this type. With scope=default only sound-effect is valid, since the curated catalog holds no other media type.
image, video, sound-effect, music, lut "video"
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.
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.
1 <= x <= 6024