http

Make generic HTTP requests to full URLs.

Use this when a one-off internal or external endpoint needs Homeboy’s local transport affordances without creating a project API config.

Examples

sh
homeboy auth profile set-basic example-profile --username example-org
homeboy http get https://logstash.example.com/logstash/... --proxy socks5://127.0.0.1:8080 --auth-profile example-profile
sh
homeboy http request POST --apply https://example.com/api --json '{"ok":true}' --header 'X-Example: value'

homeboy http request allows GET, HEAD, and OPTIONS without --apply. Other methods require --apply before Homeboy sends the request.

Options

  • --proxy <url> routes the request through an explicit proxy URL.
  • --auth-profile <name> adds an Authorization header from homeboy auth profile keychain storage.
  • --header 'Name: value' adds a request header.
  • --json <json> sends a JSON body.
  • --form key=value sends form fields.
  • --apply confirms mutating request methods other than GET, HEAD, and OPTIONS.

Output is structured JSON with variant, method, url, status, headers, and body. The variant discriminator is currently response.