---
title: "Delete Speakers"
method: DELETE
path: "/v1/audios/{audio_id}/speakers"
tags: ["Audio Emotion API"]
---

# Delete Speakers

`DELETE /v1/audios/{audio_id}/speakers`

## 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/v1/audios/{audio_id}/speakers`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Delete one or more speakers from an audio file while ensuring at least one
speaker remains. Drops affected segments from segment_emotions, recomputes
the audio's average emotions, nulls speaker references on transcript
sentences (text is preserved), and clears speaker references on linked
video faces. Cached CSV/PDF reports are invalidated.

## Path parameters

- `audio_id` string, required: The unique audio ID.

## Request body `application/x-www-form-urlencoded`

- BodyDeleteSpeakersV1AudiosAudioIdSpeakersDelete
  - `speaker_ids` string, required: Comma-separated list of speaker IDs to delete (e.g., '1,2,3').

## Response `200`

Successful Response

- DeleteSpeakersResponse: Response model after deleting one or more speakers from an audio. Attributes: id (str): Audio ID the speakers belonged to. message (str): Confirmation message reporting how many speakers remain.
  - `id` string, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

[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)