Skip to content

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.

id
required
string format: uuid

The team’s id.

You follow the team now, whether the follow was added or already there.

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

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Unexpected server error

object
error
required

Human-readable error summary

string
Example
the request could not be completed