Skip to navigation
PlatformAssets

API · Assets · Register a completed direct upload

View as Markdown

Register an asset after the client successfully PUTs its bytes to the signed storage URL returned by signAssetUpload. Carry every registration field from that response unchanged and use the original filename for asset_name. Returns the permanent asset UUID used by social media.

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.
idstringRequiredformat: "uuid"

The same resource_id used to sign the upload.

asset_typeintegerRequired

Asset type returned by signAssetUpload.

asset_keystringRequired

Storage key returned by signAssetUpload.

asset_namestringRequired<=255 characters
Display filename for the asset.
asset_urlstringRequiredformat: "uri"

Permanent asset URL returned by signAssetUpload.

thumbnailstringRequiredformat: "uri"

Asset/thumbnail URL returned by signAssetUpload.asset.

bucket_namestringRequired

Storage bucket returned by signAssetUpload.

payloadobjectOptional

Response

Asset registered
idstringformat: "uuid"
asset_urlstringOptionalformat: "uri"
thumbnailstringOptionalformat: "uri"

Errors

400
Bad Request Error
401
Unauthorized Error