Add more descriptions

content/en/api/rest/apps.md

@@ -8,6 +8,8 @@ menu:
 
 ## POST /api/v1/apps
 
+Create a new application to obtain OAuth2 credentials.
+
 Returns [App]({{< relref "entities.md#app" >}}) with `client_id` and `client_secret`
 
 ### Resource information

content/en/api/rest/blocks.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/blocks
 
+Accounts the user has blocked.
+
 Returns array of [Account]({{< relref "entities.md#account" >}})
 
 ### Resource information

content/en/api/rest/custom-emojis.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/custom_emojis
 
+Custom emojis that are available on the server.
+
 Returns array of [Emoji]({{< relref "entities.md#emoji" >}})
 
 ### Resource information

content/en/api/rest/endorsements.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/endorsements
 
+Accounts the user chose to endorse.
+
 Returns array of [Account]({{< relref "entities.md#account" >}})
 
 ### Resource information

content/en/api/rest/favourites.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/favourites
 
+Statuses the user has favourited.
+
 Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ### Resource information

content/en/api/rest/follow-suggestions.md

@@ -5,3 +5,21 @@ menu:
     parent: api
     weight: 10
 ---
+
+## GET /api/v1/suggestions
+
+Accounts the user had past positive interactions with, but is not following yet.
+
+Returns array of [Account]({{< relref "entities.md#account" >}})
+
+### Resource information
+
+{{< api_method_info auth="Yes" user="Yes" scope="read" version="0.0.0" >}}
+
+## DELETE /api/v1/suggestions/:account_id
+
+Remove account from suggestions.
+
+### Resource information
+
+{{< api_method_info auth="Yes" user="Yes" scope="read" version="0.0.0" >}}

content/en/api/rest/instances.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/instance
 
+Information about the server.
+
 Returns [Instance]({{< relref "entities.md#instance" >}})
 
 ### Resource information

content/en/api/rest/mutes.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/mutes
 
+Accounts the user has muted.
+
 Returns array of [Account]({{< relref "entities.md#account" >}})
 
 ### Resource information

content/en/api/rest/reports.md

@@ -7,6 +7,9 @@ menu:
 ---
 
 ## POST /api/v1/reports
+
+Report an account.
+
 ### Resource information
 
 {{< api_method_info auth="Yes" user="Yes" scope="write write:reports" version="0.0.0" >}}

content/en/api/rest/timelines.md

@@ -8,6 +8,8 @@ menu:
 
 ## GET /api/v1/timelines/home
 
+Statuses from accounts the user follows.
+
 Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ### Resource information
@@ -28,6 +30,8 @@ Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ## GET /api/v1/timelines/public
 
+Public statuses known to the server.
+
 Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ### Resource information
@@ -50,6 +54,8 @@ Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ## GET /api/v1/timelines/tag/:hashtag
 
+Public statuses known to the server marked with a given hashtag.
+
 Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ### Resource information
@@ -72,6 +78,8 @@ Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ## GET /api/v1/timelines/list/:list_id
 
+Statuses from accounts on a given list.
+
 Returns array of [Status]({{< relref "entities.md#status" >}})
 
 ### Resource information