API · Assets · Get an asset by ID
Retrieve a workspace asset by UUID. Use this to resolve the final
stored URLs and to check processing status after an async create
(createAsset from a URL, or a signed upload) — the asset UUID is
returned immediately but the file download / S3 upload / thumbnail
generation completes in the background.
Key response fields:
status— processing state:0NOT_STARTED,1IN_PROGRESS,2PROCESSING_FAILED,3THUMBNAIL_FAILED,4DONE,10NOT_PROCESSED.file_url/thumbnail— signed Simplified CDN URLs to the stored file (expire ~12h; re-fetch to refresh).import_state(URL imports only) —"stored":file_urlis the stored CDN file, ready to use."failed": seeimport_error(http_<status>,timeout,unreachable,not_an_image,import_failed)."pending"/"importing": still importing;file_urlandthumbnailare empty until stored, so check again on a later step, and if it is still not stored after about a minute treat it as failed. Use only a storedfile_url.- There is no permanent public URL for a private asset: keep the
asset
idand callgetAssetagain whenever a fresh URL is needed. asset_type— image / video / audio / pdf / etc.payload— extracted media metadata (width, height, duration, format, …).
Authentication
AuthorizationApi-Key
Header authentication of the form Api-Key <token>
OR
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
id
Asset UUID (e.g. the id returned by createAsset).
Response
Asset detail
Errors
401
Unauthorized Error
404
Not Found Error
