Skip to content

Unfollow a team

DELETE
/teams/{id}/follow

Removes a team from the teams you follow.

You need to be signed in with teams.read granted globally; others get 403, including someone who followed the team before losing teams.read. 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 isn’t looked up, so a deleted team can be unfollowed, and a team you don’t follow, including on a second request, also gets 204. Only your follow is removed; memberships, roles and grants aren’t touched.

A follow and an unfollow of the same team sent at the same time can both succeed, and the order of their responses doesn’t tell you whether the follow remains. 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 don’t follow the team 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"
}

Authenticated but missing required capabilities

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