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

# Merge Speakers

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

Merge multiple speakers into a single selected speaker on an audio document.

The merged speakers' segments are relabeled to selected_speaker_id and the
merged-away speaker entries are removed from the audio. If the audio is
linked to a video, faces matched to a merged-away speaker are unlinked
(speaker_id cleared) and any face matched to the surviving speaker has its
personality_traits reset to pending — speaker merge is intentionally NOT
a face-merge cascade. See module.audios.controller.merge_speakers_in_audio
for full semantics, including the symmetric face-merge fix tracked in #439.

## Path parameters

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

## Response `200`

Successful Response

- MergeSpeakersResponse — Response model after merging speakers within an audio. Attributes: message (str): Status message about the merge result.
  - `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)