API ReferenceTools

Create Upload URL

Generate signed upload (expires in 2 hours) and download URLs for a file (expires in 1 hour).

See the Upload page for native Python and Typescript SDKs.

Headers

PINNACLE-API-KeystringRequired

Request

This endpoint expects an object.
contentTypestringRequired

The MIME type of the file.

Supported types are audio/basic, audio/L24, audio/mp4, audio/mpeg, audio/mpg, audio/mp3, audio/ogg, audio/aac, audio/vndrn-realaudio, audio/vndwave, audio/3gpp, audio/3gpp2, audio/ac3, audio/webm, audio/amrnb, audio/amr, video/mpeg, video/mp4, video/quicktime, video/webm, video/3gpp, video/3gpp2, video/3gpptt, video/H261, video/H263, video/H2631998, video/H2632000, video/H264, video/m4v, video/mpeg4, video/webm, image/jpeg, image/gif, image/png, image/gif, image/bmp, image/tiff, image/webp, text/vcard, text/xvcard, text/csv, text/rtf, text/richtext, text/calendar, text/directory, application/ogg, application/pdf, application/vcard, application/vndapple.pkpass.

sizeintegerRequired
The size of the file in bytes. Should be less than 100 MB.
namestringRequired
The name of the file.

Response

Successfully generated upload and download URLs
uploadstring or null
The URL to upload the file.
downloadstring or null
The URL to download the file.

Errors