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.

scope'private' | 'workspace' | 'default' 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)

Example:private

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)

type'image' | 'video' | 'sound-effect' | 'music' | 'lut'

The kind of media the item holds

Example:video

Only return items of this type. With scope=default only sound-effect is valid, since the curated catalog holds no other media type.

cursorstring

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.

limitinteger

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.

Example:24

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.

Response

OK

cursorstring

Cursor for the next page. Absent when there are no more items.

Example response

{
  "items": [
    {
      "category": "Everyday",
      "durationMs": 4200,
      "id": "media_abc123def456",
      "name": "Intro camera take",
      "presetId": "cha-ching",
      "scope": "private",
      "sourceId": "su_abc123def456",
      "type": "video"
    }
  ]
}

List library items

Query parameters

Response

Example response

Changes