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.
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 follow the tag now, whether the follow was added or already there.
Malformed request
object
Human-readable error summary
Example
the request could not be completedAuthentication 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