Skip to main content
POST
Create recommendation asset upload

Authorizations

Authorization
string
header
required

Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server.

Path Parameters

errorID
string
required

Error ID (format err-<number>).

Body

application/json
fileName
string
required

Original file name, for display.

contentType
string
required

MIME type of the upload. Allowed: image/png, image/jpeg, image/webp, image/gif (up to 20 MB) and video/mp4, video/webm, video/quicktime (up to 500 MB). The presigned URL is bound to it — the browser's PUT must send exactly this content type.

sizeBytes
integer<int64>
required

Exact file size in bytes; verified against the uploaded object on confirm.

Required range: x >= 1

Response

The pending asset plus the presigned upload URL.

asset
object
required

One user-uploaded media file (screenshot or video). The bytes live in a private object store; viewing goes through short-lived presigned URLs (see the downloadUrl endpoint), so this object carries metadata only.

uploadUrl
string
required

Presigned URL to PUT the file to, with the declared content type as the Content-Type header.

uploadExpiresAtMs
integer<int64>
required

When the upload URL stops working, in milliseconds since epoch.