---
title: "Update audio file on the phone"
method: PUT
path: "/audio-files/{sid}/phone-id"
tags: ["Audio Files"]
---

# Update audio file on the phone

`PUT /audio-files/{sid}/phone-id`

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.

## Path parameters

- `sid` string, required — Short ID

## Query parameters

- `country` string, required — ISO 3166-1 alpha-2 country code

## Response `201`

Phone ID

- AudioFilePhoneID
  - `code` string, required — The DTMF code to record yourself
  - `number` string, required — A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource Not Found
- `405` — Method Not Allowed
- `429` — Too Many Requests (rate limit exceeded)
- `500` — Internal Server Error

---

[API](https://skmtc.net/callr/apis/callr-rest-api-v2-0.md) · [All operations](https://skmtc.net/callr/apis/callr-rest-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callr/callr-rest-api-v2-0/revisions/76d36d004a8f/schema)