CEcekura
test_framework

Replace an audio clip's recording

Changed on

Replace this clip's audio. Every action referencing it plays the new recording. Pass name to rename the clip at the same time — its <audio> tags are repointed for you, and the response carries previous_audio_id and the rewritten actions. The clip is transcoded and re-transcribed, so runs are blocked again until that finishes. Send the file as multipart/form-data, or as application/json with file_name and base64 content_base64.

put/test_framework/v2/scenarios/{id}/condition-audio/{audio_id}/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/test_framework/v2/scenarios/{id}/condition-audio/{audio_id}/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this scenario.

audio_idstring required

Request body

file_namestring required

Filename including its extension: wav, mp3, m4a, ogg, webm or flac.

content_base64string byte required

Base64-encoded audio, max 25 MB decoded. Accepts a raw base64 string or a data:<mime>;base64,... data URI.

namestring

Response

audio_idstring nullable
actionstring nullable
condition_idstring

First condition referencing this clip, or null when no action references it. Kept for compatibility - prefer condition_ids.

condition_idsinteger[]

Every condition referencing this clip, in authored order. Empty when the clip is uploaded but not referenced by any action yet.

stepsstring

Every step referencing this clip, as paths into the conditional actions (e.g. first_message, conditions[1].then[0]).

tagstring

The reference to paste into an action, e.g. <audio id="greeting"/>

statusstring nullable
transcriptstring nullable
durationnumber double nullable
filenamestring nullable
timing_sourcestring nullable

Where the word timings came from: deepgram (measured), interpolated (spread evenly), or manual (sent with a transcript edit).

errorstring nullable
updated_atstring nullable
playback_urlstring

S3 URL of the recorded audio clip

Changes