Unfollow a tag
DELETE /tags/{tag}/follow
Removes a tag from the tags you follow.
Any signed-in account can unfollow tags. Without a session cookie or bearer token that identifies you, the answer is 401, whether or not public mode is on. A tag that can’t be decoded from the path gets a plain-text 400 before sign-in is checked.
The tag is trimmed as when following and matched exactly, case included, and its length isn’t checked. A tag you don’t follow, including on a second request, one that’s only whitespace and one longer than following allows, also gets 204.
A follow and an unfollow of the same tag sent at the same time can both succeed, and the order of their responses doesn’t tell you whether the follow remains. Following the tag again later records a new follow time. Nobody is notified, and no audit entry is recorded. Server errors get a plain-text 500.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The tag, URL-encoded. Surrounding whitespace is trimmed and nothing
else changes: case, inner spaces and a leading # are kept, and
tags match post tags exactly, so Fantasy and fantasy are
different tags.
The length limits shown are checked only when following, after
trimming, and they count bytes rather than characters. The server
can decode % in the tag a second time, so a tag that contains %
may be refused with a plain-text 400 or read as a different tag.
Responses
Section titled “ Responses ”You don’t follow the tag now, whether you did before or not.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Unexpected server error
object
Human-readable error summary
Example
the request could not be completed