Create a new instance

POST

This endpoint is used to create a new instance. You must provide a custom name for the instance, its gpu_type, and the name of its ssh_key.

If no values are provided for the gpu_count and operating_system_label, the default values of 1 and ubuntu_20_04_lts_nvidia are used respectively.

Request

This endpoint expects an object.

gpu_typeenumRequired

The GPU type of the instance.

ssh_keystringRequired

The SSH key name to add to the instance. This SSH key is used to connect to the instance.

namestringOptional

The custom name of the instance.

gpu_countintegerOptionalDefaults to 1

The number of GPUs to attach to the instance.

operating_system_label"ubuntu_20_04_lts_nvidia" or "ubuntu_22_04_lts_nvidia"Optional

Allowed values: ubuntu_20_04_lts_nvidiaubuntu_22_04_lts_nvidia

The operating system label used to create the instance.

regionenumOptional

Allowed values: NORWAYCANADASWEDENNETHERLANDS

The region in which to create the instance.

Response

This endpoint returns an object.

idstring

namestring

gpu_typeenum

operating_system_label"ubuntu_20_04_lts_nvidia" or "ubuntu_22_04_lts_nvidia"

Allowed values: ubuntu_20_04_lts_nvidiaubuntu_22_04_lts_nvidia

Built with

1	curl -X POST https://platform.fluidstack.io/instances \
2	-H "api-key: <api-key>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"gpu_type": "RTX_A5000_24GB",
6	"ssh_key": "my_ssh_key",
7	"name": "my_instance_name",
8	"operating_system_label": "ubuntu_20_04_lts_nvidia"
9	}'

1	{
2	"id": "i-1234567890",
3	"name": "my_instance_name",
4	"gpu_type": "RTX_A5000_24GB",
5	"operating_system_label": "ubuntu_20_04_lts_nvidia"
6	}