baseten train job

list

baseten train job list [OPTIONS]

List training jobs, newest first. Lists every job in projects your teams can access. Pass —project to narrow to one project, or —status to narrow to particular job states.

Options

TEXT

default:"desc"

Sort order by creation time: ‘desc’ (newest first) or ‘asc’ (oldest first).One of: asc, desc

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Only list jobs in this training project, by name or ID.

TEXT (repeatable)

Only list jobs in these states: pending, created, deploying, deploy-failed, running, completed, failed, stopped, preempted. Repeatable.

BOOL

Enable verbose logging

Examples

List every training job you can see

baseten train job list

List the running jobs of one project

baseten train job list --project my-project --status running

List jobs oldest first

baseten train job list --direction asc

Filter output with `--jq`

Print just the job IDs

baseten train job list --jq '.training_jobs[].id'

Output

Text mode (--output text): Table with columns: ID, PROJECT, NAME, STATUS, INSTANCE TYPE, NODES, CREATED. When no jobs match, prints “No training jobs found.” to stderr. JSON mode (--output json): payload type managementapi.SearchTrainingJobsResponse.

describe

baseten train job describe [OPTIONS]

Describe a training job by ID, including its project, compute, and checkpoint sync state.

Options

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

BOOL

Enable verbose logging

Examples

Describe a job

baseten train job describe --job-id p7qr9qv

Filter output with `--jq`

Print the job’s current status

baseten train job describe --job-id p7qr9qv --jq '.training_job.current_status'

Output

Text mode (--output text): A field-per-line summary of the job and its project. JSON mode (--output json): payload type managementapi.GetTrainingJobResponse.

logs

baseten train job logs [OPTIONS]

Fetch logs for a training job. Without —tail, returns the logs in a time window; with —tail, streams new logs until the job stops producing them or you interrupt with Ctrl-C.

Options

TEXT

End of the log time range. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. Default is now. Window must be at most 7 days.

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

INTEGER

default:"5000"

Maximum number of log lines to return, paging backward from the end of the window. Use 0 for no limit (every log line in the window). Not applicable with —tail.

TEXT

Only return logs at or above this severity level.One of: debug, info, warning, error

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Shortcut for fetching logs from a relative time ago until now. Accepts a duration (e.g. ‘30m’, ‘1h30m’) or ‘Nd’ (e.g. ‘3d’). Maximum ‘7d’. Mutually exclusive with —start and —end.

TEXT

Start of the log time range. Accepts ISO 8601 (e.g. ‘2026-05-14’, ‘2026-05-14T12:00:00’, ‘2026-05-14T12:00:00Z’). Values without a timezone designator are interpreted in the local timezone. Default is 30 minutes before the end. Window must be at most 7 days.

BOOL

Stream new logs as they arrive until the job stops producing them or you interrupt with Ctrl-C. Cannot be combined with the time-range or filter flags. For machine-readable streaming, prefer —output jsonl over —output json.

BOOL

Enable verbose logging

Examples

Fetch the last 30 minutes of logs

baseten train job logs --job-id p7qr9qv

Stream logs as they arrive

baseten train job logs --job-id p7qr9qv --tail

Fetch a day of error logs

baseten train job logs --job-id p7qr9qv --since 1d --min-level error

Filter output with `--jq`

Print just the log messages

baseten train job logs --job-id p7qr9qv --jq '.message'

Output

Text mode (--output text): One log line per row, timestamped. With —output jsonl, one JSON log record per line. JSON mode (--output json): payload type managementapi.GetLogsResponse.

metrics

baseten train job metrics [OPTIONS]

Report CPU, memory, GPU, and storage metrics for a training job. Each series is reported as its most recent sample. Pass —start and —end, or —since, to select the window the samples come from.

Options

TEXT

End of the sample window. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone. Default is now.

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

TEXT

Shortcut for sampling from a relative time ago until now. Accepts a duration (e.g. ‘30m’, ‘1h30m’) or ‘Nd’ (e.g. ‘3d’). Mutually exclusive with —start and —end.

TEXT

Start of the sample window. Accepts ISO 8601; values without a timezone designator are interpreted in the local timezone.

BOOL

Enable verbose logging

Examples

Report a job’s latest metrics

baseten train job metrics --job-id p7qr9qv

Report metrics sampled over the last hour

baseten train job metrics --job-id p7qr9qv --since 1h

Filter output with `--jq`

Print the GPU utilization series

baseten train job metrics --job-id p7qr9qv --jq '.gpu_utilization'

Output

Text mode (--output text): Table with columns: METRIC, NODE, VALUE, MEASURED. JSON mode (--output json): payload type managementapi.GetTrainingJobMetricsResponse.

stop

baseten train job stop [OPTIONS]

Stop a running or queued training job. Stopping is not reversible: use ‘baseten train job recreate’ to run the same configuration again. Checkpoints already synced remain accessible.

Options

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

BOOL

Skip the interactive confirmation prompt. Required when stdin is not a terminal.

BOOL

Enable verbose logging

Examples

Stop a job, confirming interactively

baseten train job stop --job-id p7qr9qv

Stop a job without confirmation, for scripts

baseten train job stop --job-id p7qr9qv --yes

Filter output with `--jq`

Print the stopped job’s status

baseten train job stop --job-id p7qr9qv --yes --jq '.training_job.current_status'

Output

Text mode (--output text): On success, prints the stopped job’s ID to stderr; no stdout output. JSON mode (--output json): payload type managementapi.StopTrainingJobResponse.

recreate

baseten train job recreate [OPTIONS]

Create a new training job from an existing job’s configuration. The original job is left as it is. The new job gets a new ID and starts from the beginning.

Options

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

BOOL

Enable verbose logging

Examples

Rerun a job’s configuration

baseten train job recreate --job-id p7qr9qv

Filter output with `--jq`

Print just the new job’s ID

baseten train job recreate --job-id p7qr9qv --jq '.training_job.id'

Output

Text mode (--output text): On success, prints the new job’s ID to stderr; no stdout output. JSON mode (--output json): payload type managementapi.RecreateTrainingJobResponse.

update

baseten train job update [OPTIONS]

Update a queued training job’s priority. Higher values are dequeued first. Only jobs in the PENDING state can have their priority changed.

Options

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

INTEGER

required

New queue priority. Higher values are dequeued first.

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

BOOL

Enable verbose logging

Examples

Raise a queued job’s priority

baseten train job update --job-id p7qr9qv --priority 10

Filter output with `--jq`

Print the job’s new priority

baseten train job update --job-id p7qr9qv --priority 10 --jq '.training_job.priority'

Output

Text mode (--output text): On success, prints the job’s ID and new priority to stderr; no stdout output. JSON mode (--output json): payload type managementapi.UpdateTrainingJobResponse.

download

baseten train job download [OPTIONS]

Download the code archive that was uploaded with a training job as an uncompressed tar. Exactly one of —out-file or —out-dir is required. —out-file writes the raw tar bytes; —out-dir extracts the tar into the directory. Use —overwrite to replace an existing file or write into a non-empty directory. This is the job’s input code, not its checkpoints; use ‘baseten train checkpoint files’ for those.

Options

TEXT

required

ID of the training job.

TEXT

Filter JSON output with a jq expression; implies —output json (or jsonl for streamed commands)

TEXT

Extract the artifact tar into this directory.Mutually exclusive with other flags in group download-out.

TEXT

Save the artifact as an uncompressed tar file at this path.Mutually exclusive with other flags in group download-out.

TEXT

default:"text"

Output formatOne of: text, json, jsonl, none

BOOL

Allow overwriting an existing file or non-empty directory.

TEXT

Use a specific stored profile for this command, overriding BASETEN_PROFILE and the current profile

BOOL

Enable verbose logging

Examples

Extract a job’s code into a directory

baseten train job download --job-id p7qr9qv --out-dir ./job-code

Save the archive as a tar file instead of extracting it

baseten train job download --job-id p7qr9qv --out-file job.tar

Filter output with `--jq`

Print just the destination path

baseten train job download --job-id p7qr9qv --out-file job.tar --jq '.out_file'

Output

Text mode (--output text): Writes the artifact to disk; prints progress and the final destination path to stderr; no stdout output. JSON mode (--output json): payload type cmd.TrainJobDownloadResult. On success, stdout is a JSON object naming the job, with either out_file or out_dir set to the path written.

​list

​Options

​Examples

​Filter output with --jq

​Output

​describe

​Options

​Examples

​Filter output with --jq

​Output

​logs

​Options

​Examples

​Filter output with --jq

​Output

​metrics

​Options

​Examples

​Filter output with --jq

​Output

​stop

​Options

​Examples

​Filter output with --jq

​Output

​recreate

​Options

​Examples

​Filter output with --jq

​Output

​update

​Options

​Examples

​Filter output with --jq

​Output

​download

​Options

​Examples

​Filter output with --jq

​Output

list

Options

Examples

Filter output with `--jq`

Output

describe

Options

Examples

Filter output with `--jq`

Output

logs

Options

Examples

Filter output with `--jq`

Output

metrics

Options

Examples

Filter output with `--jq`

Output

stop

Options

Examples

Filter output with `--jq`

Output

recreate

Options

Examples

Filter output with `--jq`

Output

update

Options

Examples

Filter output with `--jq`

Output

download

Options

Examples

Filter output with `--jq`

Output