release: 0.52.0

[stainless-app]

Automated Release PR

0.52.0 (2026-04-29)

Full Changelog: v0.51.0...v0.52.0

Features

• profile download: 202 for empty profile + surface API errors in dashboard (fd0c20e)
• support setting headers via env (37dda88)

Bug Fixes

• use correct field name format for multipart file arrays (663f0a8)

Documentation

• annotate response with httpx.Response in browser routing example (0dfa1fb)
• print buffered body and mention httpx.Response semantics (84cb2e3)
• show both raw streaming and buffered curl in routing example (407e748)
• simplify browser routing example (58b0ee2)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

---

Note

Medium Risk
Touches request construction in two sensitive areas: default header injection from an environment variable and multipart file field-name serialization for arrays; both could subtly change wire formats and break existing integrations if misconfigured.

Overview
Release 0.52.0: bumps package/version metadata and updates the OpenAPI stats + changelog for the release.

Adds support for setting client default headers via the KERNEL_CUSTOM_HEADERS env var (merged with any provided default_headers) for both sync and async clients.

Fixes multipart file array serialization by making extract_files(..., array_format=...) control emitted field names ([], bare, or indexed), centralizes ArrayFormat/NestedFormat types, and expands tests accordingly.

Updates docs/examples: clarifies profiles.download return format and simplifies the examples/browser_routing.py sample to show both raw request (streaming httpx.Response) and buffered curl usage.

^{Reviewed by Cursor Bugbot for commit da3d891. Bugbot is set up for automated code reviews on this repo. Configure here.}

[firetiger-agent]

Firetiger deploy monitoring skipped

This PR didn't match the auto-monitor filter configured on your GitHub connection:

Any PR that changes the kernel API. Monitor changes to API endpoints (packages/api/cmd/api/) and Temporal workflows (packages/api/lib/temporal) in the kernel repo

Reason: This is an automated release PR with only documentation changes; it does not modify API endpoints (packages/api/cmd/api/) or Temporal workflows (packages/api/lib/temporal) as specified in the filter.

To monitor this PR anyway, reply with @firetiger monitor this.

[stainless-app]

🧪 Testing

To try out this version of the SDK:

pip install 'https://pkg.stainless.com/s/kernel-python/fd0c20eb17f0a6df382672c34830a81fac9217d9/kernel-0.51.0-py3-none-any.whl'

Expires at: Fri, 29 May 2026 14:37:24 GMT
Updated at: Wed, 29 Apr 2026 14:37:24 GMT

[masnwilliams]

lgtm

[stainless-app]

🤖 Release is at https://github.com/kernel/kernel-python-sdk/releases/tag/v0.52.0 🌻