Skip to content

Follow a tag

POST
/tags/{tag}/follow

Adds a tag to the tags you follow. A follow is a bookmark: it gives you no grant or access to anything you couldn’t already see.

Any signed-in account can follow tags; no capability is needed. 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 isn’t looked up, so you can follow one no post uses yet. Surrounding whitespace is trimmed, and the tag must then be 1 to 200 bytes long, or the answer is 400. Following a tag you already follow succeeds and keeps the first follow’s time.

The tags you follow are listed by getMyFollowedTags, and the following feed of GET /posts includes posts carrying them, matched exactly and still within the read rule. 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 follow the tag now, whether the follow was added or already there.

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

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