Deprecated deprecated APIs

templating/matrix_templates/templates/http-api.tmpl

@@ -2,6 +2,11 @@
 
 ``{{endpoint.method}} {{endpoint.path}}``
 {{(5 + (endpoint.path | length) + (endpoint.method | length)) * title_kind}}
+{% if "deprecated" in endpoint and endpoint.deprecated -%}
+.. WARNING::
+  This API is deprecated and will be removed from a future release.
+
+{% endif -%}
 {% if "alias_for_path" in endpoint -%}
 ``{{endpoint.path}}`` is an alias for `{{endpoint.alias_for_path}}`_.
 

templating/matrix_templates/units.py

@@ -269,6 +269,7 @@ class MatrixUnits(Units):
                 full_path = api.get("basePath", "").rstrip("/") + path
                 endpoint = {
                     "title": single_api.get("summary", ""),
+                    "deprecated": single_api.get("deprecated", False),
                     "desc": single_api.get("description", single_api.get("summary", "")),
                     "method": method.upper(),
                     "path": full_path.strip(),