Assets
Upload, list, and manage images, videos, fonts, and other binary assets. Assets are stored on Cloudflare R2 CDN and auto-analyzed by Claude Vision for descriptions.
POST
/api/v1/sites/:id/assetsUpload an asset. Two modes: base64 (pass content_base64 + content_type) or URL (pass url to download from external source).
Auth:
Bearer tokenURL Parameters
| id | Site ID |
Request Body
| Field | Type | Description |
|---|---|---|
| filename | string | Filename (e.g., "hero-bg.jpg") |
| content_base64 | string (optional) | Base64-encoded content (mode 1) |
| content_type | string (optional) | MIME type for base64 mode |
| url | string (optional) | External URL to download (mode 2) |
Response
200 OK
{ "data": { "filename": "hero-bg.jpg", "url": "https://slug.vibesites.link/assets/hero-bg.jpg", "description": "..." } }GET
/api/v1/sites/:id/assetsList all assets with CDN URLs, auto-generated descriptions, and tags.
Auth:
Bearer tokenURL Parameters
| id | Site ID |
Response
200 OK
{ "data": [{ "filename": "hero-bg.jpg", "url": "...", "description": "...", "tags": ["hero", "photo"] }] }