The product

App Storage is the Sauce Labs service that holds the application binaries your tests run against. sauce storage upload sends an App file and prints its File id; sauce storage download writes one back to disk.

sauce storage files lists App files (filter by File id, team id, org id, Kind or a search term), edits a file’s description and deletes files. sauce storage groups lists App groups, shows and updates their Group settings (Orientation, Instrumentation, Resigning or any other key) and deletes groups.

sauce jobs list lists recent jobs for your Username; --real switches to Real-device jobs from the Real Device Cloud. sauce jobs info prints a Job summary, or the full API response with --verbose.

sauce jobs edit changes a Virtual-device job’s name, Tags, Visibility, Build, Custom data or Job result. Real-device jobs are read-only here: the Real Device Cloud API does not accept edits.

By default each command prints only the identifiers it produced, so output pipes into other tools. --verbose prints the full API response, --output yaml switches it from JSON to YAML, and --silent prints nothing.

Exit code 0 is success, 1 a general, API or validation error, 2 missing or invalid Credentials, and 77 an authentication rejected by Sauce Labs (HTTP 401 or 403).

The API layer is exported from the package, so Node.js code can call listJobs, uploadFile and the other functions with a SauceClient directly. Failed requests reject with an HttpError carrying the status, URL and parsed body.

sauce-labs-cli is an independent, unofficial project. It is not affiliated with, endorsed by or sponsored by Sauce Labs Inc. “Sauce Labs” is a trademark of its owner and is used here only to name the APIs this tool calls.

You need your own Sauce Labs account to use it.