Output and reference
Output and exit codes
Stdout holds the result; stderr holds status lines, hints and errors. So nace decide ... --json > answer.json and nace parse doc.pdf > doc.md capture only the result.
| Exit code | When |
|---|---|
0 | Success. nace job ID without --wait exits 0 whatever the job's status, so check status. |
1 | A request failed: an API error, a connection error or a timeout. Also a job you waited for that failed, was cancelled or outlasted --wait-timeout (its id goes to stdout); an upload or a download that failed after its requests went out, including any file of a folder; -o md on a job without Markdown; and a tool's or nace job's --save file that couldn't be written (the result goes to stdout instead). |
2 | A usage or configuration error: an unknown flag, a bad value, a missing file, invalid JSON, no API key, or an argument the SDK refuses. Most are caught before any request. Two from nace file come after one: --link on a file that streams, and a file it can't write (an unwritable --save path, or without --save, the current directory), which leaves stdout empty. nace with no command prints its help and exits 2. |