---
title: "Rent a cluster"
method: POST
path: "/executors/cluster/rent"
tags: ["Support API Key Authentication"]
---

# Rent a cluster

`POST /executors/cluster/rent`

Rent several nodes of one InfiniBand fabric as a single all-or-nothing order. Every node is given a WireGuard overlay address so NCCL's bootstrap can find its peers; the tensors travel over InfiniBand. Whole nodes only, and only the cluster image.

## Request body

- RentClusterRequest — Rent several nodes of one InfiniBand fabric as a single all-or-nothing order (DAH-2620). Everything a single rental takes, plus the nodes. The same payload is applied to every node, so a cluster is homogeneous by construction — which is what a distributed job needs anyway.
  - `pod_name` string, required
  - `template_id` string, uuid, nullable
  - `gpu_count` integer, nullable
  - `volume_id` string, nullable
  - `user_public_key` union, required
    - string
    - string[]
  - `backup_log_id` string, uuid, nullable
  - `restore_path` string, nullable
  - `skip_add_agent_ssh_key` boolean, nullable
  - `termination_hours` integer, nullable
  - `initial_port_count` integer, nullable
  - `enable_jupyter` boolean, nullable
  - `enable_volume_encryption` boolean, nullable
  - `dockerfile_content` string, nullable
  - `ncu_profiling` boolean
  - `executor_uuids` string[], required

## Response `200`

Rent a cluster of nodes on one InfiniBand fabric

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)