Skip to main content
POST
Mint a single-use upload token for a file

Authorizations

Authorization
string
header
required

Your Vook API key (mint one from the web app).

Response

201 - application/json

Where to upload the file, a short-lived token, and its expiry

upload_url
string
required

Absolute URL to POST the file to, as multipart/form-data with a single chunk field. Send the token as Authorization: Bearer <upload_token>. This is a different host from the API. Always use the value returned here rather than hardcoding it.

Example:

"https://ingress.vook.ai/upload"

upload_token
string
required

Short-lived token scoped to this upload session. Send as Authorization: Bearer <upload_token> to upload_url with the file, then pass it again when you create the transcription job.

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

expires_at
string<date-time>
required

When the upload token expires. Start the upload before this instant; an upload already in flight is not interrupted.

Example:

"2024-01-15T10:30:00.000Z"