Deprecating API Endpoints For alternative rendering of a deprecated endpoint, the flag: deprecated can be specified with the value: true { "deprecated": true } For more information on the RESTful part, have a look at my TIL: Deprecating API Endpoints Resources and References Swagger Example: Petstore Swagger Example: Petstore JSON file