Why is multiple types shown in a bad way in Swagger UI

Question

I have the following open api schema:

    WaypointEntity:
      type: object
      properties:
        id:
          type: [number, "null"]

But it's not shown correctly in Swagger UI:

Any idea why that is? AmI specifying the types incorrectly? I'm using Open Api 3.0

I have seen this https://stackoverflow.com/a/48114322/8849071, but it does not seem to work. — Antonio Gamiz Delgado, Jan 21 '22 at 14:21

score 3 · Accepted Answer · answered Jan 21 '22 at 14:40

3

In OpenAPI 3.0, type cannot be a list of types, it must be a single type. A nullable number is defined like this:

id:
  type: number
  nullable: true   # <----

answered Jan 21 '22 at 14:40

Helen

1 Answers1