WIwithchima
Library

Add a source to the library

Changed on

Saves an uploaded source to the library so it can be listed and reused later, both here and in the editor's media panels. Create the source via POST /v1/sources and upload the bytes first, then pass its sourceId. Without this a source is only reachable through the clips that already reference it. To bring in an image you saved in a connected Pinterest, Are.na or mymind account instead, pass from with the service and sourceId set to the item's id from GET /v1/library?scope=<service>; Tella copies the image into your private library (default), the workspace library, or with scope: "video" the library of the video named by videoId. Only images can be brought in: Pinterest image pins, Are.na image blocks, and mymind images or the screenshot mymind took of a saved page.

post/v1/library

Request

Request body

from'pinterest' | 'arena' | 'mymind' | 'vintage'

Bring an image in from your connected Pinterest, Are.na or mymind account, or a shot from Tella's vintage film catalog, instead of saving an uploaded source. Tella copies it, and the returned item's sourceId places it like any other image or video.

namestring

Display name shown in the library. Defaults to the item's type, or for a vintage shot, the film's title and year.

scope'private' | 'workspace' | 'video'

Where to save the item (default: private). workspace shares it with everyone in the workspace and requires an owner or member role; viewers get a 403. video, with from set to pinterest, arena or mymind only, saves it to the library of the video named by videoId.

sourceIdstring required

Source ID from POST /v1/sources, with the bytes already uploaded to its uploadUrl. With from, the id of an item from GET /v1/library?scope=<from> instead.

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

Expected item type. Optional — the type is taken from the source's own kind; supplying a value that disagrees is an error.

videoIdstring

With from and scope: "video": the video whose media library the image is saved to. Requires edit access to that video.

Example request

{
  "from": "pinterest",
  "name": "Intro camera take",
  "sourceId": "su_abc123def456",
  "videoId": "vid_abc123def456"
}

Response

Created

Example response

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

Changes

  • e6d5eb99c711Revision changes
    • warning

      added the new vintage enum value to the / response property for the response status

    • info

      added the new vintage enum value to the request property

  • 862d32ff02f5Revision changes
    • breaking

      request property was restricted to a list of enum values

    • breaking

      the request property type changed from no type to string

    • warning

      removed from the request property allOf list

    • warning

      added the new arena enum value to the / response property for the response status

    • warning

      added the new mymind enum value to the / response property for the response status

    • warning

      added the new pinterest enum value to the / response property for the response status

    • warning

      added the new video enum value to the / response property for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new private enum value to the request property

    • info

      added the new video enum value to the request property

    • info

      added the new workspace enum value to the request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status