Skip to content

Unfollow a team

DELETE
/teams/{id}/follow

Removes the caller’s team_follows row (#577). Idempotent: unfollowing a team you do not follow is a 204, not a 404.

No liveness probe and no 404 branch at all, on purpose. The POST needs one because it writes a row that must point at a live team; a DELETE only ever removes the caller’s own row, and a row pointing at a since-deleted team is exactly the row a user would most want to be able to drop. Refusing to let them would strand it in their rail forever.

id
required
string format: uuid

Unfollowed (or was not following)

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