Import a managed cluster

Bearer PAT authentication; RBAC permission clusters.create. For Kapsule, provider_cluster_id is the opaque region-qualified regions/{region}/clusters/{id} reference. CNI is immutable. Imported/unknown provenance is disconnect-only; provider deletion is allowed by default only for created clusters.

POST /api/v1/clusters/managed/{provider}/import

Import a managed cluster

Python

import requests

url = "https://platform.ankra.app/api/v1/clusters/managed/{provider}/import"

payload = {
    "credential_id": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
    "provider_cluster_id": "regions/fr-par/clusters/11111111-2222-4333-8444-555555555555"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "provider_cluster_id": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-ankra-organisation-id · string

PAT organisation override.

Path Parameters

provider · enum<string> · required

Available options: doks, uks, gke, ovh_mks, aks, eks, kapsule

Example:

"kapsule"

Body

application/json

credential_id · string<uuid> · required

provider_cluster_id · string · required

criticality · enum<string> | null

Available options: production, staging, development, disposable

description · string | null

environment · string | null

Required string length: 1 - 50

name · string | null

Response

200

application/json

Successful response

cluster_id · string<uuid> · required

name · string · required

provenance · enum<string> · required

Available options: created, imported, unknown

provider_cluster_id · string · required