NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1275 most downloaded on crates.io
Code generation implementation for utoipa
Latest stable
6.0.1
Last release 2 months ago
23 Sep 2026
Ships unpredictably
gaps range from 8 days to 11 months
Nearly every release is documented
notes for 48 of 48 stable releases
1 version 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.
(e1d8964) Fix min properties schema generation (#1623) @juhaku
(baa4d04) Remove support for expression ignore in ToSchema and IntoParams (#1619) @juhaku
ToSchema and IntoParams (#1619) @juhakuIntoParams (#1588) @jack-ullery#[schema(...)] on new type structs (#1427) @future-highwayutoipa-gen @juhakuYour coding agent can read these notes before it upgrades. Set up the MCP server →
item_schema = ... attribute in responses(...)/request_body(...), mapping to OpenAPI 3.2's itemSchema keyword for streaming/event-based media types such as text/event-streamversion = "..." attribute in #[derive(OpenApi)] (accepts "3.1.0" or "3.2.0", mapping to OpenApiVersion)IntoParams (https://github.com/juhaku/utoipa/pull/1588)summary, parent, and kind in #[derive(OpenApi)] tag parsingquerystring and cookie style in path parameter parsingdata_value and serialized_value in path examplesbigdecimal and bigdecimal_float feature support for BigDecimal type (https://github.com/juhaku/utoipa/pull/1487)#[schema(...)] on new type structs (https://github.com/juhaku/utoipa/pull/1427)title and default on RefBuilder instead of wrapping in oneOf when Option<_> is non-nullable (https://github.com/juhaku/utoipa/pull/1380)utoipa::ToSchema named structs (https://github.com/juhaku/utoipa/pull/1593)ToSchema and IntoParams (https://github.com/juhaku/utoipa/pull/1619)Into inference after content maps gained reference support (https://github.com/juhaku/utoipa/pull/1555)#[utoipa::path] panic for rocket data guards without a body type, such as Data<'_> or TempFile<'_> (https://github.com/juhaku/utoipa/pull/1611)#[serde(flatten)]. (https://github.com/juhaku/utoipa/pull/1582)vec![...] instead of stack allocated array literals in generated ToSchema/IntoParams code to avoid clippy::large_stack_arrays and stack overflows for types with many fields (https://github.com/juhaku/utoipa/issues/1454)oneOf for Option<_> with nullable = false and default/title/description (https://github.com/juhaku/utoipa/pull/1380)jiff type detection when only the jiff_0_2 feature is enabled (https://github.com/juhaku/utoipa/pull/1575)(2492086) Update next release @juhaku
jiff::Timestamp (#1416) @paolobarboliniserde to the helper attributes for ToSchema (#1472) @zackyanceyTimestamp (https://github.com/juhaku/utoipa/pull/1416)IntoParams, ToSchema, and PartialSchema for boolean ignored (e.g.: ignore = true) fields (https://github.com/juhaku/utoipa/pull/1500)(a024aca) Chore update utoipa and utoipa-gen versions (#1415) @juhaku
utoipa::path macro (#1292) @juliendecharentenayutoipa::path macro (https://github.com/juhaku/utoipa/pull/1292)(e5bb59f) Update next release versions (#1278) @juhaku
assert-json-diff with snapshot testing via insta (#1253) @Turbo87auto_into_responses feature declaration (#1252) @Turbo87assert-json-diff with snapshot testing via insta (https://github.com/juhaku/utoipa/pull/1253)auto_into_responses feature declaration (https://github.com/juhaku/utoipa/pull/1252)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:
nullable on Option for Query params (#1248) @Turbo87insta for snapshot testing (#1247) @Turbo87#[schema(pattern = "...")] on new type structs (#1241) @wyatt-herkampInfo::from_env() sets License::identifier (#1233) @masnagamMacroArg::Query case) (#1223) @SamuelMarksencoding support for request_body (https://github.com/juhaku/utoipa/pull/1237)#[schema(pattern = "...")] on new type structs (https://github.com/juhaku/utoipa/pull/1241)nullable on Option for Query params (https://github.com/juhaku/utoipa/pull/1248)insta for snapshot testing (https://github.com/juhaku/utoipa/pull/1247)parse_named_attributes a method of MediaTypeAttr (https://github.com/juhaku/utoipa/pull/1236)serde_json dependency in macros instead of implicitly requiring it as dependency in end projects (https://github.com/juhaku/utoipa/pull/1243)ToTokensDiagnostics for request_body (https://github.com/juhaku/utoipa/pull/1235)Info::from_env() sets License::identifier (https://github.com/juhaku/utoipa/pull/1233)(1b85aaf) Increment next release versions @juhaku
IntoParams (#1179) @juhakuKnownFormat parsing (#1178) @juhakuIntoParams (https://github.com/juhaku/utoipa/pull/1179)KnownFormat parsing (https://github.com/juhaku/utoipa/pull/1178)#[schema(ignore)] attribute now accepts an optional bool value/function path (https://github.com/juhaku/utoipa/pull/1177)(f82d058) Update utoipa & utoipa-gen release versions @juhaku
no_recursion support on maps (#1167) @juhakuno_recursion support on maps (https://github.com/juhaku/utoipa/pull/1167)(e9eebd0) Update next release versions @juhaku
(30a52ca) Update next release versions @juhaku
(c77282f) Update versions and CHANGELOGS @juhaku
identifier for Info (#1140) @juhakuno_recursion feature for ToSchema (#1137) @juhakuidentifier for Info (https://github.com/juhaku/utoipa/pull/1140)no_recursion feature for ToSchema (https://github.com/juhaku/utoipa/pull/1137)oneOf instead allOf to handle nullable values (https://github.com/juhaku/utoipa/pull/1135)(55544ef) Add some deprecated attributes for example method @juhaku
schemas into ToSchema for schemas (#1112) @juhakuKnownFormat @juhakuToSchema for container types (#1107) @juhakuprefixItems on Array (#1103) @juhakuinline field (#1102) @juhakutitle on unnamed struct and references (#1101) @juhakuutoipa-gen patch version @juhakuschema(ignore) and param(ignore) (#1090) @juhakuproperty_names for object (#1084) @juhakuas attribute path format (#1080) @juhakuToSchema generic bounds on impl instead of requiring it on definition (#1079) @oxalicautoipa-config version @juhakucontent_type without schema (#1073) @juhakuutiopa (#1048) @juhakulinks in #[utoipa::path] (#1047) @juhakutermsOfService to OpenApi derive (#1046) @juhakuOpenApi derive macro (#1011) @juhakuutoipa-axum binding example and update docs (#1007) @juhakuurl version (#1001) @juhakurequired attribute (#990) @juhakuexample method @juhakudescription attribute on ToSchema (#949) @juhakuOpenApi support (#930) @juhakutags (#916) @juhakuschema(ignore) and param(ignore) (https://github.com/juhaku/utoipa/pull/1090)property_names for object (https://github.com/juhaku/utoipa/pull/1084)bound attribute for customizing generic impl bounds. (https://github.com/juhaku/utoipa/pull/1079)utiopa (https://github.com/juhaku/utoipa/pull/1048)links in #[utoipa::path] (https://github.com/juhaku/utoipa/pull/1047)termsOfService to OpenApi derive (https://github.com/juhaku/utoipa/pull/1046)utoipa-axum binding example and update docs (https://github.com/juhaku/utoipa/pull/1007)example methoddescription attribute on ToSchema (https://github.com/juhaku/utoipa/pull/949)OpenApi support (https://github.com/juhaku/utoipa/pull/930)tags (https://github.com/juhaku/utoipa/pull/916)ToSchema for container types (https://github.com/juhaku/utoipa/pull/1107)inline field (https://github.com/juhaku/utoipa/pull/1102)title on unnamed struct and references (https://github.com/juhaku/utoipa/pull/1101)as attribute path format (https://github.com/juhaku/utoipa/pull/1080)content_type without schema (https://github.com/juhaku/utoipa/pull/1073)required attribute (https://github.com/juhaku/utoipa/pull/990)schemas into ToSchema for schemas (https://github.com/juhaku/utoipa/pull/1112)KnownFormatutoipa-config versionOpenApi derive macro (https://github.com/juhaku/utoipa/pull/1011)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) @juhakuutiopa (#1048) @juhakulinks in #[utoipa::path] (#1047) @juhakutermsOfService to OpenApi derive (#1046) @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
(d020f92) Update versions @juhaku
description attribute on ToSchema (#949) @juhakuOpenApi support (#930) @juhakutags (#916) @juhakuThis release fixes utoipa-gen private type leak. This is already fixed in the master but will now be released separately for the utoipa-gen for time b
This release fixes utoipa-gen private type leak. This is already fixed in the master but will now be released separately for the utoipa-gen for time being.
utoipa-gen patch versionFull Changelog: https://github.com/juhaku/utoipa/compare/utoipa-gen-4.3.0...utoipa-gen-4.3.1
(19fb23c) Seems like the zip_next is nowadays just zip again
default-features = false to the optional axum dependency to avoid pulling in tokio in non-tokio environments (#874) @jakubadamwdefault-features = false to the optional axum dependency to avoid pulling in tokio in non-tokio environments (https://github.com/juhaku/utoipa/pull/874)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 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]>
Arc<T> and Rc<T> and SmallVec<[T]> (#699)Arc<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)(588ff69) Fix utoipa-gen feature and update versions
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 TypeTreeindexmap feature support for TypeTree(632437a) Update next release versions
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) @XenfoIntoResponses 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 testsskip_serializing (https://github.com/juhaku/utoipa/pull/438)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)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(7502d85) Clean unused dependencies related to repr feature
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
(efc6821) Feature serde default
(14157de) Fix unnamed enum with tag having single field
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 an 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: .
Utoipa-gen has seen quite a few changes during this time which few of them not listed in any particular order: Simple enums has received serde tag property, improved IntoParams implementation, value_type got enhanced, inlining support for various places for schemas, better support for axum, support for time and smallvec cratres, etc.
This release introduces breaking changes and this discussion page https://github.com/juhaku/utoipa/discussions/181 can be used as a migration reference quide.
tag 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 @jgramoll for contributing.
(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.
This release hides utoipa-gen generated types from polluting the docs of application.
This release hides utoipa-gen generated types from polluting the docs of application.
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.
(f95f5f2) Chore extract Swagger UI from utoipa
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.