Section Overview
Assets
Upload, optimize, manage, govern, and deliver assets through StackShift storage, CDN, media, and DAM APIs.
StackShift Assets overview
StackShift Assets is now a live media platform: storage, CDN delivery, image optimization, upload sessions, DAM, video, scanning, governance, AI metadata, and version history.
Goal
Understand the full Assets platform and which feature area to use for each workflow.
Expected result
You can treat Assets as the media layer for your product while StackShift owns storage placement, derived outputs, scanning, and delivery.
Assets SDK quick start
Install a StackShift SDK and upload files from Node/TypeScript, NestJS, Python, or Go.
Goal
Upload a public asset and get a CDN URL with the official SDK.
Expected result
Your app uploads a file to StackShift Assets and receives provider-neutral asset metadata.
Direct browser uploads
Create a short-lived signed upload URL on your server, then PUT the file directly from the browser.
Goal
Avoid routing large user files through your own application server.
Expected result
The browser uploads directly to StackShift Assets without receiving API credentials.
Private assets and signed URLs
Keep files private by default and generate short-lived URLs only when a user should download them.
Goal
Serve private files without making them publicly cacheable.
Expected result
Private assets are only downloadable with valid signed URLs and are returned with no-store cache headers.
Image optimization
Use named presets and signed dynamic transforms for strict, cached, responsive image delivery.
Goal
Generate optimized image URLs without exposing arbitrary transformation generation to the public internet.
Expected result
Repeated image requests reuse cached derived assets and the CDN receives stable, optimized URLs.
Upload UX and DAM
Use resumable upload sessions, progress-aware browser uploads, tags, folders, search, bulk actions, and usage summaries.
Goal
Build a production upload and asset management workflow around the StackShift Assets API.
Expected result
Users can upload large files reliably and manage the resulting library without leaving the dashboard.
Video, scanning, and governance
Process video asynchronously, deliver HLS and posters, scan uploads, quarantine infected assets, and enforce account policies.
Goal
Use video outputs and security controls while keeping original asset URLs backward compatible.
Expected result
Video assets show processing state, playback URLs, scan status, policy status, and audit history.
AI DAM and versioning
Use OpenAI-backed asset intelligence, moderation, transcripts, smart crops, background removal, collections, saved searches, and branching versions.
Goal
Add richer discovery, governance, and version control to assets without changing stable current asset URLs.
Expected result
The asset library supports AI metadata, moderation safety, transcripts, advanced derivatives, reusable organization, and pinned version delivery.