Skip to content

Remove your like from a post

DELETE
/posts/{id}/like

Removes your own like from the post. If the post still exists, its like_count goes down by one, never below zero.

You need to be signed in. Unlike liking, this route doesn’t ask for posts.like, doesn’t check that you can still read the post and doesn’t look the post up at all: the answer depends only on whether a like of yours is stored for that id. If one is, it’s removed and the answer is 204, also on a post you can no longer read or that has been deleted but can still be restored. If none is, the answer is 404 and nothing changes, so calling it twice gives 204 and then 404. A post that has been deleted for good normally has no likes left, so it answers 404.

A removal also records an undo activity that points at your latest like activity for the post, or at none if there isn’t one. No notice is sent, and notices already created for the like stay. The post’s cached details are refreshed afterwards on a best-effort basis.

id
required
string format: uuid

The post’s id.

Your like was removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed