Skip to main content
POST
/
agent
/
background-audio
Mint a presigned upload URL
curl --request POST \
  --url https://api.vocobase.com/api/v2/agent/background-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "slug": "<string>",
  "label": "<string>",
  "size_bytes": 2621440
}
'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "upload_url": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Must be audio/wav — only WAV is accepted in v1.

Available options:
audio/wav
​
size_bytes
integer
required

Size in bytes. Max 5 MB.

Required range: 1 <= x <= 5242880

Response

Upload URL minted.

​
success
boolean
​
data
object