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