---
title: "Rent node"
method: POST
path: "/executors/{executor_uuid}/rent"
tags: ["Support API Key Authentication"]
---

# Rent node

`POST /executors/{executor_uuid}/rent`

Endpoint to rent a node with the provided details.

## Path parameters

- `executor_uuid` string, uuid, required

## Request body

- RentExecutorRequest — Request to rent a node. Attributes: termination_hours: Number of hours after which the pod should be automatically terminated. Must be between 1 and 720 hours (30 days). initial_port_count: Number of ports to initially allocate for this pod. Must be non-negative and not exceed node's available ports. dockerfile_content: DAH-2211. Optional user-supplied Dockerfile text. When set, the validator builds an image from this content on the executor host before running the container. XOR with `template_id` — exactly one must be set. Size is capped at `config.CUSTOM_DOCKERFILE_POD["max_dockerfile_bytes"]` (default 65_536 bytes).
  - `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

## Response `200`

Rent node

- 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)