changes from last week and today 💭

source/API_Reference/Web_API/Statistics/index.html

@@ -6,6 +6,10 @@
   show: true
 ---
 
+{% warning %}
+This endpoint is being deprecated by the addition of the [v3 Global Statistics API]({{root_url}}/API_Reference/Web_API_v3/Stats/global.html).
+{% endwarning %}
+
 {% anchor h2 %}
 Retrieve Statistics
 {% endanchor %}

source/API_Reference/Web_API/Statistics/statistics_advanced.md

@@ -5,6 +5,11 @@ title: Advanced Statistics
 navigation:
   show: true
 ---
+
+{% warning %}
+This endpoint is being deprecated by the addition of the [v3 Advanced Statistics API]({{root_url}}/API_Reference/Web_API_v3/Stats/advanced.html).
+{% endwarning %}
+
 Advanced Statistics methods provide metrics on the browsers and devices that are opening emails, as well as providing statistics based on geographic location or ISP. 
 {% anchor h2 %}
 Get Statistics for: Browsers, Clients, Devices, Geo, Global, Isp 

source/API_Reference/Web_API_v3/Categories/categories.md

@@ -0,0 +1,34 @@
+---
+layout: page
+title: Categories
+weight: 100
+navigation:
+  show: true
+---
+
+Categories API lets you manage your [categories]({{root_url}}/User_Guide/Email_Settings/categories.html).
+
+{% anchor h2 %}
+GET
+{% endanchor %}
+
+Retrieve a list of your categories.
+
+{% parameters get %}
+ {% parameter category No 'A string' 'Performs a prefix search on this value.' %}
+ {% parameter limit No 'Some integer.' 'Optional field to limit the number of results returned. Defaults to 50.' %}
+ {% parameter offset No 'Some integer.' 'Optional beginning point in the list to retrieve from. Defaults to 0.' %}
+{% endparameters %}
+
+{% apiv3example get GET https://api.sendgrid.com/v3/categories %}
+{% v3response %}
+HTTP/1.1 200
+[
+  {"category": "cat1"},
+  {"category": "cat2"},
+  {"category": "cat3"},
+  {"category": "cat4"},
+  {"category": "cat5"}
+]
+{% endv3response %}
+{% endapiv3example %}