Hi all, +1 for option #2. Yuanying drafted following blueprint. And I will follow up this. https://blueprints.launchpad.net/magnum/+spec/magnum-api-swagger-support I think, this will be satisfy Tom's comments. regards, Shu Muto