v3

latestOpenAPI 3.1.02026-07-31112356215.0 KB
secureUploads

Upload media securely

Upload a media file and receive a short-lived token that can be passed to downstream endpoints (such as /detect and /intelligence) in place of a public URL. The returned token is a JWT that expires 1 hour after issuance.

Keeping uploads private avoids exposing source media on the open internet and means you do not need to host files yourself for jobs that only need the API to read them once.

post/secure_uploads

Headers

Authorizationstring required

Response

Upload accepted

successboolean
tokenstring

JWT referencing the uploaded file. Valid for 1 hour. Pass this value as media_token on downstream requests.