# Media

[View original](https://ittybit.com/api/media)

## Media Objects

```json title="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](/docs/media) for detailed coverage of all available props and values.

***

## Endpoints

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

<Card title="List Media" icon={<span className="w-16 flex items-center justify-center px-2 py-1 bg-brand-blue/10 text-xs/[1em] font-mono text-brand-blue rounded-md">GET</span>} href="/api/media/list" />

<Card title="Create Media" icon={<span className="w-16 flex items-center justify-center px-2 py-1 bg-brand-green/10 text-xs/[1em] font-mono text-brand-green rounded-md">POST</span>} href="/api/media/create" />

<Card title="Get Media" icon={<span className="w-16 flex items-center justify-center px-2 py-1 bg-brand-blue/10 text-xs/[1em] font-mono text-brand-blue rounded-md">GET</span>} href="/api/media/get" />

<Card title="Update Media" icon={<span className="w-16 flex items-center justify-center px-2 py-1 bg-brand-yellow/10 text-xs/[1em] font-mono text-brand-yellow rounded-md">PATCH</span>} href="/api/media/update" />

<Card title="Delete Media" icon={<span className="w-16 flex items-center justify-center px-2 py-1 bg-brand-magenta/10 text-xs/[1em] font-mono text-brand-magenta rounded-md">DELETE</span>} href="/api/media/delete" />