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

# Delete Speakers

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

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.

## 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.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/350e9cbcb623/schema)