> ## Documentation Index
> Fetch the complete documentation index at: https://tryunsora.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload media

> Upload your own files into your Unsora media library from the CLI so they're ready to use in posts, clips, and generations.

`unsora upload` stores your own media in your Unsora library and prints the
hosted URL. Use that URL anywhere the API accepts media — post media,
reference images, or clipping input. Every upload is recorded as an asset in
your library.

```bash theme={null}
# Import a public URL (server-side fetch, max 200MB)
unsora upload https://example.com/video.mp4

# Upload a local file
unsora upload ./photo.png

# Manage your uploads
unsora upload list
unsora upload delete <asset-id>
```

## How local uploads work

Local files use the [signed-URL flow](/docs/api-reference/uploads/signed-url)
automatically:

1. The CLI mints a short-lived direct-upload URL,
2. `PUT`s the file bytes straight to storage (they never pass through the API
   server — large videos upload fast), and
3. registers the file as a library asset.

URLs go through [POST /uploads](/docs/api-reference/uploads/create) instead — the
server fetches the file for you.

## Example: upload → post

```bash theme={null}
URL=$(unsora upload ./launch-video.mp4)
unsora post create -c "We're live! 🚀" -a <account-id> --video "$URL"
```