v1

latestOpenAPI 3.1.1Proprietary2026-07-245895107.9 KB
Audio Files

Update audio file on the phone

Update the content of an existing audio file by recording yourself over the phone. For a given audio file sid, this method will return a phone number and a code to enter as DTMF to record yourself.

Once you have confirmed the changes over the phone, the content will be processed asynchronously. The status property of the updated audio file will transition through the following stages:

  • pending-conversion
  • processing
  • Finally, it will be either ready or error

You can use webhooks to receive updates on the status.

put/audio-files/{sid}/phone-id

Path parameters

sidstring required

Short ID

Example:callrsid

Resource SID (8 lowercase alphanumeric characters)

Query parameters

countrystring required

ISO 3166-1 alpha-2 country code

Example:FR

The country code of the desired country for the recording phone number. If not available, we will provide the closest possible.

Response

Phone ID

codestring required

The DTMF code to record yourself

numberstring required

A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"

Example response

{
  "code": "123456",
  "number": "+33199001234"
}