Files

View Markdown

Overview

File objects contain information about your individual media files, including the unique ID, the URL, the type, width, height, and other file properties, plus any metadata you have added.


File Objects

file.json
{
  "id": "file_abcdefgh1234",
  "object": "source",
  "kind": "video",
  "type": "video/mp4",
  "width": 1920,
  "height": 1080,
  "duration": 123.45,
  "filesize": 12345678,
  "url": "https://you.ittybit.net/file_abcdefgh1234",
  "metadata": {
    "customKey": "your custom value",
  },
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:45Z",
  "status": "ready"
}

See Files for detailed coverage of all available props and values.


Endpoints

You can use the /files and /files/{id} endpoints to manage your files.

GET

List Files

POST

Create File

GET

Get File

PATCH

Update File

DELETE

Delete File

On this page