Files

# Transform Tasks
GET https://api.ittybit.com/files
POST https://api.ittybit.com/files
# Task Details
GET https://api.ittybit.com/files/:id
DELETE https://api.ittybit.com/files/:id

Introduction

Files in Ittybit are any singular file units that have a URL that can be shown in the browser.

For example, in a Media Item where the original Source is a video, the original Source, the generated variants of that Source, the Intelligence objects (.json), the .vtt Tracks, the generated image thumbnail (.jpeg) are all files. They all have their own unique URLs where they can be individually displayed.

Files vs Sources vs Media Container

Files vs Media vs Sources (Click to enlarge)

Above is a diagram that shows the relationship between Files, the Media Item and Sources in Ittybit. In this diagram, we use the example of a video file (Tutorial_4k.mp4) being the intial Source that is uploaded to Ittybit.

Under "Sources", you can see variants of the original Source that are generated using the Tasks endpoint. These range from lower resolution videos to an audio file and a thumbnail image. Sources can also be regarded as Variants, as they are all derived from the original Source file, Tutorial_4k.mp4.

Under "Intelligence Objects", you can see the .json and .vtt files that are generated from the original Source file.

All of these Files are stored in the Media Container which is the parent object that holds all the Files related to a single media item. The Media Container is generated as soon as the original file is uploaded / ingested into Ittbyit. More on that in the Media Container documentation.