Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Global Flags

All internal spall flags use the --spall-* prefix so they never collide with API parameters.

Output and Formatting

FlagShortDescription
--spall-output-OOutput format: json/pretty, raw, yaml, table, csv, or @file
--spall-download-oSave response body to a file
--spall-verbose-vPrint request/response headers to stderr
--spall-debugWire-level debug logging (redacts secrets)
--spall-timeInclude request/response timing in verbose output
--filterJMESPath filter expression for JSON responses

Network Control

FlagShortDescription
--spall-server-sOverride base URL for this request
--spall-timeout-tTimeout in seconds (default: 30)
--spall-retryRetry count for failed requests (default: 1, max: 3)
--spall-follow-LFollow HTTP redirects (default: off)
--spall-max-redirectsMaximum redirects (default: 10)
--spall-insecureSkip TLS certificate verification
--spall-ca-certPath to custom CA certificate
--spall-proxyHTTP/SOCKS proxy URL

Request Modification

FlagShortDescription
--spall-header-HInject a non-sensitive header (repeatable)
--spall-auth-APass-through auth token/header
--spall-content-type-cOverride request content type

Execution Control

FlagShortDescription
--spall-dry-runPrint curl equivalent without executing
--spall-previewShow resolved URL, headers, and body without sending
--spall-paginateAuto-follow Link header pagination
--spall-repeatReplay the most recent request from history
--profileActive config profile (e.g., staging, production)

Examples

Verbose request with timing

spall petstore get-pet-by-id 1 --spall-verbose --spall-time

Staging override with custom header

spall petstore get-pet-by-id 1 \
  --spall-server https://staging.petstore.io \
  --spall-header "X-Debug: true"

Retry with redirect following

spall petstore get-pet-by-id 1 --spall-retry 3 --spall-follow

Replay last request

spall --spall-repeat

Next Steps