---
title: "Delete an audio file"
method: DELETE
path: "/audio/{id}"
---

# Delete an audio file

`DELETE /audio/{id}`

## Request

- Base URL: `https://embed-api.postnitro.ai`
- URL: `https://embed-api.postnitro.ai/audio/{id}`
- Auth: API key in header `embed-api-key`

Permanently deletes the audio record and its stored file. Refused with a 400 while a scheduled post's postSettings still references it — a reel resolves its audio at publish time, so deleting first would leave it silent. Videos already rendered to MP4 are unaffected: their audio is baked into the file. Docs: https://postnitro.ai/docs/embed/api/audio.md

## Path parameters

- `id` string, required

## Response `200`

Audio deleted

- object
  - `success` boolean
  - `message` string

## Other responses

- `400`: The audio is still used by a scheduled post
- `404`: No such audio in this workspace, or the id is not an audio file

---

[API](https://skmtc.dev/postnitro/apis/postnitro-embed-api.md) - [All operations](https://skmtc.dev/postnitro/apis/postnitro-embed-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postnitro/apis/postnitro-embed-api/revisions/428cb3ea3f6a?raw)