Skip to main content

What it is

The Assets page (sidebar → Assets) is your workspace’s media library — a place to upload, search, and reuse images and videos across multiple posts without re-uploading every time. It’s also the picker that opens from the post editor when you click “Add media”.

Sources

The picker has three tabs: Search and trending feeds are powered by each provider’s official API — results are rendered server-side so your browser never sees raw API keys. When you pick a Giphy or Unsplash result, Kavio downloads the file and saves it as one of your workspace’s assets so it survives even if the original goes away.

Uploading

Click Upload to add files from your machine. Supported formats: Max file size: 10 MB for images, 1 GB for videos. Files larger than ~1 MB are sent in chunks via Content-Range for reliability on flaky connections.

Importing from URL

The post composer also accepts public URLs — Kavio downloads the file server-side, validates the MIME type and size against the enabled platforms on the post, and stores the result. From the API, this is POST /posts/{post}/media/from-url.

Searching

The Library tab supports a substring search on the original filename. Unsplash and Giphy use their respective search APIs — pass any keyword phrase. Trending feeds (no query) are also available on both.

Reusing assets

Pick an asset in the gallery and it’s attached to the active post. The same asset can be attached to many posts — Kavio references the underlying file rather than copying it. Deleting an asset that’s still in use is blocked from the UI to avoid breaking those posts.

Deleting

From the Library tab, click any asset → trash icon. Deletion removes the file from storage and detaches it from the workspace. Posts that referenced the asset will lose the attachment; published posts on social platforms are unaffected.

API access

There’s no public API for the asset library yet. The closest equivalents are post-scoped: POST /posts/{post}/media for direct file uploads and POST /posts/{post}/media/from-url for URL-based attachments. Both upload to workspace storage and append to the post’s media[] array in one shot.

Storage

Kavio stores uploaded and imported media in managed workspace storage. The Library tab keeps working independently from Unsplash or Giphy availability.