Skip to content

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.

tag
required
string
>= 1 characters <= 200 characters

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.

You don’t follow the tag now, whether you did before or not.

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

Unexpected server error

object
error
required

Human-readable error summary

string
Example
the request could not be completed