---
title: "Create a new Cluster"
method: POST
path: "/cluster"
tags: ["Cluster"]
---

# Create a new Cluster

`POST /cluster`

## Headers

- `Authorization` string, required

## Request body

- ModulesClusterArgs
  - `Keep_upgrade_job` boolean
  - `chart_name` string
  - `chart_version` string
  - `cover` boolean
  - `data` integer[]
  - `name` string
  - `namespace` string

## Response `200`

Success

- object
  - `msg` string
  - `data` ModulesJob
    - `cluster_id` string
    - `createdAt` string
    - `creator` string
    - `deletedAt` GormDeletedAt
      - `time` string
      - `valid` boolean — Valid is true if Time is not NULL
    - `end_time` string
    - `id` integer
    - `meta_data` ModulesClusterArgs
      - `Keep_upgrade_job` boolean
      - `chart_name` string
      - `chart_version` string
      - `cover` boolean
      - `data` integer[]
      - `name` string
      - `namespace` string
    - `method` string
    - `start_time` string
    - `states` string[]
    - `status` integer
    - `sub_jobs` ModulesSubJobs
    - `time_limit` string
    - `updatedAt` string
    - `uuid` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized operation
- `500` — Internal server error

---

[API](https://skmtc.net/federatedai/apis/kubefate-service-api.md) · [All operations](https://skmtc.net/federatedai/apis/kubefate-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/federatedai/kubefate-service-api/versions/01a50f79e50f/schema)