groups
Merge groups (v2)
Merge one or more source groups into the group identified by groupId. The destination keeps its ID, receives the final name, emoji, and de-duplicated union of contact memberships, while selected source groups are deleted. Direct subgroups are reparented under the destination and source-linked saved views are retargeted. Requires Idempotency-Key.
post/v2/groups/{groupId}/merge
Path parameters
groupIdstring uuid required
Headers
Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.
Request body
Response
Successful response