diff --git a/API/client-server/v1/friend-request.md b/API/client-server/v1/friend-request.md new file mode 100644 index 0000000..25e2bc7 --- /dev/null +++ b/API/client-server/v1/friend-request.md @@ -0,0 +1,34 @@ +POST /v1/friend-request + +--- + +Sends a friend request to the given user. + +--- + +## Request + +|Name|Type|Description| +|-|-|-| +|access_token|string|**Required**: The user's auth token| +|identifier|string|**Required**: The gorb ID of the user they want to friend| +|message|string|A message to send along with the friend request, for example to find to tell them who you are| + +```json +{ + "access_token": "gwLhWXD9wrqL3DwxXZ0VHUeOjr8am1yO", + "identifier": "@radial_4740:gorb.app", + "message": "Heyo, Kira here" +} +``` + +--- + +## Responses + +|Status|Description| +|-|-| +|200|Friend request sucessfully sent| +|400|The post request included poorly formated data| +|401|The recipient is not accepting friend requests from the sender at the moment| +|403|Invalid access token| \ No newline at end of file