---
title: "Delete Audio V2"
method: DELETE
path: "/v2/audios/{audio_id}"
tags: ["Audio Emotion API"]
---

# Delete Audio V2

`DELETE /v2/audios/{audio_id}`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v2/audios/{audio_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.imentiv.ai/oauth/authorize`
    - Token URL: `https://api.imentiv.ai/oauth/token` scopes: `media.delete`

Permanently delete an audio, its stored media and its analyses. This action is irreversible.

Only the audio's owner can delete it. Deletion completes asynchronously: the audio
disappears from listings immediately, and its data is permanently removed shortly
after. The response status is `deleting`, and repeating the request while it is in
progress returns the same response.

## Path parameters

- `audio_id` string, required: The unique ID of the audio to delete.

## Response `200`

Successful Response

- AudioDeleteResponse: Response model after deleting audio. Inherits: ResponseStatus: Generic success/error status model.
  - `id` string, required
  - `status` string, required

## Other responses

- `401`: Missing, malformed or rejected credentials — no `X-API-Key` / `Authorization: Bearer <jwt>`, an expired token, or a caller that lacks the role the route requires. Note that this API answers *authorization* failures with 401 as well as 403 (see the 403 entry where a route declares both).
- `404`: No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.
- `422`: Validation Error

## Changes

- **2026-10-01** `72330e2229c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/audios/:audio_id/delete.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)