Version: 1.0.0
Asset API - Introduction
Upload, download, delete, replace, and manage asset files and their metadata. Includes content operations, data/metadata management, conversions, and content links.
Key concepts:
- Deleting an
originalis a soft-delete (asset is hidden, can be restored) - Purging permanently removes the asset and all conversions
- Public access can be set per-file or per-conversion
All asset data follows a standard JSON structure containing id, status, name, size, content_type, metadata, data, conversions, and addons_info fields. See Asset Data Format for details.
note
Asset status must be OK before accessing or updating. Check status after upload, especially for large files.
Authentication
- API Key: ApiKeyAuth
- HTTP: Bearer Auth
API key for programmatic access
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | X-FileSpin-Api-Key |
JWT token obtained from POST /api/v1/login
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |