Media

View Markdown

Overview

Media objects contain information about your media assets and related files, plus any metadata you have added.


Media Objects

media.json
{
  "id": "med_abcdefgh1234",
  "object": "media",
  "kind": "video",
  "title": "A Video Example",
  "files": [
    {
      "id": "file_abcdefgh1234",
      "object": "source",
      "kind": "video",
      "type": "video/mp4",
      "width": 1920,
      "height": 1080,
      "duration": 123.45,
      "filesize": 12345678,
      "url": "https://you.ittybit.net/example/video.mp4",
      "ref": "original"
    },
    {
      "id": "file_abcdefgh5678",
      "object": "source",
      "kind": "image",
      "type": "image/png",
      "width": 640,
      "height": 360,
      "filesize": 123456,
      "url": "https://you.ittybit.net/example/image.png",
      "ref": "thumbnail"
    },
    {
      "id": "file_abcdefgh9012",
      "object": "track",
      "kind": "subtitles",
      "type": "text/vtt",
      "filesize": 1234,
      "url": "https://you.ittybit.net/example/subtitles.vtt",
      "ref": "subtitles"
    }
  ],
  "urls": {
    "original": "https://you.ittybit.net/file_abcdefgh1234",
    "thumbnail": "https://you.ittybit.net/file_abcdefgh5678",
    "subtitles": "https://you.ittybit.net/file_abcdefgh9012",
    "placeholder": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAMAAAADCAYAAABWKLW/AAAACXBIWXMAAAAAAAAAAQCEeRdzAAAAMElEQVR4nGOQ4dR9qC/l+F+YQ/shg6Wq1//1Czb+D/fL/s+gpWj/sKKw47+3c8wjABmiEEDGwErfAAAAAElFTkSuQmCC"
  },
  "background": "#2OBO75",
  "metadata": {
    "customKey": "your custom value"
  },
  "created": "2025-01-01T01:23:45Z",
  "updated": "2025-01-01T01:23:46Z"
}

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


Endpoints

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

GET

List Media

POST

Create Media

GET

Get Media

PATCH

Update Media

DELETE

Delete Media

On this page