The global --output flag accepts text or json.
Text output
Text is the default and is intended for terminal use. Commands generally use readable tables or tab-separated key/value lines. Monetary values are formatted with a currency when the service returns one.
JSON output
Use JSON when another command, script, or agent consumes the result:
Preserve opaque identifiers such as runId, inputFileId, reviewRequestId, and runTransactionId exactly. Do not derive an ID from a display name or convert one ID type into another.
JSON retains backend monetary fields such as estimatedTotalCostT; see Money units.
stdout and stderr
- Normal command results are written to stdout.
- Errors, generated idempotency-key notices, and
--verbose diagnostics are written to stderr.
- A non-zero exit status indicates an error, even if stdout contains partial validation context.
JSON results may include temporary signed artifact URLs. Do not store those URLs in long-lived logs or documentation. Prefer run result-workbook or artifact download for file retrieval.
