fix(swagger): correct API docs, fix #3679