diff --git a/Cargo.toml b/Cargo.toml
index 8afb45f..8566b28 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -22,7 +22,7 @@ documentation = "https://docs.rs/apistos/"
 license = "MIT OR Apache-2.0"
 rust-version = "1.75"
 publish = true
-version = "0.3.6"
+version = "0.4.0"
 
 [workspace.dependencies]
 actix-service = "2"
diff --git a/README.md b/README.md
index 473b8d1..2cb03c8 100644
--- a/README.md
+++ b/README.md
@@ -62,7 +62,7 @@ carpenters, craftsmen, metallurgy ... which can also be considered by some as th
 #schemars = "0.8"
 # sadly we currently rely on a fork to fix multiple flatten for enums, related PR can be found here: https://github.com/GREsau/schemars/pull/264
 schemars = { package = "apistos-schemars", version = "0.8" }
-apistos = "0.3"
+apistos = "0.4"
 ```
 
 ### Usage example
diff --git a/apistos-core/Cargo.toml b/apistos-core/Cargo.toml
index a62a4eb..5605a37 100644
--- a/apistos-core/Cargo.toml
+++ b/apistos-core/Cargo.toml
@@ -29,7 +29,7 @@ serde_qs = { workspace = true, features = ["actix4"], optional = true }
 uuid = { workspace = true, optional = true }
 url = { workspace = true, optional = true }
 
-apistos-models = { path = "../apistos-models", version = "0.3.6", features = ["deserialize"] }
+apistos-models = { path = "../apistos-models", version = "0.4.0", features = ["deserialize"] }
 
 [dev-dependencies]
 assert-json-diff = { workspace = true }
diff --git a/apistos-gen-test/Cargo.toml b/apistos-gen-test/Cargo.toml
index 9062819..a513d6c 100644
--- a/apistos-gen-test/Cargo.toml
+++ b/apistos-gen-test/Cargo.toml
@@ -21,8 +21,8 @@ assert-json-diff = { workspace = true }
 chrono = { workspace = true, features = ["serde"] }
 futures-core = { workspace = true }
 apistos = { path = "../apistos", features = ["multipart", "uuid"] }
-apistos-core = { path = "../apistos-core", version = "0.3.6", features = ["actix-web-grants"] }
-apistos-gen = { path = "../apistos-gen", version = "0.3.6" }
+apistos-core = { path = "../apistos-core", version = "0.4.0", features = ["actix-web-grants"] }
+apistos-gen = { path = "../apistos-gen", version = "0.4.0" }
 # we use the "preserve_order" feature from schemars here following https://github.com/netwo-io/apistos/pull/78
 schemars = { workspace = true, features = ["preserve_order"] }
 serde = { workspace = true, features = ["derive"] }
diff --git a/apistos-models/README.md b/apistos-models/README.md
index d313d5a..93c521f 100644
--- a/apistos-models/README.md
+++ b/apistos-models/README.md
@@ -30,7 +30,7 @@ These models are not linked to any web framework.
 #schemars = "0.8"
 # sadly we currently rely on a fork to fix multiple flatten for enums, related PR can be found here: https://github.com/GREsau/schemars/pull/264
 schemars = { package = "apistos-schemars", version = "0.8" }
-apistos-models = "0.3"
+apistos-models = "0.4"
 ```
 
 ### About us
diff --git a/apistos-rapidoc/Cargo.toml b/apistos-rapidoc/Cargo.toml
index a7ddfd1..4c72667 100644
--- a/apistos-rapidoc/Cargo.toml
+++ b/apistos-rapidoc/Cargo.toml
@@ -14,7 +14,7 @@ rust-version.workspace = true
 license.workspace = true
 
 [dependencies]
-apistos-plugins = { path = "../apistos-plugins", version = "0.3.6" }
+apistos-plugins = { path = "../apistos-plugins", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos-redoc/Cargo.toml b/apistos-redoc/Cargo.toml
index 1977f68..35b78a7 100644
--- a/apistos-redoc/Cargo.toml
+++ b/apistos-redoc/Cargo.toml
@@ -14,7 +14,7 @@ rust-version.workspace = true
 license.workspace = true
 
 [dependencies]
-apistos-plugins = { path = "../apistos-plugins", version = "0.3.6" }
+apistos-plugins = { path = "../apistos-plugins", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos-redoc/README.md b/apistos-redoc/README.md
index 1954a82..1543db2 100644
--- a/apistos-redoc/README.md
+++ b/apistos-redoc/README.md
@@ -27,7 +27,7 @@ This crate is exposed through Apistos `redoc` feature.
 #schemars = "0.8"
 # sadly we currently rely on a fork to fix multiple flatten for enums, related PR can be found here: https://github.com/GREsau/schemars/pull/264
 schemars = { package = "apistos-schemars", version = "0.8" }
-apistos = { version = "0.3", feature = ["redoc"] }
+apistos = { version = "0.4", feature = ["redoc"] }
 ```
 
 ### About us
diff --git a/apistos-scalar/Cargo.toml b/apistos-scalar/Cargo.toml
index 23a924e..496e226 100644
--- a/apistos-scalar/Cargo.toml
+++ b/apistos-scalar/Cargo.toml
@@ -14,7 +14,7 @@ rust-version.workspace = true
 license.workspace = true
 
 [dependencies]
-apistos-plugins = { path = "../apistos-plugins", version = "0.3.6" }
+apistos-plugins = { path = "../apistos-plugins", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos-scalar/README.md b/apistos-scalar/README.md
index e7fa906..ea2acb0 100644
--- a/apistos-scalar/README.md
+++ b/apistos-scalar/README.md
@@ -27,7 +27,7 @@ This crate is exposed through Apistos `scalar` feature.
 #schemars = "0.8"
 # sadly we currently rely on a fork to fix multiple flatten for enums, related PR can be found here: https://github.com/GREsau/schemars/pull/264
 schemars = { package = "apistos-schemars", version = "0.8" }
-apistos = { version = "0.3", feature = ["scalar"] }
+apistos = { version = "0.4", feature = ["scalar"] }
 ```
 
 ### About us
diff --git a/apistos-shuttle/Cargo.toml b/apistos-shuttle/Cargo.toml
index bb12c25..5c1215f 100644
--- a/apistos-shuttle/Cargo.toml
+++ b/apistos-shuttle/Cargo.toml
@@ -18,7 +18,7 @@ actix-web = { workspace = true }
 num_cpus = { workspace = true }
 shuttle-runtime = { workspace = true }
 
-apistos = { path = "../apistos", version = "0.3.6" }
+apistos = { path = "../apistos", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos-swagger-ui/Cargo.toml b/apistos-swagger-ui/Cargo.toml
index 7f9b12f..01f1534 100644
--- a/apistos-swagger-ui/Cargo.toml
+++ b/apistos-swagger-ui/Cargo.toml
@@ -14,7 +14,7 @@ rust-version.workspace = true
 license.workspace = true
 
 [dependencies]
-apistos-plugins = { path = "../apistos-plugins", version = "0.3.6" }
+apistos-plugins = { path = "../apistos-plugins", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos/Cargo.toml b/apistos/Cargo.toml
index bf797f8..9654bc0 100644
--- a/apistos/Cargo.toml
+++ b/apistos/Cargo.toml
@@ -26,25 +26,25 @@ schemars = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
 
-apistos-core = { path = "../apistos-core", version = "0.3.6" }
-apistos-gen = { path = "../apistos-gen", version = "0.3.6" }
-apistos-models = { path = "../apistos-models", version = "0.3.6" }
-apistos-plugins = { path = "../apistos-plugins", version = "0.3.6" }
-apistos-rapidoc = { path = "../apistos-rapidoc", version = "0.3.6", optional = true }
-apistos-redoc = { path = "../apistos-redoc", version = "0.3.6", optional = true }
-apistos-scalar = { path = "../apistos-scalar", version = "0.3.6", optional = true }
-apistos-swagger-ui = { path = "../apistos-swagger-ui", version = "0.3.6", optional = true }
+apistos-core = { path = "../apistos-core", version = "0.4.0" }
+apistos-gen = { path = "../apistos-gen", version = "0.4.0" }
+apistos-models = { path = "../apistos-models", version = "0.4.0" }
+apistos-plugins = { path = "../apistos-plugins", version = "0.4.0" }
+apistos-rapidoc = { path = "../apistos-rapidoc", version = "0.4.0", optional = true }
+apistos-redoc = { path = "../apistos-redoc", version = "0.4.0", optional = true }
+apistos-scalar = { path = "../apistos-scalar", version = "0.4.0", optional = true }
+apistos-swagger-ui = { path = "../apistos-swagger-ui", version = "0.4.0", optional = true }
 
 
 [dev-dependencies]
 actix-web-lab = { workspace = true }
 garde-actix-web = { workspace = true }
 
-apistos-models = { path = "../apistos-models", version = "0.3.6", features = ["deserialize"] }
-apistos-rapidoc = { path = "../apistos-rapidoc", version = "0.3.6" }
-apistos-redoc = { path = "../apistos-redoc", version = "0.3.6" }
-apistos-scalar = { path = "../apistos-scalar", version = "0.3.6" }
-apistos-swagger-ui = { path = "../apistos-swagger-ui", version = "0.3.6" }
+apistos-models = { path = "../apistos-models", version = "0.4.0", features = ["deserialize"] }
+apistos-rapidoc = { path = "../apistos-rapidoc", version = "0.4.0" }
+apistos-redoc = { path = "../apistos-redoc", version = "0.4.0" }
+apistos-scalar = { path = "../apistos-scalar", version = "0.4.0" }
+apistos-swagger-ui = { path = "../apistos-swagger-ui", version = "0.4.0" }
 
 [lints]
 workspace = true
diff --git a/apistos/src/lib.rs b/apistos/src/lib.rs
index a10343a..385d24f 100644
--- a/apistos/src/lib.rs
+++ b/apistos/src/lib.rs
@@ -11,7 +11,7 @@
 //! #schemars = "0.8"
 //! # sadly we currently rely on a fork to fix multiple flatten for enums, related PR can be found here: https://github.com/GREsau/schemars/pull/264
 //! schemars = { package = "apistos-schemars", version = "0.8" }
-//! apistos = "0.3"
+//! apistos = "0.4"
 //! ```
 //!
 //! # Usage example