Skip to main content

​
Listing current and historical jobs

To list jobs associated with your API key, use: 
sutro jobs list --all
By default this will only list the most recent 25 jobs. To see all jobs, use the --all flag:

​
Getting job status by job_id

To get the status of a job by its ID, use: 
sutro jobs status <job_id>

​
Getting job results by job_id

To get the results of a job by its ID, use: 
sutro jobs results <job_id>
There are several optional flags you can use to customize the results:
  • You can also include the inputs in the results by using the --include-inputs flag.
  • You can also include the cumulative logprobs by using the --include-cumulative-logprobs flag.
  • You can also save the results to a file by using the --save flag.
  • If using the --save flag, you can also specify the format of the output file by using the --format flag. Options are parquet and csv, default is parquet.
sutro jobs results <job_id> --include-inputs --include-cumulative-logprobs
You can also save the results to a file by using the --save flag: 
sutro jobs results <job_id> --save

​
Cancelling a running job by job_id

To cancel a running priority 1 job by its ID, use: 
sutro jobs cancel <job_id>

​
Attaching to a running job by job_id

To attach to a running job by its ID, use: 
sutro jobs attach <job_id>
If the job is in progress, this will display a progress bar and live metrics around the job’s completion. If the job is in a terminal state, the command will exit. You can also attach to the latest job by using the --latest flag: 
sutro jobs attach --latest