Update openapi.yaml

[mayeaux]

Making docs a bit more clear for future devs

[anbsky]

This file is auto-generated from design package so any modifications have to be done in the design.go file. I ported your changes, thank you