Skip to navigation
FormantAI Voice APIPodcast

Create a PDF upload URL

View as Markdown

Issues a one-shot signed URL to PUT a source PDF straight to storage, plus the key to submit it with. The object key is minted server-side, so a URL can never be aimed at another object.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
filenamestringRequired<=200 characters

Source filename. Used only to build the object key; unsafe characters are replaced.

Response

Signed upload URL and object key
upload_urlstring
Signed URL to PUT the PDF to. Send the file as the raw body.
keystring

Object key to pass as source_key when submitting the episode.

expires_ininteger
Seconds the upload URL stays valid.
content_typestring

Content-Type the PUT must send.

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error