---
title: "GET /api/ee/remote-sync/export-preflight"
method: GET
path: "/api/ee/remote-sync/export-preflight"
tags: ["/api/ee/remote-sync"]
---

# GET /api/ee/remote-sync/export-preflight

`GET /api/ee/remote-sync/export-preflight`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/ee/remote-sync/export-preflight`
- Auth: API key in header `X-API-Key`

Dry-run preview of what pushing the current state would do given the live remote branch, without
  writing anything. Drives the UI's push decision (force / new branch / merge).

  Returns:
  - has_changes: whether the remote branch has advanced beyond the last synced version
  - clean: whether a 3-way merge would apply with no conflicts
  - conflicts: human-readable labels of the entities that conflict (empty when clean)
  - summary: counts of remote changes a merge would fold in
  - force_push_casualties: remote content a force push (rather than a merge) would discard, as
    `{:deleted [labels] :overwritten [labels]}`
  - reason: "history-rewritten" when the remote was force-pushed/rebased so no merge base exists

  Requires superuser permissions.

## Query parameters

- `branch` string, required

## Response `2XX`

Successful response

- object
  - `clean` boolean, required
  - `conflicts` string[], required
  - `force_push_casualties` object, required
    - `deleted` string[], required
    - `overwritten` string[], required
  - `has_changes` boolean, required
  - `reason` string, nullable, required
  - `summary` object, required
    - `added` integer, required
    - `removed` integer, required
    - `updated` integer, required

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/ee/remote-sync/export-preflight/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)