Unsave post

Remove a post from your saved collection

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"
}