# Files

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

## File Objects

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

***

## Endpoints

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

<Card title="List Files" 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/files/list" />

<Card title="Create File" 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/files/create" />

<Card title="Get File" 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/files/get" />

<Card title="Update File" 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/files/update" />

<Card title="Delete File" 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/files/delete" />