Reference / Lifecycle

Merge one user into another (the survivor keeps everything; the source is tombstoned).

POST /v1/users/merge

Secret API key operationId: merge_users

Authorization

Server-to-server. Send a secret key as a Bearer token plus the x-application-id header.

Request body · required

source_user_id string<uuid> required uuid
target_user_id string<uuid> required uuid

Responses

200 Merged

404 Either user is missing

422 Cannot merge a user into itself

Request

curl -X POST "http://localhost:8080/v1/users/merge" \
  -H "Content-Type: application/json" \
  -d '{
  "source_user_id": "018f3c4a-7b2e-7c1d-9e0a-1f2b3c4d5e6f",
  "target_user_id": "018f3c4a-7b2e-7c1d-9e0a-1f2b3c4d5e6f"
}'

Try it

live request

POST http://localhost:8080/v1/users/merge

Request body

application/json