secureUploads

Upload media securely

Changed on

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

Request

  • Base URL: https://app.resemble.ai/api/v2
  • URL: https://app.resemble.ai/api/v2/secure_uploads
  • Auth: HTTP bearer

Response

Upload accepted

successboolean
tokenstring

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

Changes

  • 8a47567fb818Revision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security BearerAuth was added to the API

  • 176f674c8590Revision changes
    • info

      api operation id create-secure-upload removed and replaced with secureUploads_createSecureUpload