---
title: "Update audio file properties"
method: PATCH
path: "/audio-files/{sid}"
tags: ["Audio Files"]
---

# Update audio file properties

`PATCH /audio-files/{sid}`

Update the properties of an audio file. You can only update the name.

## Path parameters

- `sid` string, required — Short ID

## Request body

- AudioFileUpdate — Audio file update object
  - `name` string — Audio file name

## Response `200`

Audio file updated

- AudioFile — Audio file
  - `sid` string, required — Short ID
  - `name` string, required — Audio file name
  - `duration` integer, required — Duration in seconds
  - `source` 'phone-record' | 'system' | 'file-upload', required — Audio file source
  - `url` string, uri — A URL to media hosted by Callr. Unlike user-submitted endpoints, this value is generated by the API and its host varies by environment (it may not resolve to a public domain, e.g. in local development).
  - `readonly` boolean, required — System provided files cannot be modified
  - `status` 'ready' | 'processing' | 'pending-content' | 'pending-conversion' | 'error', required — Audio file status
  - `created` string, date-time, required — RFC 3339, section 5.6
  - `updated` string, date-time, required — RFC 3339, section 5.6

## 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/versions/76d36d004a8f/schema)