Could not resolve reference Error

[Sirneij]

I have this endpoint:

#[derive(serde::Deserialize, serde::Serialize, utoipa::ToSchema, Clone, Debug)]
#[schema(example = json!({"content": "*This is emphasized text!*"}))]
pub struct EditorContent {
    content: String,
}

/// Compiles a markdown to HTML.
///
///
/// One could call the api endpoint with following curl.
/// ```text
/// curl localhost:8000/articles/compile-markdown/ -d '{"content": "*This is emphasized text!*"}'
/// ```
#[utoipa::path(
    post,
    path="/articles/compile-markdown/",
    request_body = EditorContent,
    responses(
        (status = 200, description = "Compile markdown.", body = EditorContent)
    )
)]
#[tracing::instrument(name = "Compile markdown.", fields(
    new_content = %editor_content.content
))]
#[actix_web::post("/compile-markdown/")]
pub async fn compile_markdown_and_return_value(
    editor_content: actix_web::web::Json<EditorContent>,
) -> actix_web::HttpResponse {
    let value = EditorContent {
        content: crate::utils::convert_markdown_to_html(&editor_content.0.content).await,
    };
    actix_web::HttpResponse::Ok().json(value)
}

But whenever I view it on swagger-ui, I also get this error:

What am I doing wrongly?

# Cargo.toml
utoipa = { version = "3", features = ["actix_extras"] }
utoipa-swagger-ui = { version = "3", features = ["actix-web"] }

[juhaku]

Hey,

How does your api doc type derived from OpenApi look? You need to register the schema with #[openapi(components(schemas(EditorContent)))] to get it working.

#[derive(OpenApi)]
#[openapi(
  paths(compile_markdown_and_return_value)
  components(
    schemas(EditorContent)
  )
)]
struct ApiDoc;

[Sirneij]

This did the magic! Thank you!

[juhaku]

Any time