CLI command reference
Manage per-profile request headers
Manage HTTP headers that are sent with every request when a profile is active.
Useful for transport-layer auth that gates access to an environment — for example, Cloudflare Zero Trust service tokens (CF-Access-Client-Id / CF-Access-Client-Secret) on a non-prod API host.
Headers are stored in ~/.hessian/credentials alongside the profile’s other credentials and merged with any —header flags at request time. A —header flag with the same name overrides the profile entry for that one invocation.
| Flag | Type | Description |
|---|---|---|
-h, --help | “ | help for header |
| Flag | Type | Description |
|---|---|---|
--api_url | string | API URL (overrides the active context) (default “http://localhost:8000”) |
--config | string | config file (default is $HOME/.hessian/config.yaml) |
--debug | “ | Enable debug logging |
-H, --header | strings | Add custom header(s) to requests (format: ‘Key: Value’). Can be repeated. |
--json | “ | Output in JSON format (overrides —output) |
--profile | string | Context profile to use (overrides current_context and HESSIAN_PROFILE) |