Content Portal API

POST user/{userId}/friend/{friendUserId}/request

Make a friend request. See also accepting and declining friend requests.

Note: repeated attempts to make a friend request will be refused within a certain timeframe. This is to prevent abuse and annoyance. Currently, that timeframe is 1 week.

Example

POST /api/v1/user/66a5db1f-2785-498d-9068-e24ddbba03f2/friend/adf67d5b-ad2c-4f1c-adb3-7f0500f0e07e/request HTTP/1.1
Authorization: Bearer ...
----------------------------------------
HTTP/1.1 204 No Content
ETag: W/"a-bAsFyilMr4Ra1hIU5PyoyFRunpI"

Security

Authentication is required, and access is restricted to the user.

URL Parameters

Name	Description	Value
userId	the ID of the user issuing the friend request, as a GUID with dashes	string
friendUserId	the ID of the user receiving the request, as a GUID with dashes	string

Request Body

NONE

Response

Successful responses are code 204. Besides standard error responses, there are two unique error conditions caused by attempting to make a friend request when it is not permissible.

The users are already friends: returns code 400 with the response bodyAlready Friends
The users are not currently friends, but the user is attempting to make a repeat friend request within the refusal timeframe: returns code 400 with the response body Too Soon

Response Body

NONE