25.0.2

📦 Reference SDK 10.0.402. Runtime 10.0.13 patch (version 25.0.2)

SDK: 10.0.402
Patched versions: 25.0.0, 25.0.1

Version 25.0.2 includes upgraded solutions of all Ocelot packages based on .NET SDK 10.0.402, released on October 13, 2026. For more details about SDK 10.0.402 (also known as Runtime 10.0.13), see the .NET 10.0.13 Release Notes as part of the .NET 10 Release Notes.

🔥 Hotfix for bugs #2352 and #2428 (version 25.0.2), a.k.a. Dynamic Routing patch 📦

Affected Milestones: .NET 10, Summer '25
Hotfixed versions: 24.1.0 ("Globality"), 25.0.0, 25.0.1 (".NET 10")
Read the Docs: Ocelot 25.0 with PDF

🔥 Hotfixed bugs are #2352 and #2428. A sincere and heartfelt "Thank You" goes to @xiexihui, @elenacalugaru, and @alin-popa for reporting these critical bugs.
❤️ A special "Thank You" goes to Beka Mosulishvili (@bekammo) for the professional and timely contributions in pull requests #2427 and #2429.

❗Breaking Changes❗

Interface Breaking Changes:

• Interface FQN: Ocelot.DownstreamRouteFinder.Finder.IDownstreamRouteProvider
• Deleted type FQN: Ocelot.DownstreamRouteFinder.DownstreamRouteHolder

The IDownstreamRouteProvider.Get method now returns Response<Route> (previously Response<DownstreamRouteHolder>). The DownstreamRouteHolder class has been removed. Placeholders are now stored directly on Route.TemplatePlaceholderNameAndValues. Custom implementations of IDownstreamRouteProvider and any code that references DownstreamRouteHolder require updates and recompilation.

Other changes affecting deployments:

1. Dynamic Routing no longer attempts to build upstream header templates from incoming request headers (fixes RegexParseException on certain browser headers such as sec-ch-ua). An empty collection is returned instead. Static routing is unchanged.
2. Reference updated to .NET SDK 10.0.402 / Runtime 10.0.13.

Features of version 25.0.2

Logbook

• _{57b953e by Raman Maksimchuk on Thursday, October 15 at 19:32 →}
  Release version 25.0.2 for SDK 10.0.402 | Dynamic Routing patch | +semver: patch
• _{268fbb4 by Raman Maksimchuk on Thursday, October 15 at 14:45 →}
  Ref SDK 10.0.402 (Runtime 10.0.13) to release Ocelot v25.0.2 and Ocelot.Testing v25.0.2
• _{fda3a29 by Beka Mosulishvili on Wednesday, October 07 at 22:54 →}
  #2428 Update DownstreamUrlCreatorMiddleware to proxy the original upstream URL part as-is as the downstream path when routing dynamically (#2429)
• _{b391b14 by bekammo on Wednesday, September 30 at 15:11 →}
  #2352 Stop building upstream header templates from request headers in dynamic routing (#2427)

What's Changed

• #2352 Stop building upstream header templates from request headers in dynamic routing by @bekammo in #2427
• #2428 Update DownstreamUrlCreatorMiddleware to proxy the original upstream URL part as-is as the downstream path when routing dynamically by @bekammo in #2429

New Contributors

• @bekammo made their first contribution in #2427

Full Changelog: 25.0.1...25.0.2