---
title: "Merge Placeholder"
method: POST
path: "/scim/v2/placeholders/{user_id}/merge"
tags: ["scim"]
---

# Merge Placeholder

`POST /scim/v2/placeholders/{user_id}/merge`

Fold a placeholder user into the one account its id names by SSO identity or email.

The account is added to every team the placeholder is on, then the placeholder is
deleted the way ``DELETE /scim/v2/Users/{id}`` deletes a user, so the next group
push resolves the member value to the real account. Refused with 409 when the row
has an SSO identity of its own, owns virtual keys, or names no account or several.

## Path parameters

- `user_id` string, required

## Query parameters

- `feature` string, nullable

## Response `200`

Successful Response

- SCIMPlaceholderMergeResult
  - `merged_into_user_id` string, required
  - `placeholder_user_id` string, required
  - `team_ids` string[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `scim` added
  - api tag `✨ SCIM v2 (Enterprise Only)` removed
- **2026-09-18** `082b5fabd909` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/scim/v2/placeholders/:user_id/merge/post.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/7ed45f30a5f0?raw)