Skip to content

Add support for per-request extra_headers parameter#633

Open
dirceu wants to merge 1 commit into
alexrudall:mainfrom
dirceu:add-per-request-headers
Open

Add support for per-request extra_headers parameter#633
dirceu wants to merge 1 commit into
alexrudall:mainfrom
dirceu:add-per-request-headers

Conversation

@dirceu

@dirceu dirceu commented Jan 22, 2026

Copy link
Copy Markdown

Allow passing custom HTTP headers on individual API calls rather than only at client initialization time. This enables varying headers per request while reusing a single cached client instance.

Changes:

  • HTTP#get, #post, #json_post, #multipart_post, #delete accept extra_headers: {}
  • Client#chat, #embeddings, #completions, #moderations accept extra_headers: {}
  • Added tests for extra_headers functionality

All Submissions:

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same update/change?
  • Have you added an explanation of what your changes do and why you'd like us to include them?

Comment thread lib/openai/http.rb Outdated
@dirceu dirceu force-pushed the add-per-request-headers branch from ba0c8cc to a9d7974 Compare February 10, 2026 21:46
Comment thread lib/openai/http.rb Outdated
Allow passing custom HTTP headers on individual API calls rather than
only at client initialization time. This enables varying headers per
request while reusing a single cached client instance.

Changes:
- HTTP#get, #post, #json_post, #multipart_post, #delete accept extra_headers: {}
- Client#chat, #embeddings, #completions, #moderations accept extra_headers: {}
- Added tests for extra_headers functionality
@dirceu dirceu force-pushed the add-per-request-headers branch from a9d7974 to 1e8ada0 Compare February 10, 2026 21:50
@dirceu

dirceu commented Feb 10, 2026

Copy link
Copy Markdown
Author

@alexrudall any chance you can review this one? 🙏

@juharris

Copy link
Copy Markdown

@alexrudall any chance we can pass headers per request anytime soon? Otherwise I'm going to look into forking the library and publishing a new gem

juharris added a commit to Shopify/ruby-openai that referenced this pull request Jun 26, 2026
Same as alexrudall#633

---

Allow passing custom HTTP headers on individual API calls rather than
only at client initialization time. This enables varying headers per
request while reusing a single cached client instance.

Changes:
- HTTP#get, #post, #json_post, #multipart_post, #delete accept
extra_headers: {}
- Client#chat, #embeddings, #completions, #moderations accept
extra_headers: {}
- Added tests for extra_headers functionality

## All Submissions:

* [x] Have you followed the guidelines in our [Contributing
document](../blob/main/CONTRIBUTING.md)?
* [x] Have you checked to ensure there aren't other open [Pull
Requests](../pulls) for the same update/change?
* [x] Have you added an explanation of what your changes do and why
you'd like us to include them?

Co-authored-by: Dirceu Pereira Tiegs <dirceu.tiegs@shopify.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants