NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1279 most downloaded on crates.io
Compile time generated OpenAPI documentation for Rust
Latest stable
6.0.0
Last release 2 months ago
22 Sep 2026
Ships unpredictably
gaps range from 8 days to 11 months
Nearly every release is documented
notes for 47 of 47 stable releases
2 versions withdrawn
withdrawn after publishing
5 years old
61 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
(baa4d04) Remove support for expression ignore in ToSchema and IntoParams (#1619) @juhaku
ToSchema and IntoParams (#1619) @juhakuVersion32 (https://github.com/juhaku/utoipa/pull/1555)
$self (self_uri field), webhooks, and jsonSchemaDialect on OpenAPI rootmediaTypes, parameters, examples, requestBodies, headers, links, callbacks, and pathItems$ref, query operation, and additionalOperationsitemSchema, description, itemEncoding, prefixEncoding, and Server-Sent Events / typed streaming payload modelingsummary, parent, and kind; Server name; XML nodeType; Response summary; Example dataValue and serializedValue; Parameter location querystring; Parameter style cookie; OAuth2 deviceAuthorization and oauth2MetadataUrl; deprecated on security schemesoperationId, operationRef, and requestBody (https://github.com/juhaku/utoipa/pull/1555)bigdecimal and bigdecimal_float feature support for BigDecimal type (https://github.com/juhaku/utoipa/pull/1487)title on RefBuilder (https://github.com/juhaku/utoipa/pull/1380)default on RefBuilder (https://github.com/juhaku/utoipa/pull/1380)ToSchema and IntoParams (https://github.com/juhaku/utoipa/pull/1619)serde_norway dependency. The yaml feature now uses yaml_serde and OpenApi::to_yaml returns yaml_serde::Error (https://github.com/juhaku/utoipa/issues/1565)Your coding agent can read these notes before it upgrades. Set up the MCP server →
(2492086) Update next release @juhaku
jiff::Timestamp (#1416) @paolobarboliniTimestamp (https://github.com/juhaku/utoipa/pull/1416)(a024aca) Chore update utoipa and utoipa-gen versions (#1415) @juhaku
serde_yml with serde_norway (#1311) @DenuxPlaysserde_yaml with serde_yml (#1280) @DenuxPlaysserde_yaml with serde_norway (https://github.com/juhaku/utoipa/pull/1311)(e5bb59f) Update next release versions (#1278) @juhaku
assert-json-diff with snapshot testing via insta (#1254) @Turbo87assert-json-diff with snapshot testing via insta (https://github.com/juhaku/utoipa/pull/1254)Thanks to the remarkable community members of their hard work and hours spend on changes to the utoipa. This release would not have been possible with
Thanks to the remarkable community members of their hard work and hours spend on changes to the utoipa. This release would not have been possible without you :tada:
utoipa-gen 5.3.0 version (https://github.com/juhaku/utoipa/pull/1250)serde_json dependency in macros instead of implicitly requiring it as dependency in end projects (https://github.com/juhaku/utoipa/pull/1243)(1b85aaf) Increment next release versions @juhaku
(f82d058) Update utoipa & utoipa-gen release versions @juhaku
(e9eebd0) Update next release versions @juhaku
(30a52ca) Update next release versions @juhaku
(c77282f) Update versions and CHANGELOGS @juhaku
identifier for Info (#1140) @juhakuToSchema implementation for serde_json::Value (#1132) @juhakuidentifier for Info (https://github.com/juhaku/utoipa/pull/1140)ToSchema implementation for serde_json::Value (https://github.com/juhaku/utoipa/pull/1132)Thank you all for the contributions and patience for now is the time for another major release of utoipa. Make it a bit more utopic than before. :rock
Thank you all for the contributions and patience for now is the time for another major release of utoipa. Make it a bit more utopic than before. :rocket: This release brings about a bunch of perks which definitely are found to be useful by many. These are full generics support, automatic schema collection, support for rust type aliases, axum bindings, nesting support and OpenAPI 3.1 only.
schemas into ToSchema for schemas (#1112) @juhakuToSchema for container types (#1107) @juhakuextensions for OpenAPI types (#1104) @juhakuprefixItems on Array (#1103) @juhakuproperty_names for object (#1084) @juhakuThe changes in this release are in full correlation with changes introduce to https://github.com/juhaku/utoipa/releases/tag/utoipa-gen-5.0.0.
Those looking to migrate here is the Migration Guide.
extensions for OpenAPI types (https://github.com/juhaku/utoipa/pull/1104)property_names for object (https://github.com/juhaku/utoipa/pull/1084)Extensions type (https://github.com/juhaku/utoipa/pull/1062)utiopa (https://github.com/juhaku/utoipa/pull/1048)links in #[utoipa::path] (https://github.com/juhaku/utoipa/pull/1047)utoipa-axum binding example and update docs (https://github.com/juhaku/utoipa/pull/1007)example methodOpenApi support (https://github.com/juhaku/utoipa/pull/930)merge_from method for chainable merge (https://github.com/juhaku/utoipa/pull/924)tags (https://github.com/juhaku/utoipa/pull/916)ToSchema for container types (https://github.com/juhaku/utoipa/pull/1107)required attribute (https://github.com/juhaku/utoipa/pull/990)schemas into ToSchema for schemas (https://github.com/juhaku/utoipa/pull/1112)utoipa related changes in utoipa CHANGELOGutoipa-axum bindings (https://github.com/juhaku/utoipa/pull/1017)url version (https://github.com/juhaku/utoipa/pull/1001)prefixItems on Array (https://github.com/juhaku/utoipa/pull/1103)(56c06a1) Update utoipa-config version @juhaku
utoipa-config version @juhakucontent_type without schema (#1073) @juhakuExtensions type (#1062) @heat1qutiopa (#1048) @juhakulinks in #[utoipa::path] (#1047) @juhakutermsOfService to OpenApi derive (#1046) @juhakucurl by default (#1045) @cyqsimonutoipa-axum bindings (#1017) @juhaku(57ba3ba) Update next beta versions @juhaku
OpenApi derive macro (#1011) @juhakuutoipa-axum binding example and update docs (#1007) @juhakuurl version (#1001) @juhaku(55544ef) Add some deprecated attributes for example method @juhaku
required attribute (#990) @juhakuexample method @juhaku(50dbec1) Bump up to next alplha @juhaku
First release of new set of development effort containing breaking changes eventually aimed to bring lot of needed feature eventually available in sta…
First release of new set of development effort containing breaking changes eventually aimed to bring lot of needed feature eventually available in stable release such as OpenAPI 3.1, nesting and perhaps better integration between frameworks.
description attribute on ToSchema (#949) @juhakuutoipa-swagger-ui versions (#938) @juhakuOpenApi support (#930) @juhakumerge_from method for chainable merge (#924) @juhakutags (#916) @juhaku(e0718de) Update utoipa version @juhaku
(2de0fb7) Fix utoipa-gen dependency version (#909) @juhaku
(19fb23c) Seems like the zip_next is nowadays just zip again
zip with zip_next (#889) @Pr0metheandefault-features = false to the optional axum dependency to avoid pulling in tokio in non-tokio environments (#874) @jakubadamwReDoc to take Cow<'static, str> instead of borrowed str (#869) @simongoricarCow<'static, str> instead of borrowed str (#867) @simongoricarutoipa-swagger-ui build (#845) @oscar6echodefault-features = false to the optional axum dependency to avoid pulling in tokio in non-tokio environments (https://github.com/juhaku/utoipa/pull/874)utoipa-swagger-ui build (https://github.com/juhaku/utoipa/pull/845)zip with zip_next (https://github.com/juhaku/utoipa/pull/889)ReDoc to take Cow<'static, str> instead of borrowed str (https://github.com/juhaku/utoipa/pull/869)Cow<'static, str> instead of borrowed str (https://github.com/juhaku/utoipa/pull/867)Thanks again the awesome community of making this release possible. Changes by glance includes improvements in path macro, support for rocket 0.5 and
Thanks again the awesome community of making this release possible. Changes by glance includes improvements in path macro, support for rocket 0.5 and axum 0.7.0, support for multiple security keys, utoipa-swagger-ui not relying on folder-interpolation feature and serde deny unknown fields plus other tweaks.
(5d96e30) Support #[serde(flatten)] for maps. (#799) @blp
#[serde(flatten)] for maps. (#799) @blp#[serde(flatten)] for maps. (https://github.com/juhaku/utoipa/pull/799)Thanks for the contributors for their work in this release. While this is a breaking release it is small one. The single breaking thing is further exp
Thanks for the contributors for their work in this release. While this is a breaking release it is small one. The single breaking thing is further explained here #762.
decimal_float feature. (#750) @rlebran-netwodecimal_float feature. (https://github.com/juhaku/utoipa/pull/750)(5fb25fa) Add support for serde skip in IntoParams derive
IntoParams derive (#743)IntoParams derive (https://github.com/juhaku/utoipa/pull/743)Time for another release. Thanks to the awesome contributors for their precious time and effort for making this release happen .
Time for another release. Thanks to the awesome contributors for their precious time and effort for making this release happen :tada:.
(fe3b42d) Fix automatic request body
(c69bb26) Fix Arc and Rc and SmallVec<[T]> (#699) @juhaku
Arc<T> and Rc<T> and SmallVec<[T]> (#699) @juhakuArc<T> and Rc<T> and SmallVec<[T]> (https://github.com/juhaku/utoipa/pull/699)(0073541) Add support for deprecation using schema attribute (#688) @nullsauce
This release is merely a fix for previous 3.4.0 version. It restores the old behavior for path and query parameters and comes with few improvements made by our awesome contributors :tada:.
Option<Query<T>> type support (#678) @juhakuOption<Query<T>> type support (https://github.com/juhaku/utoipa/pull/678)Time has passed, and it is again time for another release. Again I'd like to thank all the volunteers that have contributed to the utoipa. It wouldn't
Time has passed, and it is again time for another release. Again I'd like to thank all the volunteers that have contributed to the utoipa. It wouldn't definitely be here if it weren't for you guys. :muscle:
There are not too many changes and most notably fixes here and there. Also this release introduces a better path and query parameter recognition as well as for supported frameworks there is automatic request body recognition. :tada:
auto_types feature flag (#665) @juhakutype: object restriction in empty() (#648) @jayvdbpreserve_path_order cargo feature docs (#614) @juhakuwith_schema to schema_with in docs (#586) @jayvdbpreserve_path_order cargo feature docs (https://github.com/juhaku/utoipa/pull/614)auto_types feature flag (https://github.com/juhaku/utoipa/pull/665)type: object restriction in empty() (https://github.com/juhaku/utoipa/pull/648)with_schema to schema_with in docs (https://github.com/juhaku/utoipa/pull/586)This release comes with mostly fixes and small improvements and additions. Most notable changes are support for "Any Type" to render any JSON content
This release comes with mostly fixes and small improvements and additions. Most notable changes are support for "Any Type" to render any JSON content (example can be found here: https://github.com/juhaku/utoipa/tree/master/examples/raw-json-actix) and optional support for non-standard integer formats.
Massive kudos for people willing to contribute to the utopic API. :smiling_face_with_tear:
indexmap feature support for TypeTreepreserve_order feature (#562) @juhakuindexmap feature support for TypeTreepreserve_order feature (https://github.com/juhaku/utoipa/pull/562)This release mainly introduces minor documentation updates.
This release mainly introduces minor documentation updates.
This release comes with few notable features such as automatically creating default values for schemas from Default trait implementation, support for
This release comes with few notable features such as automatically creating default values for schemas from Default trait implementation, support for tuple types in generated schemas and new PartialSchema trait for simplier manual schema creation.
Additionally there are few bug fixes that are done as well as documentation updates. Huge thanks to the contributors :1st_place_medal: for helping in this awesome utoipa journey.
ToSchema derive (#546) @juhakumap() instead of unwrap() (#536) @Narayanbhat166map() instead of unwrap() (https://github.com/juhaku/utoipa/pull/536)ToSchema derive (https://github.com/juhaku/utoipa/pull/546)(61046d1) Make Option non-required & add required attr (#530) @juhaku
Option non-required & add required attr (#530) @juhakuOption non-required & add required attr (https://github.com/juhaku/utoipa/pull/530)(b4e11dc) Remove superfluous deprecated path attribute (#520) @juhaku
deprecated path attribute (#520) @juhakuAs attribute to complex enum (#516) @juhakuAs attribute to complex enum (https://github.com/juhaku/utoipa/pull/516)deprecated path attribute (https://github.com/juhaku/utoipa/pull/520)(2e501eb) Fix nullable ref schema inline (#510) @juhaku
This release introduces bug fixes and small improvements.
This release introduces bug fixes and small improvements.
ToSchema fields (#490) @juhaku#[utoipa::path] (#489) @juhaku#[utoipa::path] (https://github.com/juhaku/utoipa/pull/489)ToSchema fields (https://github.com/juhaku/utoipa/pull/490)(2986e5a) Enhance unit type support (#476) @juhaku
() (#464) @biwecka() (https://github.com/juhaku/utoipa/pull/464)(6190978) Fix explicit lifetimes for consts
About a 1 year ago the first public release of utoipa was published. A 1 day less to be exact. It has been a long journey since the first release and
About a 1 year ago the first public release of utoipa was published. A 1 day less to be exact. It has been a long journey since the first release and the utoipa has seen countless improvements, even coming from the latest release a numerous things have been tinkered.
The API has seen quite a reform and it is unified across the board in many places. Missing attributes, configuration options and functionalities have been added to many places. Docs were improved a lot, a few bug fixes here and there and 2 new derive implementations were added.
Huge thanks to you dear contributor for your support and help in this project as well as those who have filed issues and created discussions on important matters that help to make this library better. :1st_place_medal:
This is a breaking release and there are few things to read through when you update to this release. You can read more from here: https://github.com/juhaku/utoipa/discussions/456
ToReponse trait (#460) @juhakuskip_serializing (#438) @Xenfopreserve_order feature flag (#437) @SanchithHegdepreserve_order feature to preserve property order during serialization (#436) @SanchithHegdeIntoResponses support (#433) @juhakuToResponse implementation (#419) @juhakuToResponse derive implementation (#416) @juhakuschema(...) definition (#410) @juhakuType to TypeTree (#408) @juhakumerge functionality for OpenApi (#397) @juhakuschema_with custon fn reference (#390) @juhakuTypeTree for slice and array types (#387) @juhakuIntoParams (#386) @juhakuToSchema documentationserde_json mandatory dependency (#378) @juhakuIntoParams (#374) @juhakuIntoParmas testsMigration guide: https://github.com/juhaku/utoipa/discussions/456
skip_serializing (https://github.com/juhaku/utoipa/pull/438)preserve_order feature to preserve property order during serialization (https://github.com/juhaku/utoipa/pull/436)IntoResponses support (https://github.com/juhaku/utoipa/pull/433)ToResponse derive implementation (https://github.com/juhaku/utoipa/pull/416)schema(...) definition (https://github.com/juhaku/utoipa/pull/410)merge functionality for OpenApi (https://github.com/juhaku/utoipa/pull/397)schema_with custom fn reference (https://github.com/juhaku/utoipa/pull/390)IntoParams (https://github.com/juhaku/utoipa/pull/386)IntoParams (https://github.com/juhaku/utoipa/pull/374)TypeTree for slice and array types (https://github.com/juhaku/utoipa/pull/387)ToResponse trait (https://github.com/juhaku/utoipa/pull/460)preserve_order feature flag (https://github.com/juhaku/utoipa/pull/437)ToResponse implementation (https://github.com/juhaku/utoipa/pull/419)Type to TypeTree (https://github.com/juhaku/utoipa/pull/408)ToSchema documentationserde_json mandatory dependency (https://github.com/juhaku/utoipa/pull/378)IntoParams tests(f35bcc4) Fix ToSchema map field exmaple (#365) @juhaku
ToSchema map field exmaple (#365) @juhaku(3bb1d72) Update new utoipa version
This release mainly refactors internals and improves already existing functionalities but also adds few new things. One of these are multiline descrip
This release mainly refactors internals and improves already existing functionalities but also adds few new things. One of these are multiline descriptions in OpenAPI and custom rename functionality for ToSchema.
(a2ca384) Clean up deprecated code and lint warnings
It has been been a while since last release even the pace hasn't been the best but thanks to the many contributors keeping it up :trophy:. This release adds a serde and a custom rename to the IntoParams derive macro. A fix to an old Vec example field bug where the example for Vec types did not result correct schema https://github.com/juhaku/utoipa/issues/225#issuecomment-1193109556. From now on there is no need to do it as it is in the comment but instead as example = json!(...). Other updates includes serde flatten (finally), ranges in response statuses and changes in defining responses paving the way for derived responses eventually.
IntoParams field names (#309) @fluxxu(416e9eb) Fix trait support for TypeTree
(b5c3327) Add caution on export rule
(9a73ea6) Fix crates badge link
This release introduces breaking changes and this discussion page https://github.com/juhaku/utoipa/discussions/181 can be used as a migration referenc…
It has been a long summer and wait time is now over. For many changes and additions has been done for this release and while being such a long time span it is really hard to highlight any particular one. First and foremost big thanks to all the contributors who have invested their time and tears for making this library. You guys are pure gold :medal_sports:.
Overall utoipa has seen wide range of changes from performance upgrades, refactorings to updated swagger-ui library. Overall API changes that have been made is to make the API more consistent with the OpenAPI specification. These additions include improved rocket support, better axum support, enhanced serde support, support for Rust raw identifiers, improved value_type support and so on.
This release introduces breaking changes and this discussion page https://github.com/juhaku/utoipa/discussions/181 can be used as a migration reference quide.
openapi_extensions with helper functions for JSON responses and requestBodies (#240) @erewoktag property for simple enums (#146) @kellpossibleIt has been a while since last release and it almost feels like a too long has passed. But long await is sometimes worth it. This release introduces m
It has been a while since last release and it almost feels like a too long has passed. But long await is sometimes worth it. This release introduces more fixes and features. Now there is a suppport for generic components and Swagger UI also got more configuration options. Thanks to the contributors for helping to make this lib even more awesome. :heart:
(0b5baaf) Bump up next release version
(3018814) Bump up next release version
This release brings forth quite a few improvements which include improved path and query parameter resoving for actix-web framework, partial support f
This release brings forth quite a few improvements which include improved path and query parameter resoving for actix-web framework, partial support for serde attributes and uuid support as well.
Previously with actix-web you needed to define the query parameters within params(...) section of utoipa::path attribute macro but this release lets users completely omit those parameters since they now can be derived with IntoParams trait.
Serde support allows now people to skip fields or variants being serialized to OpenAPI spec and allows users to make the Components camelCase or any other case with rename_all.
Uuids are now supported with uuid feature flag directly within parameters and fields of components.
This is also a breaking release so keep notice of changes. The minimum rustc is now 1.60 mainly because of new feature flag format introduced in rust 1.60. Also previously chrono_types and chrono_types_with_format is changed to just chrono and chrono_with_format because of this new feature flag format introduced in rust 1.60.
Highlights for this release is integrated support for rocket framework for those who like to go orbit and beyond. Support for yaml thanks to first eve
Highlights for this release is integrated support for rocket framework for those who like to go orbit and beyond. Support for yaml thanks to first ever contribution @clearydude. As well some small fixes.
Fixes and small feature improvements. Supporting now rust_decimal and chrono types.
Fixes and small feature improvements. Supporting now rust_decimal and chrono types.
Fix SecurityScheme references in utoipa docs.
Fix SecurityScheme references in utoipa docs.
Stable is here! Added minor tweaks and from now I try to keep the api as stable as possible and breaking changes from now on would result major versio…
Stable is here! Added minor tweaks and from now I try to keep the api as stable as possible and breaking changes from now on would result major version upgrade.
Rc is finally here! :rocket: This release is quite a biggie and introduces new features, updates to exinsting ones and makes most of the API documente
Rc is finally here! :rocket: This release is quite a biggie and introduces new features, updates to exinsting ones and makes most of the API documented as well as API now follows more closely Rust guidelines. Without mention it also introduces few performance optimisations via reducing allocations.
(c7b82bb) Enhance actions support multimodules
While this release mainly introduces more documentation it also introduces small improvement to path attribute macro.
While this release mainly introduces more documentation it also introduces small improvement to path attribute macro.
(2591b90) Remove unnecessary echo from draft a release
(f9853bc) Update versons to beta.3
Nothing published for this version
One column per quarter.