---
title: "Merge another user into this one — moves identities + email aliases, deletes source"
method: POST
path: "/api/users/{id}/merge"
tags: ["Users"]
---

# Merge another user into this one — moves identities + email aliases, deletes source

`POST /api/users/{id}/merge`

## Path parameters

- `id` string, required

## Request body

- object
  - `sourceUserId` string, required

## Response `200`

Merged user

## Other responses

- `400` — Validation error (e.g. target == source)
- `401` — Unauthorized
- `404` — Target or source user not found

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/4f62e32be8ec?raw)