1.5 KiB
1.5 KiB
POST /v1/friend-request
Sends a friend request to the given user. Friend requests can be accepted by having the given user send a friend request back.
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. |
{
"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. |