Skip to navigation
PlatformAssets

API · Assets · Sign a direct asset upload

View as Markdown

Start the same direct-to-storage upload flow used by Simplified’s UI. The client creates a UUID, calls this tool, then PUTs the local file bytes directly to the returned signed URL using the declared MIME type and no Simplified Authorization header. After the PUT succeeds, call registerAsset with the returned metadata.

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.

Request

This endpoint expects an object.
filenamestringRequired<=255 characters
Original filename including extension.
filetypestringRequired<=255 characters

MIME type, for example image/png or video/mp4.

resourceenumRequiredDefaults to assets

Storage resource namespace. Use assets.

Allowed values:
resource_idstringRequiredformat: "uuid"

Client-generated UUID that becomes the registered asset ID.

Response

Signed upload URL and asset registration metadata
resource_idstringformat: "uuid"
assetstringformat: "uri"
asset_urlstringformat: "uri"
signedstringformat: "uri"
asset_keystring
asset_typeinteger
bucket_namestring

Errors

400
Bad Request Error
401
Unauthorized Error