Docs/REST API/api_vendor_upload_audio
POST/api/v1/vendor/assets/{id}/audio-previewAuthorization: Bearer <token>

Upload Audio Preview

Upload inline streaming audio preview clip for music tracks and sound effects.

Description

Powers the instant audio waveform player on product cards and detail pages without exposing the full master audio file.

Parameters

2 parameters
ParameterTypeRequiredDefaultDescription
idstringRequiredTarget asset GUID.
filebinary (multipart/form-data)RequiredMP3, AAC, or WAV audio clip (up to 20 MB).

Request Example

curl -X POST https://api.trykrafto.xyz/api/v1/vendor/assets/6f94726b-67a3-41bb-a5a4-927429beecfa/audio-preview \
  -H "Authorization: Bearer kr_live_token..." \
  -F "file=@/path/to/preview.mp3"

Response Example

application/json (200 OK)
{
  "id": "prv_aud_72",
  "assetId": "6f94726b-67a3-41bb-a5a4-927429beecfa",
  "kind": "AudioPreview",
  "url": "/api/v1/previews/prv_aud_72"
}