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

# Merge Placeholder

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

## Request

- Base URL: `https://api.sea-lion.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sea-lion.ai/scim/v2/placeholders/{user_id}/merge`
- Auth: API key in header `x-litellm-api-key`

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-10-21** `f2fb14eab3f5`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.dev/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sea-lion/apis/litellm-api/revisions/1ba9123c189a?raw)