Skip to main content
Check the status of training jobs, list fine-tuned models, and inspect uploaded files. The status command group provides read-only access to your Synth resources.

​
Commands

uvx synth-ai status summary       # Overview of recent activity
uvx synth-ai status jobs          # List training jobs
uvx synth-ai status models        # List fine-tuned models
uvx synth-ai status files         # List uploaded datasets
uvx synth-ai status runs          # List RL training runs

​
Summary

Quick overview of recent jobs, models, and files: 
uvx synth-ai status summary
Example output: 
┏━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Job ID   ┃ Type    ┃ Status     ┃ Created          ┃
┡━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ abc123   │ sft     │ succeeded  │ 2024-10-15 10:30 │
│ def456   │ rl      │ running    │ 2024-10-15 09:15 │
│ ghi789   │ sft     │ failed     │ 2024-10-14 14:20 │
└──────────┴─────────┴────────────┴──────────────────┘

┏━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
┃ Model ID             ┃ Base Model    ┃ Created          ┃
┡━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
│ ft:org:abc123        │ Qwen/Qwen3-4B │ 2024-10-15 10:45 │
│ ft:org:xyz789        │ Qwen/Qwen3-8B │ 2024-10-12 16:20 │
└──────────────────────┴───────────────┴──────────────────┘

​
Jobs

List and filter training jobs: 
# List recent jobs
uvx synth-ai status jobs

# Limit results
uvx synth-ai status jobs --limit 20

# Filter by status
uvx synth-ai status jobs --status succeeded

# Get specific job
uvx synth-ai status jobs --job-id abc123
Options:
  • --limit N - Number of jobs to show (default: 10)
  • --status {pending,running,succeeded,failed} - Filter by status
  • --job-id ID - Show specific job details
  • --type {sft,rl} - Filter by training type

​
Models

List fine-tuned models: 
# List all models
uvx synth-ai status models

# Limit results
uvx synth-ai status models --limit 20

# Get specific model
uvx synth-ai status models --model-id ft:org:abc123
Options:
  • --limit N - Number of models to show (default: 10)
  • --model-id ID - Show specific model details

​
Files

List uploaded datasets and files: 
# List all files
uvx synth-ai status files

# Limit results
uvx synth-ai status files --limit 20

# Get specific file
uvx synth-ai status files --file-id file_abc123
Options:
  • --limit N - Number of files to show (default: 10)
  • --file-id ID - Show specific file details

​
Runs

List RL training runs (episodes): 
# List recent runs
uvx synth-ai status runs

# Limit results
uvx synth-ai status runs --limit 50

# Filter by job
uvx synth-ai status runs --job-id abc123
Options:
  • --limit N - Number of runs to show (default: 10)
  • --job-id ID - Show runs for specific job

​
Common Options

All status commands support: 
--base-url URL          # Override backend URL
--api-key KEY           # Override API key
--timeout SECONDS       # Request timeout (default: 30)

​
Examples

​
Check Recent Activity

# Quick overview
uvx synth-ai status summary --limit 5

​
Monitor Training Job

# Check if job is complete
uvx synth-ai status jobs --job-id abc123

​
Find Fine-Tuned Model ID

# List models and find the one you want
uvx synth-ai status models

# Get details
uvx synth-ai status models --model-id ft:org:abc123

​
Verify Dataset Upload

# Check that file was uploaded
uvx synth-ai status files --limit 20

# Inspect specific file
uvx synth-ai status files --file-id file_abc123

​
Debug RL Training

# Check overall job status
uvx synth-ai status jobs --job-id rl_job_123

# Inspect individual runs/episodes
uvx synth-ai status runs --job-id rl_job_123 --limit 100

​
JSON Output

For programmatic access, pipe to jq: 
# Extract job IDs
uvx synth-ai status jobs --limit 10 | jq -r '.[].id'

# Filter succeeded jobs
uvx synth-ai status jobs --limit 50 | jq '.[] | select(.status == "succeeded")'

# Get model base names
uvx synth-ai status models | jq -r '.[].base_model'

​
Troubleshooting

​
”Authentication failed”

  • Run uvx synth-ai setup to configure credentials
  • Verify SYNTH_API_KEY is set in ~/.synth/config

​
”No jobs found”

  • You may not have submitted any training jobs yet
  • Try uvx synth-ai train --config sft.toml to create a job

​
”Connection timeout”

  • Increase timeout: --timeout 60
  • Check internet connection
  • Verify backend URL (use --base-url to override)

​
Empty tables

  • You may not have resources of that type yet
  • Check filters (e.g., --status may be excluding all results)

​
Integration with Dashboard

For visual monitoring, use the web dashboard: The dashboard provides:
  • Live job logs
  • Training curves
  • Model comparisons
  • Cost breakdowns

​
Next Steps