Integrations

Confirm Migration

Accept the discovery and START IMPORTING. Records begin landing.

A migration cannot be un-run - only cancelled part-way, leaving whatever already arrived. Read the status first: its warnings are the things discovery could not resolve on its own.

An empty body accepts the discovery as proposed, which is the point of previewing it. Org admin, matching the app.

post/integrations/migrations/{migration_id}/confirm

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/migrations/{migration_id}/confirm
  • Auth: HTTP bearer

Path parameters

migration_idstring required

Migration id from discovery.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

field_mappings_overrideobject nullable

Per entity type, the mappings to use instead of the discovered ones. Omit to accept what discovery proposed.

selected_list_idsstring[] nullable

Import only these CRM lists. Omit to take every discovered list.

Response

Successful Response

dataConnectionPayload required

An open envelope for a connection, a token or a migration report.

Open because the migration STATUS payload carries a per-entity progress map, a discovered-field map and a pipeline list that all grow with the providers - and because a dropped warning on a migration report reads as "nothing went wrong".

Changes

No recorded changes to this operation across all 2 revisions of this API.