Skip to main content

​
Endpoint

DELETE /api/users/{username}/close-friends

​
Authentication

This endpoint requires authentication.

​
Path Parameters

​
username
string
required
The username of the user to remove from close friends

​
Request Body

​
userName
string
required
The username of the account initiating the remove action

​
Request Example

curl -X DELETE https://api.example.com/api/users/johndoe/close-friends \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userName": "yourUsername"
  }'

​
Response

​
status
number
Returns 204 No Content on successful removal

​
Error Responses

​
404 Not Found
error
  • "This account does not exist" - The initiating account was not found
  • "This user does not exist" - The target username was not found
​
403 Forbidden
error
Returned when attempting to remove yourself from close friends
​
409 Conflict
error
"Account has not added this user" - The user is not currently in your close friends list

Build docs developers (and LLMs) love

Get started for freeTalk to us