---
title: "Merge speakers"
method: POST
path: "/speakers/merge"
tags: ["Speakers"]
---

# Merge speakers

`POST /speakers/merge`

Merge two speaker identities into one.

## Request body

- MergeSpeakersRequest
  - `speaker_to_keep_id` integer, required
  - `speaker_to_merge_id` integer, required

## Response `200`

OK

- object

## Changes

> 10 revisions in range; 3 could not be searched.

- **2026-04-09** `0f0f8030c7e2` — 1 info
  - api tag `Speakers` added
- **2026-04-08** `1a63468a8d30` — 1 warning, 2 info
  - removed the optional property `success` from the response with the `200` status
  - api operation id `server_merge_speakers_handler` removed and replaced with `routes_speakers_merge_speakers_handler`
  - api tag `Speaker Management` removed
- **2026-02-16** `e143bf8d73bc` — 2 breaking, 2 warning, 1 info
  - added the new required request property `speaker_to_keep_id`
  - added the new required request property `speaker_to_merge_id`
  - removed the request property `source_id`
  - removed the request property `target_id`
  - …1 more
- **2026-02-11** `2825740bcf63` — 2 breaking, 2 warning, 2 info
  - added the new required request property `source_id`
  - added the new required request property `target_id`
  - removed the request property `speaker_to_keep_id`
  - removed the request property `speaker_to_merge_id`
  - …2 more

[Change history](https://skmtc.dev/screenpipe/apis/screenpipe-api/changes/speakers/merge/post.md)

---

[API](https://skmtc.dev/screenpipe/apis/screenpipe-api.md) · [All operations](https://skmtc.dev/screenpipe/apis/screenpipe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/screenpipe/screenpipe-api/revisions/c48ab58de88e/schema)