Documentation plugin setting enum to value true resulting in schema introspection errors

Discord Q&A strapi-questions
1

Hey folks!
I am using the documentation plugin to generate OpenAPI JSON Schema for the REST APIs. It works really well except for one issue where enum values are being set to true. This seems to be a reserved value and throws errors when introspecting the schema for validation and type generation.
As a workaround I have currently set it to “success” and it seems to work, but ideally enums should not be set to true

"responses": {
          "200": {
            "description": "Returns ok",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "string",
                      "enum": [
                        true //ERROR: cannot be set to true, I am manually setting it to "success" but will prolly run into issues
                      ]
                    }
                  }
                }
              }
            }
          },

This topic has been created from a Discord post (1257815963819315243) to give it more visibility.
It will be on Read-Only mode here.
Join the conversation on Discord