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

# Import Cluster

`POST /clusters/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/import`
- Auth: none declared

Import an existing Kubernetes cluster into Mengi Cloud.

Runs preflight first and refuses the import if any error-severity
conflicts are detected. Setting ``override_preflight=true`` lets an
admin force the import; every override is logged with the user id.

## Request body

- ClusterImport: Schema for importing an existing Kubernetes cluster.
  - `name` string, required
  - `provider` string, required
  - `region` string, required
  - `cloud_credential_id` string, uuid, nullable
  - `provider_cluster_id` string, nullable
  - `kubeconfig` string, nullable
  - `is_autopilot` boolean
  - `organization_id` string, uuid, nullable
  - `acknowledge_bundle_install` boolean, required
  - `override_preflight` boolean

## Response `201`

Successful Response

- ClusterResponse
  - `id` string, uuid, required
  - `name` string, required
  - `provider` string, required
  - `region` string, required
  - `tier` 'shared' | 'dedicated' | 'production', required
  - `status` 'pending' | 'provisioning' | 'importing' | 'running' | 'upgrading' | 'error' | 'deleting', required
  - `organization_id` string, uuid, nullable
  - `kubernetes_version` string, nullable
  - `server_type` string, nullable
  - `argocd_url` string, nullable
  - `git_repo_url` string, nullable
  - `error_message` string, nullable
  - `status_message` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `provisioning_started_at` string, date-time, nullable
  - `provisioning_completed_at` string, date-time, nullable
  - `autoscaling_enabled` boolean
  - `min_nodes` integer, nullable
  - `max_nodes` integer, nullable
  - `target_kubernetes_version` string, nullable
  - `upgrade_available` boolean
  - `upgrade_available_version` string, nullable
  - `scheduled_upgrade_date` string, date-time, nullable
  - `scheduled_upgrade_id` string, uuid, nullable
  - `component_bundle_version` string
  - `multi_region` boolean
  - `region_locations` string[], nullable
  - `is_byoc` boolean
  - `cloud_credential_id` string, uuid, nullable
  - `is_imported` boolean
  - `is_management` boolean
  - `is_autopilot` boolean
  - `display_order` integer, 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)