---
title: "ClusterClient.create"
description: "Create a cluster."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ClusterClient.create

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```python
def ClusterClient.create(
    name: str,
    description: str | None = None,
    slug: str | None = None,
) -> Cluster
```

Create a cluster.

## Parameters

**name**

type: string

A display name for the cluster.
**description**

type: str | None

Optional cluster description.
**slug**

type: str | None

Optional cluster slug. If omitted, Tilebox generates a slug from the cluster name.

## Returns

The created cluster object, including its slug, display name, description, whether it can be deleted, and deployed workflows.

<h2 id="request-example">Usage example</h2>

```python
cluster = cluster_client.create(
    "My cluster",
    description="Development workloads",
    slug="dev",
)
```

Source: https://tilebox.com/docs/api-reference/python/tilebox.workflows/ClusterClient.create/index.mdx