Create a machine

Provision a new development machine

POST

/auth/v1/seed/{namespace}/dev

curl --request POST \
  --url /auth/v1/seed/{namespace}/dev \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"dev-training","cloud":"aws","region":"us-east-1","instance_type":"g5.2xlarge","gpus":"A10G:1","disk_size_gb":200,"spot":false,"ports":[8080,8888],"tools":["python","docker"],"packages":["ffmpeg"],"setup":"pip install torch transformers","envs":{"HF_TOKEN":"hf_xyz789","WANDB_API_KEY":"wk_abc123"},"autostop":60,"labels":{"team":"ml-research","project":"llm-training"}}'

Path parameters

namespace

string

required

The namespace (user or organization) to create the machine in.

Body parameters

name

string

required

A unique name for the machine. Must be 1-64 characters. Allowed characters: alphanumeric, hyphens, underscores.

cloud

string

required

Cloud provider. One of aws, azure, or gcp.

region

string

required

Cloud region to deploy in (e.g., us-east-1, westus2, us-central1).

zone

string

Availability zone within the region (e.g., `us-east-1a`).

instance_type

string

Specific cloud instance type (e.g., `g5.2xlarge`, `Standard_NC6s_v3`). If omitted, Seed selects an optimal instance based on CPU, memory, and GPU requirements.

cpus

string

CPU count. Specify an exact value like "4" or a minimum with "4+".

memory

string

Memory in GB. Specify an exact value like "16" or a minimum with "16+".

disk_size_gb

integer

Persistent disk size in gigabytes.

disk_tier

string

Disk performance tier. One of standard, high, ultra.

default: standard

spot

boolean

Use spot/preemptible instances for lower cost. Spot instances may be reclaimed by the cloud provider.

default: false

gpus

string

GPU configuration in the format "GPU_TYPE:COUNT". For example, "A100:1", "H100:4", "T4:2".

image_id

string

Custom machine image ID (e.g., AMI for AWS, image URI for GCP). If omitted, a default Outpost base image is used.

ports

integer[]

Additional ports to expose. Port 22 (SSH) is always included automatically.

labels

object

Cloud provider labels or tags applied to the instance, as key-value pairs.

tools

string[]

Development tools to pre-install. For example, ["python", "docker", "rust"].

packages

string[]

Linux packages to install via the system package manager. For example, ["ffmpeg", "libcurl4-openssl-dev"].

setup

string

A setup script to run on machine startup. Runs as root after tools and packages are installed.

envs

object

Environment variables to set in the machine, as key-value pairs.

autostop

integer

Number of idle minutes before the machine is automatically paused. Set to `0` to disable.

autoterminate

integer

Number of idle minutes before the machine is automatically destroyed. Set to `0` to disable.

Overview

List machines