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

# Merge Speakers

`PUT /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

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.

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

- BodyMergeSpeakersV1AudiosAudioIdSpeakersPut
  - `selected_speaker_id` integer, required: The unique speaker ID to merge other speakers into.
  - `merge_speaker_id` string, required: A comma-separated list of speaker IDs to merge into selected_speaker_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.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)