---
title: "Preflight Import"
method: POST
path: "/clusters/preflight-import"
tags: ["clusters"]
---

# Preflight Import

`POST /clusters/preflight-import`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/clusters/preflight-import`
- Auth: none declared

Inspect a candidate cluster for collisions before importing it.

Returns a list of detected resource collisions (CRDs, IngressClasses,
pre-existing namespaces, etc.) so the caller can decide whether the
import is safe to proceed.

Read-only — no DB mutations, no cluster creation.

## Request body

- PreflightImportRequest: Input to POST /clusters/preflight-import. Either ``kubeconfig`` or (``cloud_credential_id`` + ``provider`` + ``provider_cluster_id``) must be supplied — same contract as the regular import endpoint.
  - `kubeconfig` string, nullable
  - `cloud_credential_id` string, uuid, nullable
  - `provider` string, nullable
  - `provider_cluster_id` string, nullable
  - `region` string, nullable

## Response `200`

Successful Response

- PreflightImportResponse: Result of POST /clusters/preflight-import.
  - `safe_to_import` boolean, required
  - `conflicts` PreflightConflict[], required
    - `resource_type` string, required
    - `name` string, required
    - `severity` string, required
    - `detail` string, required
  - `worker_node_count` integer, nullable
  - `detected_tier` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/70dc8775b002?raw)