Create a job

Submit a new batch job for execution

POST

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

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.

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