Integrations

Start Delta Sync

Import only what changed since a watermark.

OMIT since unless you have a reason: the app picks the last successful watermark, which is both what you usually want and safer than guessing. The response echoes back the watermark actually used, so read it rather than assuming yours was accepted.

Org admin, matching the app.

post/integrations/migrations/delta-sync

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/migrations/delta-sync
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

connection_idstring required
sincestring nullable

ISO 8601 timestamp. Omit and the app picks the last successful watermark - which is usually what you want, and always safer than guessing one.

entity_typesstring[] nullable

Limit to these entity types. Omit for all.

recover_missingboolean

Also re-fetch records the previous run should have imported and did not. Slower, and the reason to use it is a suspected gap rather than routine.

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.