low-level-requests.md

Low-Level Requests

The generated surface is broad, but there are still cases where a raw request is the clearest option:

• you want to hit an endpoint before the generated wrappers are refreshed
• you want direct control over wrapped responses
• you are experimenting with unusual headers or request bodies

Raw Request Shape

{:ok, response} =
  GitHubEx.Client.request(client, %{
    method: :get,
    path: "/repos/{owner}/{repo}",
    path_params: %{"owner" => "octocat", "repo" => "Hello-World"},
    query: %{},
    body: nil,
    headers: %{},
    opts: [response: :wrapped]
  })

The raw request still goes through:

• path validation
• auth override handling
• retry classification
• response decoding
• wrapped response handling

Disabling Default Auth

For public requests where you explicitly do not want the client default token attached:

GitHubEx.Client.request(client, %{
  method: :get,
  path: "/meta",
  use_default_auth: false
})