Convert Swagger & OpenAPI Specs to Clean Markdown

# Acme Cloud Compute & Container API `v2.4.0`

High-performance cloud orchestration service for serverless compute and container deployments.

**Base URL:** `https://api.acmecloud.io/v2`

---

## 📑 API Endpoints Index

| Method | Endpoint | Summary |
| :--- | :--- | :--- |
| `GET` | [/v2/clusters](#get-v2clusters) | List all active compute clusters |
| `GET` | [/v2/clusters/{clusterId}](#get-v2clustersclusterId) | Retrieve cluster details by ID |
| `DELETE` | [/v2/clusters/{clusterId}](#delete-v2clustersclusterId) | Terminate and de-provision a cluster |
| `POST` | [/v2/deployments](#post-v2deployments) | Deploy new container workload |

---

## 🏷️ Clusters

### `GET` /v2/clusters <a id="get-v2clusters"></a>

**List all active compute clusters**

#### 📥 Parameters

| Name | In | Type | Required | Description |
| :--- | :---: | :---: | :---: | :--- |
| `region` | `query` | `enum ("us-east-1" | "us-west-2" | "eu-central-1")` | No | Filter clusters by cloud availability zone |
| `limit` | `query` | `integer` | No | Maximum number of clusters to return (1-100) |

#### 📤 Responses

| Status Code | Description | Content Type |
| :---: | :--- | :--- |
| `200` | Array of active cluster summaries | `application/json` |

**Response Example:**
```json
{
  "total": 3,
  "clusters": [
    {
      "id": "cls_99182a",
      "name": "us-east-prod-pool",
      "nodes": 32,
      "status": "RUNNING"
    }
  ]
}
```

#### 💻 Example cURL
```bash
curl -X GET "https://api.acmecloud.io/v2/clusters?region=sample&limit=sample" \
  -H "Accept: application/json"
```

---

### `GET` /v2/clusters/{clusterId} <a id="get-v2clustersclusterId"></a>

**Retrieve cluster details by ID**

#### 📥 Parameters

| Name | In | Type | Required | Description |
| :--- | :---: | :---: | :---: | :--- |
| `clusterId` | `path` | `string` | **Yes** | Unique cluster UUID |

#### 📤 Responses

| Status Code | Description | Content Type |
| :---: | :--- | :--- |
| `200` | Detailed cluster configuration | `application/json` |
| `404` | Cluster not found | `-` |

**Response Example:**
```json
{
  "id": "cls_99182a",
  "name": "us-east-prod-pool",
  "kubernetesVersion": "1.30.2",
  "cpuUtilization": 74.2
}
```

#### 💻 Example cURL
```bash
curl -X GET "https://api.acmecloud.io/v2/clusters/123" \
  -H "Accept: application/json"
```

---

### `DELETE` /v2/clusters/{clusterId} <a id="delete-v2clustersclusterId"></a>

**Terminate and de-provision a cluster**

#### 📥 Parameters

| Name | In | Type | Required | Description |
| :--- | :---: | :---: | :---: | :--- |
| `clusterId` | `path` | `string` | **Yes** | Unique cluster UUID |

#### 📤 Responses

| Status Code | Description | Content Type |
| :---: | :--- | :--- |
| `204` | Cluster scheduled for graceful termination | `-` |

#### 💻 Example cURL
```bash
curl -X DELETE "https://api.acmecloud.io/v2/clusters/123" \
  -H "Accept: application/json"
```

---

## 🏷️ Workloads

### `POST` /v2/deployments <a id="post-v2deployments"></a>

**Deploy new container workload**

#### 📦 Request Body

**Content-Type:** `application/json`

```json
{
  "image": "acme/api-worker:v2.4.0",
  "replicas": 5,
  "cpuLimitCores": 2,
  "memoryLimitMB": 4096
}
```

#### 📤 Responses

| Status Code | Description | Content Type |
| :---: | :--- | :--- |
| `201` | Container workload successfully deployed | `application/json` |

**Response Example:**
```json
{
  "deploymentId": "dep_01928374",
  "status": "DEPLOYING"
}
```

#### 💻 Example cURL
```bash
curl -X POST "https://api.acmecloud.io/v2/deployments" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "acme/api-worker:v2.4.0",
  "replicas": 5,
  "cpuLimitCores": 2,
  "memoryLimitMB": 4096
}'
```

---