---
title: "Reorder Clusters"
method: POST
path: "/api/v1/clusters/reorder"
tags: ["clusters"]
---

# Reorder Clusters

`POST /api/v1/clusters/reorder`

## 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/api/v1/clusters/reorder`
- Auth: none declared

Reorder clusters on the dashboard.

Updates the display_order for all clusters based on their position
in the provided cluster_ids list.

## Request body

- ClusterReorderRequest: Request to reorder clusters on the dashboard. Contains an ordered list of cluster IDs in the desired display order.
  - `cluster_ids` string[], required

## Response `200`

Successful Response

- ClusterListResponse
  - `clusters` ClusterResponse[], required
    - `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
  - `total` integer, required

## 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/4ae9b375cdbb?raw)