---
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`

## Request

- Base URL: `https://api.callr.com/v2.0`
- URL: `https://api.callr.com/v2.0/audio-files/{sid}/phone-id`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP basic

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.dev/callr/apis/callr-rest-api-v2-0.md) - [All operations](https://skmtc.dev/callr/apis/callr-rest-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/callr/apis/callr-rest-api-v2-0/revisions/311c79abf4d2?raw)