Skip to main content
POST
Mint a presigned upload URL

Authorizations

Authorization
string
header
required

API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.

Body

application/json
slug
string
required

Stable identifier; unique across all assets.

Pattern: ^[a-z0-9][a-z0-9_-]{1,63}$
label
string
required

Display name for the asset.

Required string length: 1 - 80
mime_type
enum<string>
required

Container format of the file you are uploading. Several spellings of the same container are accepted — send the exact type your client reports (a browser's File.type on Windows is often audio/mp3 rather than audio/mpeg, and both are valid here), because the Content-Type on the PUT must match this value byte for byte or storage rejects the upload. Channels and sample rate are not constrained: Vocobase converts every upload into the mono, correct-rate asset the bot needs.

Available options:
audio/wav,
audio/x-wav,
audio/wave,
audio/vnd.wave,
audio/mpeg,
audio/mp3,
audio/mp4,
audio/m4a,
audio/x-m4a,
audio/aac,
audio/ogg,
audio/opus,
audio/flac,
audio/x-flac,
audio/webm,
audio/aiff,
audio/x-aiff
size_bytes
integer
required

Size in bytes. Max 5 MB.

Required range: 1 <= x <= 5242880

Response

Upload URL minted.

success
boolean
data
object