Skip to main content
Removes a post from the user’s saved collection.

​
Endpoint

DELETE /api/posts/{id}/save

​
Authentication

Required. User must be authenticated to unsave a post.

​
Path Parameters

​
id
integer
required
The unique identifier of the post to unsave (PostID)

​
Request Body

​
userName
string
required
The username of the authenticated user unsaving the post

​
Behavior

  • Removes the SavedPost record for the user and post
  • Prevents unsaving posts from blocked accounts

​
Request

curl -X DELETE https://api.example.com/api/posts/12345/save \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userName": "johndoe"
  }'

​
Response

​
status
integer
204 No Content - Post unsaved successfully
204 No Content

​
Errors

​
404
error
Post does not exist or action cannot be completed due to a block
​
409
error
The user did not save this post
{
  "error": "The user did not save this post"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us