Accounts

Merges the accounts in source_account_ids into the account in the path. This is irreversible, like deleting an account: each source account is deleted, its contacts, opportunities, tasks, tags and domains move to the target, and its live sequences are stopped. Call preview_account_merge first.

When live sequences would be stopped the request is rejected with 409 sequence_stop_confirmation_required unless confirm_sequence_stop is true. If a merge fails part-way, 409 merge_failed says which steps already committed; retrying the same request resumes it. Retrying a merge that already completed succeeds with zero new changes and a positive source_accounts_already_merged count. source_account_ids in the response echo the ids as resolved at request time, so a retry that names an already-deleted source by its AccountICP id echoes that id rather than the account id.

post/v1/accounts/{account_id}/merge

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/accounts/{account_id}/merge
  • Auth
    none declared

Path parameters

account_idstring uuid required

Request body

source_account_idsstring[] required

IDs of the accounts to merge into the account in the path. Each is deleted when the merge is applied. At most 100 per request.

confirm_sequence_stopboolean

Set to true only after the user approved stopping the live sequences the preview lists under blocking_sequences. Without it, a merge that would stop live sequences is rejected with sequence_stop_confirmation_required.

Response

Successful Response

Changes