Follow a team
POST /teams/{id}/follow
Adds a team to the teams you follow. A follow is a bookmark: it doesn’t make you a member and gives you no role, grant or access to anything you couldn’t already see.
You need to be signed in with teams.read granted globally; others
get 403. Without a session cookie or bearer token that identifies
you, the answer is 401, whether or not public mode is on. An id
that isn’t a UUID gets a plain-text 400 before sign-in is checked.
The team must exist and not be deleted; otherwise the answer is 404, with the same message either way. Following a team you already follow succeeds and changes nothing. The team is checked just before the follow is saved rather than in the same step, so a team deleted at that moment can still end up followed.
The teams you follow are listed by getMyFollowedTeams, and the
following feed of GET /posts includes posts filed under them,
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 team’s id.
Responses
Section titled “ Responses ”You follow the team now, whether the follow was added or already there.
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"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completedUnexpected server error
object
Human-readable error summary
Example
the request could not be completed