Uploads

Get a signed upload URL that needs no key

Returns a short-lived, signed URL that anybody holding the bytes can POST to without a credential of their own. This is how an agent running on a machine the API cannot reach sends a local file up: the ticket carries the authorization, so no key ever leaves your server.

direct_url is the address to ask for a link that writes into object storage instead. The ticket cannot carry one itself, because it is reusable for a whole folder and a storage link names one object.

post/v1/uploads/tickets

Request

  • Base URL: https://api.tryplayhead.com
  • URL: https://api.tryplayhead.com/v1/uploads/tickets
  • Auth: HTTP bearer

Response

The ticket and where to send the bytes.

ticketstring
upload_urlstring uri
direct_urlstring uri

Ask here for a link that writes into object storage. Absent on a server from before direct uploads existed.

expires_atstring date-time
max_bytesinteger

Changes

No recorded changes to this operation across all 1 revision of this API.