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
The region in which to create the instance.
volumeslist of objectsOptional
The volumes attached to 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