Create a job

Submit a new batch job for execution

POST

/auth/v1/seed/{namespace}/jobs

curl --request POST \
  --url /auth/v1/seed/{namespace}/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"training-run-1","cloud":"aws","region":"us-east-1","command":"python train.py --epochs 3 --lr 2e-5","num_nodes":4,"cpus":"32+","memory":"128+","gpus":"A100:4","disk_size_gb":500,"spot":true,"setup":"pip install -r requirements.txt","envs":{"WANDB_PROJECT":"llama-finetune","HF_TOKEN":"hf_xyz789"},"max_restarts":2}'

Submit a new batch job for execution. Jobs run the specified command to completion and then terminate.

Path parameters

namespace

string

required

The namespace (user or organization) to run the job in.

Body parameters

name

string

required

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

cloud

string

required

Cloud provider to run the job on. One of `aws`, `azure`, `gcp`.

region

string

required

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

zone

string

Availability zone within the region.

command

string

required

The command to execute. This is run as the job entrypoint.

num_nodes

integer

Number of nodes to provision for the job.

default: 1

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+"`.

gpus

string

GPU configuration in `GPU_TYPE:COUNT` format. For example, `"A100:4"`, `"V100:1"`, `"H100:8"`.

disk_size_gb

integer

Ephemeral disk size in gigabytes.

disk_tier

string

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

default: standard

instance_type

string

Specific cloud instance type to use, overriding automatic selection from CPU/GPU/memory requirements.

spot

boolean

Use spot (AWS), preemptible (GCP), or low-priority (Azure) instances for reduced cost.

default: false

setup

string

Setup commands to run before the main job command. Use this for installing dependencies or downloading data.

workdir

string

Working directory for the job command.

envs

object

Environment variables as key-value pairs.

max_restarts

integer

Maximum number of automatic restarts on failure.

default: 3

Previous → Delete a machine

Next List jobs →